Aan de slag met Magento 2.x (CE en EE)

Wat je leert

Leer hoe je Klaviyo kunt integreren met je Magento 2 CE of EE zaak. Je moet de Klaviyo extensie installeren in Magento, de extensie configureren en OAuth instellen, en dan de integraties inschakelen in Klaviyo. In deze handleiding worden alle vereiste integratiestappen besproken en wordt uitgelegd hoe je kunt bevestigen dat de synchronisatie van historische gegevens is gelukt. 

Voordat je van start gaat

Om ervoor te zorgen dat Klaviyo de nodige API oproepen kan doen voor integraties, moet je Magento 2 server een publiek toegankelijke hostnaam hebben. Magento 2 servers die lokaal worden gehost kunnen niet volledig integreren met Klaviyo.

De Magento 2 extensie van Klaviyo moet worden geïnstalleerd via Composer. Let op: installatie via Composer vereist een IT-beheerder met SSH-toegang tot de server waar Magento 2 wordt gehost. 

Installeer de Klaviyo extensie in Magento 2

1. inloggen op je Magento 2 server en navigeer naar de hoofdmap van je Magento app vanuit je commandoregeltool. Deze handleiding toont voorbeelduitvoer voor Terminal, maar deze stappen kunnen worden aangepast voor elk commandoregeltool van je keuze.
2. Voer de volgende opdracht uit om toegang te krijgen tot de nieuwste versie van de Klaviyo extensie van Packagist. Packagist is een opslagplaats voor PHP-codebibliotheken waarmee je eenvoudig de nieuwste versie van de extensie kunt installeren.
   composer require Klaviyo/magento2-extensie
3. Voer de volgende opdracht uit om de zojuist gedownloade Klaviyo extensie in te schakelen:
   php bin/Magento module:inschakelen Klaviyo_Reclaim --clear-static-content
4. Zoals in de voorbeelduitvoer te zien is, moet je nu eventuele extra modules inschakelen. Voer het volgende commando uit om ze in te schakelen:
   php bin/Magento setup:upgrade
5. Scan de uitvoer voor module 'Klaviyo_Reclaim' om te bevestigen dat de module Klaviyo is ingeschakeld en draait.
6. Om ervoor te zorgen dat de CSS en JS op je Magento 2 zaak goed blijven werken, moet je een static content deploy commando uitvoeren.
   php bin/Magento setup:static-content:deploy -f
7. Je kunt nu terugkeren naar het Magento admin dashboard vanuit je browser.

De installatie via Composer is voltooid! Ga verder naar de volgende sectie voor configuratie-instructies.

Configureer de Klaviyo extensie

Instructievideo

1. Navigeer in je Klaviyo account naar het tabbladAPI-sleutel.
2. Navigeer in een nieuw tabblad naar je Magento zaak admin.
3. Klik onder Instellingen op zaak > Configuratie.
4. Klik in de Klaviyo vervolgkeuzelijst op Algemeen.
5. Zet inschakelen Klaviyo Uitbreiding op Ja.
6. Kopieer je zescijferige Klaviyo publieke API-sleutel van het tabblad API-sleutel en plak deze in het corresponderende vak in Magento.
7. Maak op het tabblad Klaviyo API-sleutel een nieuwe privésleutel aan en plak deze in het corresponderende vak op Magento. Door te authenticeren met je privé API-sleutel kun je nieuwsbriefabonnementen synchroniseren van Magento naar Klaviyo.

In de volgende sectie ga je OAuth instellen, waarmee je andere aspecten van de integraties inschakelt.

OAuth instellen

Vervolgens schakel je OAuth verificatie in om je Klaviyo account veilig te verbinden met de Magento 2 extensie. 

1. Navigeer naar het tabblad Setup OAuth in Magento.
2. Geef je integraties een gedenkwaardige naam, omdat je ze later met deze naam moet terugvinden.
3. Klik op Configuratie opslaan om verder te gaan.
   
