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 konfigurera OAuth och sedan aktivera integrationen i Klaviyo. Den här guiden beskriver alla nödvändiga integrationssteg samt hur du bekräftar att synkroniseringen av historiska data har lyckats.

Innan du börjar

Observera att Magento 2-versioner under 2.4.0 inte stöds.

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.

Vi rekommenderar starkt att du lägger till Klaviyo IP-adresser i din brandväggsleverantörs godkännandelista för att minimera problem med autentisering och konfiguration. För mer information, se Så här tillåter du att Klaviyo integrations trafik IP-adresser.

Klaviyos Magento 2-tillägg bör installeras via Composer. Observera att installation via Composer kräver en IT-administratör med SSH-åtkomst till servern där Magento 2 är hostat.

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 komma åt 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. Kompositör kräver Klaviyo/Magento2-tillägg
3. Kör följande kommando för att aktivera det Klaviyo-tillägg du just laddade ner: php bin/magento module:enable Klaviyo_Reclaim --clear-static-content
   
4. Som visas i exempelutdata 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 på din Magento 2-butik fortsätter att fungera korrekt måste du €™köra ett driftsättningskommando för statiskt innehåll. php bin/Magento setup:static-content: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 navigerar du till fliken API-nycklar.
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 kommer du att aktivera 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 integration ett minnesvärt namn, eftersom du måste hitta den med detta namn senare.
3. Klicka på Spara konfiguration för att fortsätta.
   
4. Leta reda på System i navigeringsrutan till vänster och välj integrationer i systemfältet.
5. Leta reda på ditt integrationsnamn och klicka på Aktivera. Om du aktiverar integrationen öppnas ett fönster där du ombeds godkänna åtkomsten.
   
6. Klicka på Tillåt att du omdirigeras till Klaviyo, där du slutför integrationskonfigurationen.
   
7. Logga in på Klaviyo om du uppmanas att göra det, eller bekräfta att ditt kontonamn är korrekt och klicka på Integrera. Detta kommer att lägga till Magento 2-integrationen till Klaviyo-kontot som är kopplat till den API-nyckel som du använde för konfigurationen. Om du är inloggad på flera Klaviyo-konton och rätt konto inte visas ska du logga ut från alla andra sessioner.

Om fönstret stängs automatiskt har anslutningen genomförts. Du kan också bekräfta att testet lyckades genom att öppna ditt Klaviyo-konto i en ny webbläsarflik eller ett nytt webbläsarfönster, välja fliken Integrationer och leta efter Magento 2 i listan.

Om du får följande fel istället, se till att API-nycklarna som används i det första steget motsvarar det konto som du för närvarande är inloggad 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 konfiguration.

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 i kassan måste du också aktivera webhook (nedan) för att samtycke i kassan ska fungera korrekt.

1. På konfigurationssidan, under Klaviyo, navigerar du till Samtycke i kassan.
   
2. You’ll se ett avsnitt för att samla in e-postsamtycke och sms-samtycke. De två behandlas separat, så att du kan samla bara e-post, bara sms eller båda. Om du samlar in både sms- och e-postprenumeranter väljer du en annan lista för sms än för e-post. Detta säkerställer att samtycke alltid kommer att tillskrivas rätt kanal.
   
   • 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äljer du Ja för att prenumerera på kontakter för e-postmarknadsföring i kassan.
4. Välj en E-postlista att synka prenumeranten till, t.ex. ett nyhetsbrev.
5. Ange den text i opt-in-kryssrutan för e-post som du vill använda.
   
6. Under sms väljer du Ja för att prenumerera på kontakter för sms-marknadsföring i kassan.
7. Välj den lista du vill att dina sms-kontakter ska synkroniseras med. Ytterligare information om dessa inställningar finns i vår guide till hur du samlar in sms-samtycke i kassan.
   
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å Spara konfiguration uppe till höger.

Aktivera webhook

Därefter kommer du att aktivera Klaviyo webhook i ditt Magento 2-konto. Observera att aktivering av webhooks krävs för att samtycke i kassan ska fungera korrekt.

