Komma igång med Magento 2.x (CE och EE)

Du kommer att lära dig

Lär dig hur du integrerar Klaviyo med din Magento 2 CE eller EE-butik. Du måste installera Klaviyo -tillägget i Magento, konfigurera tillägget och ställa in OAuth och sedan aktivera integrationsprogrammet i Klaviyo. I den här guiden beskrivs alla nödvändiga steg för integration samt hur du bekräftar att synkroniseringen av historiska data har lyckats. 

Innan du börjar

För att säkerställa att Klaviyo kan göra de nödvändiga API -anropen för integrationer måste din Magento 2-server ha ett allmänt tillgängligt värdnamn. Magento 2-servrar som hostas lokalt kommer inte att kunna integreras fullt ut med Klaviyo.

Klaviyo's Magento 2 förlängning bör installeras via Composer. Observera att installation via Composer kräver en IT-administratör med SSH-åtkomst till den server där Magento 2 finns. 

Installera Klaviyo-tillägget i Magento 2

1. logga in på din Magento 2-server och navigera till rotkatalogen för din Magento -app från ditt kommandoradsverktyg. I den här guiden visas exempel på utdata för Terminal, men dessa steg kan modifieras för valfritt kommandoradsverktyg.
2. Kör följande kommando för att få tillgång till den senaste versionen av Klaviyo-tillägget från Packagist. Packagist är ett arkiv för PHP-kodbibliotek som gör att du enkelt kan installera den senaste versionen av tillägget.
   composer kräver Klaviyo/magento2-extension
3. Kör följande kommando för att aktivera Klaviyo -tillägget som du just laddade ner:
   php bin/Magento module:enable Klaviyo_Reclaim --clear-static-content
4. Som visas i exempelutmatningen måste du nu aktivera eventuella ytterligare moduler. Kör följande kommando för att aktivera dem:
   php bin/Magento setup:upgrade
5. Skanna utdata för modulen "Klaviyo_Reclaim"för att bekräfta att Klaviyo-modulen är aktiverad och körs.
6. För att säkerställa att CSS och JS i din Magento 2-butik fortsätter att fungera korrekt måste du köra ett static content deploy-kommando.
   php bin/Magento setup:statiskt innehåll:deploy -f
7. Du kan nu återvända till Magento admin instrumentpanel från din webbläsare.

Installationen via Composer är klar! Fortsätt till nästa avsnitt för konfigurationsinstruktioner.

Konfigurera Klaviyo-tillägget

Instruktionsvideo

1. I ditt Klaviyo Konto, navigera till API-nyckel fliken.
2. I en ny flik, navigera till din Magento butik admin.
3. Under Inställningar klickar du på butik > Konfiguration.
4. Klicka på Allmänt i rullgardinsmenyn Klaviyo.
5. Ställ in Enable Klaviyo Extension till Yes.
6. Kopiera din sexsiffriga Klaviyo publika API-nyckel från API-nyckelfliken och klistra in den i motsvarande ruta på Magento.
7. På fliken Klaviyo API-nyckel genererar du en ny privat nyckel och klistrar sedan in den i motsvarande ruta på Magento. Genom att autentisera dig med din privata API-nyckel kan du synkronisera nyhetsbrevsprenumerationer från Magento till Klaviyo.

I nästa avsnitt kommer du att konfigurera OAuth, som möjliggör andra aspekter av integrationen.

Konfigurera OAuth

Därefter aktiverar du OAuth-autentisering för att säkert ansluta ditt Klaviyo Konto till Magento 2-tillägget. 

1. Navigera till fliken Setup OAuth i Magento.
2. Ge din integreringsenhet ett minnesvärt namn, eftersom du kommer att behöva hitta den med detta namn senare.
3. Klicka på Save Config för att fortsätta.
   
4. Leta reda på System iden vänstra navigeringsfönstret och välj Integrationer i systemfacket .
5. Leta reda på namnet på din integrerare och klicka på Activate. När du aktiverar integreraren öppnas ett fönster där du ombeds godkänna åtkomsten.
   
6. Klicka på Allow för att omdirigeras till Klaviyo, där du kommer att slutföra installationen av integrationsprogrammet.
   
7. Logga in på Klaviyo om du uppmanas till det, eller bekräfta att ditt kontonamn är korrekt och klicka på Integrate .Detta kommer att lägga till Magento 2 integrationer till Klaviyo Konto som är associerat med API-nyckel som du använde för installationen. Om du är inloggad på flera Klaviyo -konton och det korrekta kontot inte visas, logga ut från alla andra sessioner.
   

Om fönstret stängs automatiskt har anslutningen lyckats. Du kan också bekräfta att du lyckats genom att öppna din Klaviyo Konto i en ny flik eller ett nytt fönster, välja fliken integrationer och leta efter Magento 2 på listan.