4. Zoek Systeem in het linker navigatiedeelvenster en selecteer integraties in het systeemvak.
5. Zoek je integratienaam op en klik op Activeren. Als je de integraties activeert, verschijnt er een venster waarin je wordt gevraagd de toegang goed te keuren.
   
6. Klik op Toestaan om doorgestuurd te worden naar Klaviyo, waar je de installatie van de integratie kunt voltooien.
   
7. Meld je aan op Klaviyo als daarom wordt gevraagd, of bevestig dat je account naam correct is en klik op Integreren. Dit zal de Magento 2 integraties toevoegen aan de Klaviyo account die is gekoppeld aan de API-sleutel die je hebt gebruikt voor het instellen. Als je bent aangemeld bij meerdere Klaviyo accounts en de juiste account wordt niet weergegeven, log dan uit bij alle andere sessies.
   

Als het venster automatisch sluit, was de verbinding succesvol. Je kunt het succes ook bevestigen door je Klaviyo account te openen in een nieuw browsertabblad of -venster, het tabblad integraties te selecteren en te zoeken naar Magento 2 op de lijst .

Als je in plaats daarvan de volgende foutmelding krijgt, controleer dan of de API-sleutel die in de eerste stap is gebruikt, overeenkomt met de account waarop je momenteel aan het inloggen bent.

Als je bij het maken van de verbinding tussen Magento en Klaviyo een lijst met fouten krijgt, kun je op elke fout klikken voor meer informatie over de oorzaak.

Stel een nieuwsbrief lijst in

Vervolgens selecteer je een Klaviyo lijst om je nieuwsbrief abonnee mee te synchroniseren. Je hebt ook de optie om Klaviyo opt-in instellingen of Magento 2 opt-in instellingen te gebruiken voor je gekozen lijst.

1. Klik op Magento op nieuwsbrief.
2. Selecteer de Klaviyo lijst waarmee je je Magento aanmeldingsformulier wilt synchroniseren uit de dropdown.
3. Klik op Configuratie opslaan.

Toestemming inschakelen bij het afrekenen

Vervolgens kun je ervoor kiezen om toestemming in te schakelen bij afrekenen voor e-mail en sms.

Houd er rekening mee dat als je toestemming bij afrekenen inschakelt, je ook webhook (hieronder) moet inschakelen om toestemming bij afrekenen goed te laten functioneren. 

1. Navigeer op de configuratiepagina onder Klaviyo naar Toestemming bij afrekenen.
   
2. Je ziet een gedeelte voor het verzamelen van e-mailtoestemming en toestemming voor sms. De twee worden apart behandeld, zodat je alleen e-mail, alleen sms of beide kunt verzamelen. Als je zowel sms- als e-mailabonnees verzamelt, kies dan een andere lijst voor sms dan voor e-mail. Dit zorgt ervoor dat toestemming altijd op de juiste manier wordt toegekend aan het juiste kanaal.
   • Toestemming wordt niet gesynchroniseerd (voor zowel e-mail als sms) totdat de klant klaar is met het plaatsen van de bestelling en, indien van toepassing, zijn inschrijving bevestigt vanwege dubbele toestemming.
   • Merk op dat voor gebruikers die al inloggen op je Magento 2 zaak, het selectievakje voor toestemming per e-mail niet standaard wordt weergegeven bij afrekenen.
3. Selecteer onder EmailSelecteer Ja om contactpersoon aan te melden bij e-mailmarketing bij afrekenen.
4. Selecteer een e-maillijst om abonnee op te synchroniseren, zoals een nieuwsbrief.
5. Voer de tekst in voor de e-mail opt-in checkbox die je wilt gebruiken.
   
6. Selecteer onder smsJa voor aanmelden contactpersoon bij sms-marketing bij afrekenen.
7. Kies de lijst waarmee je je sms-contactpersoon wilt synchroniseren. Voor meer informatie over deze instellingen, afrekenen onze gids voor het verzamelen van toestemming voor sms bij afrekenen.
   
