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-webshop. Je moet de Klaviyo-extensie in Magento installeren, de extensie configureren en OAuth instellen, en vervolgens de integratie inschakelen in Klaviyo. Deze gids behandelt alle vereiste integratiestappen en toont hoe je kunt bevestigen dat de synchronisatie van je historische gegevens is gelukt.

Voordat je van start gaat

Let op: Magento 2-versies lager dan 2.4.0 worden niet ondersteund.

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.

Het wordt sterk aanbevolen om IP's van Klaviyo toe te voegen aan de positieve lijst van je firewallaanbieder om problemen met verificatie en configuratie te minimaliseren. Ga voor meer informatie naar IP-adressen van de verkeerslijst van Klaviyo-integratie verkeeren.

Installeer de Magento 2-extensie van Klaviyo via Composer. Houd er rekening mee dat voor installatie via Composer een IT-beheerder met SSH-toegang nodig is tot de server waarop 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 Packageist. Packagist is een opslagplaats voor PHP-codebibliotheek waarmee je eenvoudig de nieuwste versie van de extensie kunt installeren. composer vereist extensie Klaviyo/magento2-extensie
3. Voer de volgende opdracht uit om de Klaviyo-extensie die je zojuist hebt gedownload in te schakelen: php bin/magento module:enable Klaviyo_Reclaim --duidelijk-statische-content
   
4. Zoals te zien is in de voorbeelduitvoer, moet je nu extra modules inschakelen. Voer de volgende opdracht uit om ze in te schakelen: php bin/magento set-up:upgrade
5. Scan de uitvoer voor module Klaviyo_Reclaim om te bevestigen dat de Klaviyo-module is ingeschakeld en actief is.
6. Om ervoor te zorgen dat de CSS en JS in je Magento 2-webshop goed blijven werken, moet je de opdracht statische content implementeren uitvoeren. php bin/magento instellen:statische-content:implementeren -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. Ga in je Klaviyo-account naar het tabblad API-sleutels.
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 integratie een naam die je gemakkelijk kunt onthouden, want aan deze naam zul je later de naam moeten herinneren.
3. Klik op Save Config om verder te gaan.
   
4. Zoek System in het linkernavigatievenster en selecteer Integraties in het systeemvak.
5. Zoek je integratienaam en klik op Activeren. Door de integratie te activeren, wordt er een venster geopend waarin je wordt gevraagd de toegang goed te keuren.
   
6. Klik op Toestaan om te worden doorgestuurd naar Klaviyo, waar je de installatie van de integratie voltooit.
   
7. Log in bij Klaviyo als daarom wordt gevraagd, of bevestig dat je accountnaam correct is en klik op Integreren. Dit voegt de Magento 2-integratie toe aan het Klaviyo-account dat is gekoppeld aan de API-sleutel die je voor het instellen hebt gebruikt. Als je bent aangemeld bij meerdere Klaviyo-accounts en het juiste account niet wordt weergegeven, log dan uit bij alle andere sessies.

Als het venster automatisch wordt gesloten, is de verbinding tot stand gebracht. Je kunt het succes ook bevestigen door je Klaviyo-account te openen in een nieuw browsertabblad of -venster, het tabblad Integraties te selecteren en Magento 2 in de lijst te zoeken.

Als je in plaats daarvan de volgende foutmelding krijgt, zorg er dan voor dat de API-sleutels die in de eerste stap worden gebruikt overeenkomen met het account waar je momenteel bij bent ingelogd.

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 het afrekenen inschakelt, je ook webhooks moet inschakelen (zie hieronder) om toestemming bij het afrekenen goed te laten functioneren.

1. Ga op de configuratiepagina onder Klaviyo naar Toestemming bij het afrekenen.
   
2. Je ziet een sectie voor het verzamelen van toestemming voor e-mail en sms. Deze twee worden afzonderlijk 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 juiste wijze aan het juiste kanaal wordt toegekend.
   
   • 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 E-mail Ja voor Contactpersonen aanmelden voor e-mailmarketing bij het afrekenen.
4. Selecteer een e-maillijst om abonnee op te synchroniseren, zoals een nieuwsbrief.
5. Voer de tekst van het selectievakje voor toestemming voor e-mail in die je wilt gebruiken.
   
6. Selecteer onder Sms Ja voor Contactpersonen aanmelden voor sms-marketing bij het afrekenen.
7. Kies de lijst waarmee je je sms-contactpersonen wilt synchroniseren. Voor meer informatie over deze instellingen bekijk je onze gids voor het vragen van toestemming voor sms bij het 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

Vervolgens schakel je Klaviyo-webhooks in in je Magento 2-account. Houd er rekening mee dat het inschakelen van webhooks vereist is om toestemming bij het afrekenen correct te laten functioneren.