Om du istället får följande felmeddelande ska du kontrollera att API-nyckel som användes i första steget motsvarar det Konto som du för närvarande loggar in på.

Om du får en lista med fel i stället när du upprättar anslutningen mellan Magento och Klaviyo kan du klicka på varje fel för att lära dig mer om orsaken.

Sätt upp en nyhetsbrevlista

Därefter väljer du en Klaviyo lista att synkronisera din nyhetsbrevprenumerant med. Du har också möjlighet att använda Klaviyo opt-in-inställningar eller Magento 2 opt-in-inställningar för din valda lista.

1. På Magento klickar du på nyhetsbrev.
2. Välj den Klaviyo-lista som du vill synkronisera ditt Magento-registreringsformulär till från rullgardinsmenyn.
3. Klicka på Spara konfig.

Möjliggöra samtycke vid kassa

Därefter kan du välja att aktivera samtycke vid kassa för e-post och sms.

Observera att om du aktiverar samtycke på kassa måste du också aktivera webhook (nedan) för att samtycke på kassa ska fungera korrekt. 

1. På sidan Konfiguration, under Klaviyonavigera till Medgivande vid kassa.
   
2. Du kommer att se ett avsnitt för att samla in e-postmedgivande och sms-samtycke. De två behandlas separat, så att du kan samla in bara e-post, bara sms eller båda. Om du samlar in både sms- och e-postprenumeration, välj en annan lista för sms än för e-post. Detta säkerställer att samtycket alltid tillskrivs rätt kanal på ett korrekt sätt.
   • Samtycke kommer inte att synkroniseras (för både e-post och sms) förrän kunden slutfört beställningen och, om tillämpligt, bekräftat sin prenumeration genom dubbel opt-in.
   • Observera att för användare som redan är inloggade på din Magento 2 butik kommer kryssrutan för e-postmedgivande inte att visas i kassan som standard.
3. Under e-post, välj Yes för prenumerera kontakt till e-postmarknadsföring at kassa.
4. Välj en E-postlista att synka prenumeranten till, t.ex. ett nyhetsbrev.
5. Ange den text för kryssrutan för opt-in för e-post som du vill använda.
   
6. Under sms väljer du Ja för prenumerera kontakt till sms-marknadsföring vid kassa.
7. Välj den lista som du vill att din sms-kontakt ska synkroniseras med. För mer information om dessa inställningar, kassa vår guide till att samla in sms-samtycke på kassa.
   
8. Med sorteringsordning kan du ändra placeringen av e-post- och sms-medgivanderutorna. Som standard visas dessa rutor under fältet för första e-postinmatning respektive leveransens telefonnummer. Om du inte har omorganiserat kassasidan behöver du alltså inte ändra sorteringsordningen. Om du har ändrat layout, justera sorteringsordningen i enlighet med detta.
9. När du är klar klickar du på Save Config uppe till höger.

Aktivera webhook

1. Från admininstrumentpanelen navigerar du till butik > Configuration.
2. Klicka på Klaviyo och välj flikenWebhook. 
3. Skapa en webhook -hemlighet och ange den i motsvarande webhook-fält Secret. Hemligheten för webhook är en nyckel som Klaviyo kommer att använda för validering. Denna hemlighet kan vara vad du vill, men vi rekommenderar att du skapar en säker sträng med bokstäver och siffror. Magento döljer din webhook -hemlighet med asterisker av säkerhetsskäl, så var noga med att ange den korrekt.
   
   Om du använder en integration med flera butiker ska hemligheten webhook i det här fältet anges i standardkonfigurationen, och samma hemlighet kommer att användas som validering för varje butikskonfiguration. Hemligheten för webhook ska endast läggas till i standardkonfigurationen och ska inte läggas till per butik.
4. Bredvid den webhook som du vill aktivera väljer du Yes i rullgardinsmenyn. För att läsa mer om webhook som stöds av Klaviyo , sevår guide till webhook för Magento 2.
5. Klicka på Spara konfig.

Aktivera Magento 2 integrationer i Klaviyo

Instruktionsvideo

1. Öppna Klaviyo och välj sedan integrationer i navigeringen till vänster. Leta upp Magento 2 på listan och markera den.
2. På nästa sida har du möjlighet att lägga till nya Magento 2 kund i en lista på Klaviyo. Klicka på kryssrutan Lägg till ny Magento 2 kund i en Klaviyo lista och välj en lista i rullgardinsmenyn. Observera att om du markerar den här inställningen kommer du bara att lägga till kunder i den valda listan, men inte prenumerera på dem i marknadsföringsmeddelanden.
   
   Denna inställning kommer endast att synkronisera nya kund; befintliga kund måste migreras manuellt från din Magento lista Klaviyo till.