8. Met Sorteervolgorde kun je de plaatsing van de toestemmingsvakken voor e-mail en sms wijzigen. Standaard verschijnen deze vakjes onder respectievelijk het eerste e-mailinvoerveld en het telefoonnummer voor verzending. Dus als je de afrekenpagina niet opnieuw hebt ingedeeld, hoef je de sorteervolgorde niet te wijzigen. Als je de indeling hebt veranderd, pas de sorteervolgorde dan dienovereenkomstig aan.
9. Als je klaar bent, klik je rechtsboven op Configuratie opslaan.

webhook inschakelen

1. Navigeer vanuit de admin dashboard naar zaak > Configuratie.
2. Klik op Klaviyo en selecteer het tabbladwebhook. 
3. Maak een webhook geheim en voer het in het overeenkomstige webhook Geheim veld in. Het webhook geheim is een sleutel die Klaviyo zal gebruiken voor validatie. Dit geheim kan van alles zijn, maar we raden aan om een veilige reeks van letters en cijfers te maken. Magento verbergt je webhook geheim met sterretjes voor veiligheidsdoeleinden, dus zorg ervoor dat je het correct invoert.
   
   Als je een multi-zaak integratie gebruikt, moet het webhook geheim in dit veld worden ingevoerd in je standaardconfiguratie en hetzelfde geheim zal worden gebruikt als validatie voor elke zaakconfiguratie. Het webhook geheim moet alleen worden toegevoegd aan de standaardconfiguratie en niet per zaak.
4. Selecteer Ja in de dropdown naast de webhook die je wilt inschakelen. Om meer te lezen over de webhook die wordt ondersteund door Klaviyo, afrekenen onze gids voor webhook voor Magento 2.
5. Klik op Configuratie opslaan.

de Magento 2 integraties inschakelen in Klaviyo

Instructievideo

1. Open Klaviyo en selecteer vervolgens integraties in de linker navigatie. Zoek Magento 2 in de lijst en selecteer het.
2. Op de volgende pagina heb je de mogelijkheid om nieuwe Magento 2 klanten toe te voegen aan een Klaviyo lijst. Klik op het selectievakje Nieuwe Magento 2 klant toevoegen aan een Klaviyo lijst en selecteer een lijst in de vervolgkeuzelijst. Merk op dat het aanvinken van deze instelling alleen klanten toevoegt aan de geselecteerde lijst, maar ze niet aanmeldt bij marketingberichten.
   
   Deze instelling synchroniseert alleen nieuwe klanten; bestaande klanten moeten handmatig worden gemigreerd van je Magento lijst Klaviyo naar.
3. Schakel onder Geavanceerd de volgende instellingen in als dat nodig is :
   • Winkels
     Alle Magento 2 winkels zijn standaard gesynchroniseerd met Klaviyo. Met deze instelling kunt u selectief zijn over met welke winkels u integreert. Als u Multi-Source Inventory (MSI) gebruikt in Magento 2, vink dan Only sync specific Magento 2 stores aan en selecteer de winkels die u wilt synchroniseren om uw inventaris goed weergegeven te zien in Klaviyo.
   • Speciale prijsinstellingen
     Deze instelling verwijst naar een speciale verkoopprijs voor items die optioneel kan ingaan in een bepaald datumbereik. We raden ten zeerste aan om deze functie in te schakelen als je van plan bent om hem te gebruiken, omdat het moeilijker is om hem later in te schakelen. Wanneer je Gebruik speciale prijs inschakelt voor productprijzen wanneer van toepassing, zal het productblok de speciale prijs weergeven wanneer van toepassing. Als je een dynamische productfeed gebruikt, wordt de speciale prijs op het verzendmoment ingevuld. Als je handmatig items uit je catalogus selecteert, wordt de speciale prijs ingevuld zodra je het product of de producten hebt geselecteerd. Voor elk product zijn er 4 metadatavelden die worden gesynchroniseerd:
     
     • prijs
       (Verplicht, float) De standaardprijs van het item.
     • speciale_prijs
       (Optioneel, float) Dit is een speciale verkoopprijs voor het item. Als deze prijs van kracht is, zie je deze speciale_prijs naast een doorhaling van de prijs.
     • speciale_afkomstige_datum
       (Optioneel, datum) Geeft een begindatum aan waarop de speciale_prijs van kracht wordt.
     • speciale_tot_datum
       (Optioneel, datum) Geeft een einddatum aan waarop de speciale_prijs van kracht is.
   • Aangepaste media root URL
     Met deze instelling kun je het standaardpad voor je siteafbeeldingen wijzigen. Schakel deze instelling in als je je productafbeeldingen host op een URL die anders is dan je website. 