1. Navigeer vanuit de admin dashboard naar zaak > Configuratie.
2. Klik op Klaviyo en selecteer het tabblad Webhooks.
3. Maak een webhookgeheim en voer dit in het bijbehorende veld Webhookgeheim in. Het webhookgeheim is een sleutel die Klaviyo gebruikt voor validatie. Dit geheim kan van alles zijn, maar we raden je aan om een beveiligde reeks letters en cijfers te maken. Magento verbergt om veiligheidsredenen het geheim van je webhook met sterretjes, dus zorg ervoor dat je het correct invoert. Als je een integratie met meerdere winkels gebruikt, moet het webhook-geheim in dit veld worden ingevoerd in je standaardconfiguratie en wordt hetzelfde geheim gebruikt als validatie voor elke webshopconfiguratie. Het webhook-geheim moet alleen worden toegevoegd aan de standaardconfiguratie en mag niet per webshop worden toegevoegd.
   
4. Selecteer Ja in het dropdownmenu naast de webhooks die je wilt inschakelen. Als je meer wilt lezen over de webhooks die door Klaviyo worden ondersteund, bekijk dan onze gids over webhooks 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 optie om nieuwe Magento 2-klanten toe te voegen aan een Klaviyo-lijst. Vink het selectievakje aan om Nieuwe Magento 2-klanten aan een Klaviyo-lijst toe te voegen en selecteer een lijst uit het dropdownmenu. Let op: als je deze instelling aanvinkt, worden alleen klanten toegevoegd aan de geselecteerde lijst, maar worden ze niet aangemeld voor marketingberichten. Deze instelling synchroniseert alleen nieuwe klanten; bestaande klanten moeten handmatig worden gemigreerd van je Magento-lijst naar Klaviyo.
   
3. Selecteer vervolgens welke winkelweergaven van Magento 2 je wilt synchroniseren met Klaviyo. Alle winkelweergaven worden standaard gesynchroniseerd met Klaviyo. Met deze instelling kun je selectief zijn over met welke winkels je integreert. Als je Multi-Source Inventory (MSI) gebruikt in Magento 2, vink dan Specifieke Magento 2 winkelweergaven aan en selecteer de winkels die je wilt synchroniseren om je inventaris goed weergegeven te zien in Klaviyo.
4. Schakel onder Geavanceerd indien nodig de volgende instellingen in:
   
   • Speciale prijsinstellingen Deze instelling verwijst naar een speciale uitverkoopprijs voor artikelen die optioneel van kracht kan worden in een bepaald datumbereik. We raden je ten zeerste aan om deze functie in te schakelen als je van plan bent om deze te gebruiken, omdat het moeilijker is om deze later in te schakelen. Als je Speciale prijs gebruiken voor productprijzen, indien van toepassing, inschakelt, geeft het productblok de speciale prijs weer, indien van toepassing. Wanneer je een dynamische productfeed gebruikt, wordt de speciale prijs op het verzendmoment weergegeven. Wanneer je handmatig artikelen uit je catalogus selecteert, wordt de speciale prijs weergegeven zodra je het product of de producten hebt geselecteerd. Voor elk product zijn er 4 metadatavelden die worden gesynchroniseerd:
     • prijs (verplicht, zwevend) De standaardprijs van het artikel.
     • special_prijs (optioneel, zwevend) Dit is een speciale uitverkoopprijs voor het artikel. Wanneer deze prijs van kracht is, zie je deze speciale_prijs naast een doorgestreepte prijs.
     • special_from_date (optioneel, datum) Dit specificeert een begindatum voor het van kracht worden van speciale_prijs.
     • speciale_prijs (optioneel, datum) Dit specificeert een einddatum voor speciale_prijs die van kracht is.
   • Aangepaste hoofd-URL voor media Met deze instelling kun je het standaardpad voor je siteafbeeldingen wijzigen. Schakel deze instelling in als je je productafbeeldingen host op een andere URL dan je website.
5. Klik op Opslaan.

Je hebt nu de Magento 2-integratie 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 onze Magento 2-gegevensgids.

Zet Magento bestelwaarde om in één valuta

Klaviyo ondersteunt de omrekening van alle vreemde valuta in Magento naar één primaire valuta in Klaviyo. Neem contact op met support om deze functie in te schakelen. Dit is vooral handig als je meerdere webshops hebt met transacties in verschillende valuta's.

Wanneer deze functie is ingeschakeld:

• De conversie gebeurt wanneer Magento bestelgegevens synchroniseert met Klaviyo.
• Klaviyo controleert of de order_currency_code hetzelfde is als de ingestelde global_currency_code. Zo niet, dan rekent Klaviyo het bestellingstotaal om van de bestelvaluta naar de opgegeven wereldwijde valuta om ervoor te zorgen dat je financiële analyses nauwkeurig zijn. Houd er rekening mee dat regelitems van bestellingen in de valutacode van de bestelling blijven staan en niet worden geconverteerd.

Je extensie upgraden

Wil je je Klaviyo Magento 2-extensie upgraden? Volg de instructies in het gedeelte Installeren hierboven en voer de opdracht uit om de nieuwste versie te installeren. Dit zal je huidige versie overschrijven en je update is voltooid. Het is niet nodig om de extensie opnieuw te configureren of de integratie opnieuw in te schakelen in Klaviyo.

Je catalogus opnieuw synchroniseren

Je kunt op elk moment vragen om een volledige historische nieuwe synchronisatie van je Magento 2-catalogus. Door je catalogus opnieuw te synchroniseren, kun je profiteren van Klaviyo-updates voor voorraad- en variantgerelateerde 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.