3. Under Avancerat aktiverar du följande inställningar efter behov: 
   • butik
     Alla Magento 2 butiker är synkroniserade till Klaviyo som standard. Den här inställningen gör att du kan vara selektiv när det gäller vilken butik du integrerar med. Om du använder Multi-Source Inventory (MSI) i Magento 2, markera Endast synkronisera specifik Magento 2-butik och välj den butik som du vill synkronisera för att se ditt lager korrekt representerat i Klaviyo.
   • Inställningar för specialpris
     Denna inställning avser ett specialpris för artiklar som valfritt kan börja gälla under ett visst datumintervall. Vi rekommenderar starkt att du aktiverar den här funktionen om du planerar att använda den, eftersom det är svårare att aktivera den senare. När du aktiverar Använd specialpris för produktpriser när det är tillämpligt kommer produkten block att visa specialpriset när det är tillämpligt. När du använder ett dynamiskt produktflöde kommer specialpriset att fyllas i vid sändningstid. När du manuellt väljer artiklar från din katalog kommer specialpriset att fyllas i när du väljer produkten/produkterna. För varje produkt finns det 4 metadatafält som kommer att synkroniseras:
     
     • Pris
       (Obligatorisk, float) Artikelns standardpris.
     • special_pris
       (Valfri, float) Detta är ett specialpris för artikeln. När detta pris gäller kommer du att se detta specialpris bredvid en genomstrykning av priset.
     • special_från_datum
       (Valfritt, datum) Här anges ett startdatum för när specialpriset ska börja gälla.
     • special_till_datum
       (Valfritt, datum) Här anges ett slutdatum för när specialpriset ska gälla.
   • Anpassad rot-URL för media
     Med den här inställningen kan du ändra standardsökvägen för dina webbplatsbilder. Aktivera den här inställningen om du hostar dina produktbilder på en URL som är annorlunda än din webbplats. 
4. Klicka på Spara.

Du har nu aktiverat Magento 2 integrationer! Dina data kommer att börja synkroniseras till Klaviyo på några minuter. 

Efter att den första historiska data synkroniseringen är klar synkroniseras Magento 2 integrationer var 30:e minut.

data synkroniserade med Magento 2 integrationer

Klaviyo Magento 2 integrationer hämtar viktig kundinformation från din plattform. Magento

Här är några av de data som vi synkroniserar från Magento:

• kundinformation inklusive förnamn, efternamn och plats.
• Försäljning och order data inklusive vilka artiklar som köptes, artikelbilder, artikelkategorier och eventuella rabatter.
• Uppfylld, återbetald och annullerad order data.
• När människor besöker din webbplats och vilka objekt de tittar på; webbspårning hanteras av tillägget.

Om du vill veta mer kan du gå till vår referensMagento 2 data. 

Omvandla Magento beställningsvärde till en enda valuta

Klaviyo stödja konvertering av alla utländska valutor i Magento till en primär valuta i Klaviyo. Vänligen kontakta support för att aktivera denna funktion. Detta är särskilt användbart om du har flera butiker med transaktioner i olika valutor.

När denna funktion är aktiverad:

• Omvandlingen sker när Magento synkroniserar order data till Klaviyo. 
• Klaviyo kontrollerar om orderns_valutakod är densamma som den angivnaglobala_valutakoden. Om inte, konverterar Klaviyo orderns totalbelopp från orderns valuta till den angivna globala valutan för att säkerställa att dina finansiella analyser är korrekta. Observera att orderns radposter kommer att ligga kvar i orderns valutakod och inte konverteras. 

Uppgradera din förlängning

Vill du uppgradera din Klaviyo Magento 2 förlängning? Följ instruktionerna som beskrivs i avsnittet Installera ovan och kör kommandot för att installera den senaste versionen. Detta kommer att skriva över din nuvarande version och din uppdatering kommer att vara komplett - det finns inget behov av att konfigurera om tillägget eller återaktivera integrationen i Klaviyo.

Synkronisera din katalog på nytt

Du kan när som helst begära en fullständig historisk återsynkronisering av din Magento 2-katalog. Om du synkroniserar din katalog kan du dra nytta av Klaviyos uppdateringar av lager- och variantrelaterade funktioner. 

För att synkronisera din katalog igen:

1. På Klaviyo väljer du fliken Integrationer.
2. Välj din Magento 2-integration från listan.
3. Klicka på datafliken.
4. Under Synkronisera katalogdata klickar du på Synkronisera igen.
   
   

Ytterligare resurser

• Magento 2 data referens
• Klaviyo Community: Magento 2 "Ask Me Anything" Fråga och svar Video