4. Klik op Opslaan.

Je hebt nu met succes de Magento 2 integraties ingeschakeld! Je gegevens worden binnen enkele minuten gesynchroniseerd met Klaviyo. 

Nadat de eerste synchronisatie van historische gegevens is voltooid, synchroniseert de Magento 2 integraties elke 30 minuten.

gegevens gesynchroniseerd met de Magento 2 integraties

Klaviyo Magento 2 integreert belangrijke klantinformatie van je platform. Magento

Hier zijn enkele gegevens die we synchroniseren vanuit Magento:

• klantgegevens zoals voornaam, achternaam en locatie.
• Verkoop- en bestelgegevens, inclusief welke artikelen zijn gekocht, artikelafbeeldingen, artikelcategorieën en toegepaste kortingen.
• Gegevens over afhandeling, restitutie en geannuleerde bestellingen.
• Wanneer mensen je website bezoeken en welke items ze bekijken; webtracking wordt afgehandeld door de extensie.

Ga voor meer informatie naar Magento 2 gegevens. 

Zet Magento bestelwaarde om in één valuta

Klaviyo de conversie van alle vreemde valuta in Magento naar één primaire valuta in Klaviyo ondersteunen. Neem contact op met support om deze functies in te schakelen. Dit is vooral handig als je meerdere zaken hebt met transacties in verschillende valuta.

Wanneer deze functie is ingeschakeld:

• De conversie gebeurt wanneer Magento ordergegevens synchroniseert in Klaviyo. 
• Klaviyo controleert of de order_currency_code hetzelfde is als de ingestelde global_currency_code. Zo niet, dan zal Klaviyo het ordertotaal omrekenen van de ordervaluta naar de globale valuta die is opgegeven om ervoor te zorgen dat je financiële analyses accuraat zijn. Houd er rekening mee dat bestelregelitems in de bestelvaluta blijven en niet worden geconverteerd. 

Je extensie upgraden

Wil je je Klaviyo Magento 2 extensie upgraden? Volg de instructies in de sectie Installeren hierboven en voer de opdracht uit om de nieuwste versie te installeren. Hiermee wordt je huidige versie overschreven en is je update compleet - je hoeft de extensie niet opnieuw te configureren of de integraties in Klaviyo opnieuw in te schakelen.

Je catalogus opnieuw synchroniseren

U kunt op elk gewenst moment een volledige historische re-sync van uw Magento 2 catalogus aanvragen. Door uw catalogus opnieuw te synchroniseren, kunt u profiteren van Klaviyo updates voor inventaris en variant-gerelateerde functies. 

Om uw catalogus opnieuw te synchroniseren:

1. Selecteer in Klaviyo het tabblad Integraties.
2. Selecteer uw Magento 2 integratie uit de lijst.
3. Klik op het tabblad Gegevens.
4. Klik onder Catalogusgegevens synchroniseren op Opnieuw synchroniseren.
   
   

Extra hulpbronnen

• Magento 2 gegevens referentie
• Klaviyo Community: Magento 2 "Vraag me alles" Vraag en antwoord video