1. Från admininstrumentpanelen navigerar du till butik > Configuration.
2. Klicka på Klaviyo och välj fliken Webhook.
3. Skapa en webhookhemlighet och ange den i motsvarande Webhook Secret- fält. Webhookhemligheten ä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 kommer att dölja 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 webhookhemligheten i detta fält anges i din standardkonfiguration, och samma hemlighet kommer att användas som validering för varje butikskonfiguration. Webhookhemligheten ska endast läggas till i standardkonfigurationen och ska inte läggas till per butik.
   
4. Bredvid de webhooks du vill aktivera väljer du Ja i rullgardinsmenyn. För att läsa mer om webhooks som stöds av Klaviyo, kolla in vår guide till webhook för Magento 2.
5. Klicka på Spara konfiguration.

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-kunder till en Klaviyo-lista. Klicka på kryssrutan för att lägga till nya Magento 2-kunder i en Klaviyo-lista och välj en lista från rullgardinsmenyn. Observera att om du markerar denna inställning läggs endast kunder till i den valda listan, men de prenumererar inte på marknadsföringsmeddelanden. Denna inställning synkroniserar endast nya kunder. Befintliga kunder måste manuellt migreras från din Magento-lista till Klaviyo.
   
3. Välj sedan vilka butiksvyer från Magento 2 som du vill synkronisera till Klaviyo. Alla butiksvyer synkroniseras till Klaviyo som standard. Den här inställningen gör att du kan vara selektiv när det gäller vilka butiker du integrerar med. Om du använder Multi-Source Inventory (MSI) i Magento 2, kontrollera Specifika Magento 2-butiksvyer och välj de butiker du vill synkronisera för att se ditt lager korrekt representerat i Klaviyo.
4. Under Avancerat aktiverar du följande inställningar efter behov:
   
   • Särskilda prisinställningar Denna inställning avser ett särskilt försäljningspris för artiklar som eventuellt kan träda i kraft inom ett visst datumintervall. Vi rekommenderar starkt att du aktiverar denna funktion om du planerar att använda den, eftersom den är svårare att aktivera senare. När du aktiverar Använd specialpris för produktpriser när det är tillämpligt, kommer produktblocket att visa specialpriset när det är tillämpligt. När du använder en dynamisk produktfeed kommer specialpriset att fyllas i vid sändningstiden. När du väljer artiklar manuellt från din katalog kommer specialpriset att fyllas i när du väljer produkten/produkterna. För varje produkt finns 4 metadatafält som kommer att synkroniseras:
     • pris (obligatoriskt, flytande) Artikelns standardpris.
     • special_price (valfritt, float) Detta är ett särskilt försäljningspris för artikeln. När detta pris är i kraft kommer du att se detta special_price bredvid en genomstrykning av priset.
     • special_from_date (Valfritt, datum) Detta anger ett startdatum för att special_price ska träda i kraft.
     • special_to_date (valfritt, datum) Detta anger ett slutdatum för att special_price ska gälla.
   • URL till anpassad medierot Med den här inställningen kan du ändra standardsökvägen för dina webbplatsbilder. Aktivera denna inställning om du är värd för dina produktbilder på en URL som skiljer sig från din webbplats.
5. Klicka på Spara.

Du har nu aktiverat Magento 2-integrationen! Dina data kommer att börja synkroniseras med 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 Magento 2-datareferens.

Omvandla Magento beställningsvärde till en enda valuta

Klaviyo stöder konvertering av alla utländska valutor i Magento till en primär valuta i Klaviyo. Kontakta supporten 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:

• Konverteringen sker när Magento synkroniserar beställningsdata till Klaviyo.
• Klaviyo kommer att kontrollera om order_currency_code är samma som den inställda global_currency_code. Om inte, kommer Klaviyo att konvertera ordersumman från ordervalutan till den globala valuta som anges för att säkerställa att din finansiella analys är korrekt. Observera att beställningsradartiklar kommer att finnas kvar i beställningsvalutakoden och inte konverteras.

Uppgradera din förlängning

Vill du uppgradera ditt Klaviyo Magento 2-tillägg? Följ instruktionerna 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 fullständig – därför behöver inte€™s 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 omsynkronisering av din Magento 2-katalog. Genom att synkronisera din katalog på nytt kan du dra nytta av Klaviyo-uppdateringar till 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.