Aan de slag met PrestaShop

Wat je leert

Leer hoe je je PrestaShop-webshop kunt integreren met Klaviyo. Klaviyo is PrestaShop's voorkeurspartner voor marketingautomatisering. Dit proces bestaat uit 2 stappen: het installeren van een gratis module (PrestaShop Automation with Klaviyo) in PrestaShop en het inschakelen van de integratie binnen Klaviyo. Dit artikel geeft ook informatie over het controleren van je gegevenssynchronisatie, het instellen van transactionele e-mails en het updaten van je module, zodat je kunt groeien met Klaviyo.

Voordat je van start gaat

Om de Klaviyo-module te kunnen gebruiken, moet je een van de volgende versies van PrestaShop hebben:

• PrestaShop 1.7.0 of hoger (met PHP 7.1 of hoger)
  • Houd er rekening mee dat je PrestaShop 1.7.6 of hoger nodig hebt als je gebruik wilt maken van onze functie voor het vragen van toestemming voor sms bij het afrekenen.
• PrestaShop Edition 8.0 en hoger.
• PrestaShop Project 8.0 en hoger.

Als je een PrestaShop-versie gebruikt die ouder is dan 1.7.0 en je wilt upgraden om een Klaviyo-module te kunnen gebruiken, lees dan de gids van PrestaShop voor het upgraden van je webshop.

Lees de volgende informatie voordat je gaat integreren:

• Als je PrestaShop Edition gebruikt, is de module PrestaShop Automation with Klaviyo vooraf geïnstalleerd. Als je een andere versie van PrestaShop gebruikt, moet je deze installeren (zie het volgende gedeelte). 
• PrestaShop Automation with Klaviyo is ontworpen om te integreren met backoffice-functionaliteiten van PrestaShop zoals PrestaShop Account. Wanneer je PrestaShop Automation installeert, wordt je gevraagd om de modules PrestaShop Account, PrestaShop EventBus en PrestaShop Marketplace te installeren in je backoffice om de Klaviyo-module te kunnen gebruiken.
• Wil je niet integreren met backoffice-functionaliteit in je open source PrestaShop-webshop? Dan kun je als alternatief onze module Klaviyo by PrestaShop Partners gebruiken. Deze bevat dezelfde functies als PrestaShop Automation with Klaviyo en vereist geen PS_MBO.

Wil je je huidige Klaviyo-module updaten? Zie het einde van dit artikel voor meer informatie. 

Instructievideo

De module in PrestaShop installeren

1. Als je PrestaShop Edition gebruikt, is de module PrestaShop Automation with Klaviyo vooraf geïnstalleerd. Doe het volgende:
1. Log in op je PrestaShop-webshop.
2. Selecteer onder Configureren in het linkermenu Klaviyo.
3. Ga naar het volgende gedeelte van dit artikel om de module te configureren.
2. Als je PrestaShop Edition niet gebruikt, ga dan naar de pagina PrestaShop Automation with Klaviyo-module op de PrestaShop-marktplaats en ga verder met de volgende stap.
   
3. Klik op de modulepagina op Downloaden. Bevestig indien nodig je gegevens, selecteer de versie van PrestaShop die je gebruikt en download het zipbestand. Je hoeft het zipbestand niet uit te pakken.
   
4. Log in op je PrestaShop-webshop en ga naar Modules > Module Manager. Klik op Upload a module en sleep het zipbestand naar de modulemanager.
   
5. De module geeft na voltooiing een bericht weer dat de installatie geslaagd is. Klik vervolgens op Configure en ga verder naar het volgende gedeelte.

De module configureren in PrestaShop

1. Je moet je openbare API-sleutel van Klaviyo (ook bekend als je site-ID) ophalen en een privé-API-sleutel van Klaviyo genereren voor gebruik in PrestaShop. 
   • Log in op Klaviyo en klik linksonder op je organisatienaam.
   • Selecteer Instellingen > API-sleutels.
   • Kopieer je publieke API-sleutel van de pagina en plak deze in de betreffende instelling in PrestaShop.
   • Klik terug in Klaviyo op Privé-API-sleutel maken, geef deze een naam, selecteer Sleutel voor volledige toegang en klik op Maken.
   • Kopieer veilig je zojuist gemaakte privé-API-sleutel en plak deze in de betreffende instelling in PrestaShop.
2. Zet Real-time bestelgebeurtenissen naar Klaviyo verzenden aan als je transactionele bestelgebeurtenissen in real time wilt synchroniseren. Deze gebeurtenissen kunnen worden gebruikt om transactionele berichten te verzenden en zullen verschijnen als een tweede reeks gebeurtenissen met het label Transactioneel (bijvoorbeeld: je ziet een meetwaarde in Klaviyo met het label Bestelling Geplaatst - Transactioneel, die in real time wordt gesynchroniseerd, naast een meetwaarde met het label Bestelling Geplaatst die elke 30 minuten wordt gesynchroniseerd).
   
3. Schakel De door PrestaShop-gegenereerde transactionele bestelling-e-mails uitzetten in als je dat wilt. We raden aan om deze instelling uitgeschakeld te laten totdat je transactionele e-mails klaarstaan in Klaviyo. Je kunt op elk gewenst moment terugkeren naar deze pagina en de instelling inschakelen, zodat PrestaShop deze e-mails niet meer verzendt. Let op dat het inschakelen van deze instelling transactionele e-mails blokkeert die zijn gekoppeld aan Bestelling Geplaatst, Bestelling Afgerond, Bestelling Geannuleerd en Bestelling Terugbetaald, evenals e-mails met betalingsherinneringen. 
4. Schakel PrestaShop-e-mailabonnees synchroniseren naar Klaviyo in als je e-mailabonnees wilt synchroniseren die zijn verzameld bij het afrekenen of via een aanmeldingsformulier.
5. Schakel PrestaShop-sms-abonnees naar Klaviyo synchroniseren in als je wilt dat gebruikers kunnen kiezen voor sms-marketing tijdens het afrekenen.
   
   Je moet sms instellen in Klaviyo voordat je sms-abonnees kunt synchroniseren.
   
6. Klik op Opslaan om verder te gaan.
7. Als je de synchronisatie-instelling voor e-mailabonnees aanzet, wordt je gevraagd een lijst te selecteren in je Klaviyo-account om e-mailabonnees aan toe te voegen. Alle nieuwe abonnees worden toegevoegd aan de lijst die je kiest. We raden aan de e-maillijst te gebruiken.
   
8. Als je profielen wilt aanmelden bij een Klaviyo-lijst met behulp van de aanmeldmodule PrestaShop-nieuwsbrief, zorg er dan voor dat je de module hebt ingeschakeld en dat de module versie 2.6.0 of hoger gebruikt.
9. Doe na het inschakelen van de instelling Sms-abonnees synchroniseren het volgende:
   1. Je wordt gevraagd een lijst in je Klaviyo-account te selecteren om sms-abonnees aan toe te voegen. Alle nieuwe abonnees worden toegevoegd aan de lijst die je kiest. Klaviyo raadt aan om afzonderlijke lijsten te gebruiken voor e-mailabonnees en sms-abonnees.
   2. Kies Wanneer melden klanten zich aan? Dit kan zijn nadat ze zijn begonnen met afrekenen of een bestelling hebben geplaatst
   3. Voeg een toestemmingslabel toe voor je marketingselectievakje. Gebruik een duidelijk label om gebruikers te informeren waarvoor ze kiezen (bijvoorbeeld 'aanmelden voor sms-marketing').
   4. Voeg kennisgevingstekst voor toestemming toe. Je moet een kennisgeving toevoegen voor compliance. Zorg ervoor dat je de voorwaarden van je sms-marketingprogramma opneemt in je servicevoorwaarden en privacybeleid. Houd er rekening mee dat je in het kennisgevingsvakje html moet gebruiken. Voorbeeldtekst voor kennisgeving:
      Door dit vakje aan te vinken en je telefoonnummer hierboven in te voeren, geef je toestemming voor het ontvangen van marketing-sms-berichten (bijv. aanbiedingen en winkelwagenherinneringen) van [bedrijfsnaam] op het opgegeven nummer. Sms- en datatarieven kunnen van toepassing zijn. De frequentie van de berichten varieert. Afmelden kan op elk moment door STOP te antwoorden of door te klikken op de afmeldlink (indien beschikbaar). <a href="link">Privacybeleid</a> en < a href="link">Voorwaarden</a>.
   5. Je kunt de taalschakelaar rechts van het kennisgevingsvakje gebruiken om taalspecifieke kennisgevingstekst toe te voegen voor elke taal waarin je webshop wordt weergegeven. 
      
10. Klik op Opslaan om verder te gaan.
11. Vul vervolgens het formulier voor het toewijzen van de bestelstatus in door de standaardwaarden te accepteren of andere waarden te selecteren. Bestelstatussen komen overeen met de bestelgebeurtenissen die worden geregistreerd in Klaviyo. Je kunt meerdere waarden selecteren voor elke bestelgebeurtenis. Gebruik Cmd of Ctrl+klik om meerdere te selecteren. Dezelfde waarde kan niet worden geselecteerd in meerdere bestelgebeurtenissen. Als je een dubbele waarde selecteert, krijg je een foutmelding en kan deze niet worden opgeslagen. Zowel transactionele als niet-transactionele gebeurtenissen volgen de toewijzing die je selecteert.
12. Als je klaar bent met het configureren van bestelstatussen, klik je op Opslaan.
13. Je ziet een gedeelte Coupons waar je coupons kunt genereren. Selecteer in het veld Limiet winkelwagenregel Eén winkelwagenregel per voorvoegsel of Eén winkelwagenregel per bestelling om te beperken hoe klanten coupons kunnen gebruiken. Standaard is dit ingesteld op Eén winkelwagenregel per voorvoegsel, zodat een klant niet meer dan één code met hetzelfde voorvoegsel kan toevoegen bij het afrekenen.
    
14. Als je ook couponcodes wilt genereren met behulp van het veld Hoeveelheid te genereren, kun je later naar deze pagina terugkeren. Lees hoe je statische coupons maakt voor PrestaShop voor meer informatie.
15. Onder Weer op voorraad zie je de schakelaar E-mailmelding, die toegang geeft tot het verzenden van weer-op-voorraad-mails in Klaviyo. Om deze schakelaar aan te zetten, moet je de module Mail alerts hebben geïnstalleerd in PrestaShop en de beschikbaarheid van producten hebben ingeschakeld:
    
    1. Ga in een nieuw tabblad naar Modules > Module Manager binnen je PrestaShop-admin.
    2. Zoek naar Mail alerts.
    3. Zoek de module en klik op Install.
       
    4. Nadat de module is geïnstalleerd, klik je op Configure.
       
    5. Zorg ervoor dat Productbeschikbaarheid is ingeschakeld.
       
    6. Klik op Opslaan.
16. Zet de schakelaar E-mailmelding op aan om weer-op-voorraad-mails te verzenden in Klaviyo. Onthoud op dat het inschakelen van de schakelaar de verzending van weer-op-voorraad-mails door PrestaShop uitschakelt. Je moet ook nog een weer-op-voorraad-flow instellen in Klaviyo om te kunnen beginnen met verzenden.
    
17. Selecteer vervolgens Geavanceerde parameters in het gedeelte Configureren van de navigatie aan de linkerkant. Selecteer Webservice. Kopieer de webservicecode van Klaviyo die voor jou is gegenereerd en ga verder naar het volgende gedeelte. 
    • Deze code wordt gebruikt bij het inschakelen van de integraties in Klaviyo in de volgende stap. We raden aan om te controleren of de webservicecode de juiste Klaviyo-permissies heeft door het potloodpictogram naast de webservicecode van Klaviyo te selecteren. Scrol omlaag in de lijst met alle machtigingen en zoek naar Klaviyo. Controleer of alle selectievakjes voor machtigingen zijn ingeschakeld. Selecteer Opslaan om wijzigingen toe te passen.

De integratie inschakelen in Klaviyo

1. Schakel vervolgens de PrestaShop-integratie in binnen je Klaviyo-account. Selecteer in Klaviyo Integraties in de linkernavigatie.
2. Klik op Apps ontdekken, zoek naar PrestaShop en selecteer de kaart. Klik vervolgens op Installeren.
3. Klik op de volgende pagina op Verbinden met PrestaShop.
   
4. Op de volgende pagina voer je de URL van je PrestaShop-webshop in het veld Webshop-URL in. Je kunt je webshop-URL vinden in je PrestaShop-account onder Shop Parameters > Traffic & SEO > Shop URLs. Je kunt ook op View my shop klikken om snel naar je PrestaShop-site te gaan vanaf elke pagina binnen je account om de URL van je webshop te vinden.
   
5. Plak de webservicecode die je hebt gekopieerd uit PrestaShop in het veld Webservicecode.
6. Als je alle valuta's die door je webshops worden gebruikt wilt omrekenen naar één valuta in Klaviyo, vink dan Alle valuta's omrekenen naar één standaardvaluta aan en selecteer een wereldwijde valutacode in het dropdownmenu.
   • Dit verandert de valuta van je Klaviyo-account niet. Als je de valuta wilt wijzigen die je in je account gebruikt, raadpleeg je onze handleiding Valuta voor je account wijzigen.
7. Maak een lijst van je beschikbare PrestaShop-webshops door Lijst van winkels ophalen te selecteren. Vink vervolgens de webshops aan die je wilt integreren. Je moet minstens 1 webshop selecteren om verder te gaan.
8. Vink Varianten synchroniseren aan als je catalogusvarianten (ook bekend als combinaties) van PrestaShop naar Klaviyo wilt synchroniseren. We raden aan om varianten te synchroniseren ter ondersteuning van flows voor producten die weer op voorraad zijn, lage voorraad en prijsdalingen.
   
9. Voorraad synchroniseren wordt standaard aangevinkt als je Varianten synchroniseren selecteert. Met deze instelling wordt de voorraad voor elke variant periodiek gesynchroniseerd om ervoor te zorgen dat flows voor producten die weer op voorraad zijn, lage voorraad en prijsdalingen correct functioneren. Als je Varianten synchroniseren aanvinkt, maar Voorraad synchroniseren uitzet, kun je deze flows niet gebruiken. Je hebt echter wel toegang tot gegevens op variantniveau voor gebruik in e-mailberichten. 
10. Selecteer Installatie afronden als je klaar bent.
11. Er verschijnt een melding dat je accounts zijn verbonden.
    

PrestaShop-gegevens in Klaviyo

3 soorten gebeurtenissen worden gesynchroniseerd van PrestaShop naar Klaviyo: 

• Bestelgebeurtenissen worden elke 30 minuten gesynchroniseerd (bijv. Bestelling Geplaatst).
• Transactionele bestelgebeurtenissen worden in real time gesynchroniseerd, als je ervoor kiest om ze in te schakelen (bijv. Bestelling Geplaatst - Transactioneel).
• Klaviyo-gebeurtenissen op je site (bijv. Actief op Website, Product Bekeken en Toegevoegd aan Winkelwagen). 

Daarnaast worden klantgegevens, waaronder e-mailadres, telefoonnummer, e-mailtoestemming en toestemming voor sms (indien van toepassing) gesynchroniseerd van PrestaShop naar Klaviyo-profielen. 

Je kunt al deze gebeurtenissen bekijken in Klaviyo door naar Analyses > Meetwaarden te gaan. Filter op PrestaShop om bestel- en transactionele bestelgebeurtenissen te zien (ze hebben een PrestaShop-pictogram) of filter op API om Klaviyo-gebeurtenissen op je website te zien (deze hebben een tandwielpictogram). Kijk voor een volledige lijst met meetwaarden die zijn gesynchroniseerd vanuit PrestaShop in onze Gids voor PrestaShop-gegevens.

Wanneer je voor het eerst integreert met PrestaShop, synchroniseert Klaviyo de laatste 90 dagen van je gegevens, zodat je meteen aan de slag kunt met je meest recente klanten. Na de synchronisatie van de gegevens van de afgelopen 90 dagen, begint Klaviyo met de synchronisatie van historische gegevens. Afhankelijk van hoeveel bestellingen, klanten en producten je zaak heeft, kan het enkele minuten tot enkele dagen duren om al je gegevens te synchroniseren.

We raden aan om minimaal 1024 MB PHP-geheugen te reserveren terwijl je historische synchronisatie bezig is. Hierdoor kan de synchronisatie tijdig worden voltooid. Het benodigde initiële geheugen kan worden verminderd nadat de historische synchronisatie is voltooid.

Als de synchronisatie is voltooid, worden de PrestaShop-integraties op het tabblad integraties gemarkeerd als voltooid. Om te controleren of alle gegevens uit PrestaShop succesvol zijn gesynchroniseerd, kun je het totaal aan bestellingen een paar dagen of een week lang controleren. Controleer voordat je begint met valideren of de tijdzone van je account overeenkomt met de instellingen in PrestaShop. Zo kun je de tijdzone van je account te controleren of bijwerken:

1. Klik linksonder op de naam van je organisatie.
2. Selecteer Instellingen.
3. Selecteer het tabblad Organisatie. 

Transactionele e-mails verzenden

Wil je transactionele e-mails verzenden met realtime bestelgegevens die zijn gesynchroniseerd vanuit PrestaShop? Daarvoor moet je flows vanaf nul aanmaken in Klaviyo. Lees Flows gebruiken om transactionele e-mails te verzenden om te leren hoe transactionele e-mails werken in Klaviyo. Je moet deze flows instellen en vervolgens contact opnemen met Klaviyo's supportteam om ze te laten goedkeuren. Zodra ze zijn goedgekeurd, kun je het verzenden van transactionele e-mails uitschakelen in PrestaShop en je transactionele flows live zetten in Klaviyo. 

Je catalogus opnieuw synchroniseren

Als je op een bepaald moment je PrestaShop-catalogusgegevens opnieuw wilt synchroniseren, kun je dat doen op het tabblad Gegevens van je integraties:

1. Selecteer in Klaviyo Integraties in de linkernavigatie.
2. Selecteer PrestaShop in de lijst.
3. Klik op het tabblad Gegevens.
4. Klik in het gedeelte met het label Catalogusgegevens synchroniseren op Opnieuw synchroniseren. Je catalogus wordt opnieuw gesynchroniseerd.
   
5.  

Je module updaten

Is de versie van je PrestaShop-module lager dan 1.4.1? Dan raden we je aan om onmiddellijk te upgraden naar 1.4.1 of hoger. Oudere versies van de module gebruiken Klaviyo's v1- en v2-API's die niet meer werken als verwacht en langer gebruikt worden.

Bovendien kun je met een upgrade naar versie 1.4.1 of hoger gebruikmaken van deze functies, die voor het eerst zijn uitgebracht in 1.3.0:

1. Geef eenvoudig de ware prijs inclusief btw weer voor producten die in je e-mails worden gepromoot. Houd er rekening mee dat het upgraden van een versie ouder dan 1.2.10 naar versie 1.2.10 of hoger onnauwkeurigheden in e-mailtemplates kan veroorzaken als gevolg van deze wijziging. Lees ons artikel voor meer informatie over wat je moet doen.
2. Stuur je klanten transactionele e-mails met realtime gebeurtenissynchronisatie.
3. Snel bulkcoupons genereren en importeren in Klaviyo.

Je module te updaten naar de nieuwste versie:

1. Log in op je PrestaShop-admin.
2. Ga naar Modules > Module Manager.
3. Scrol naar de Klaviyo-module en selecteer Upgrade. 
   

Om meer te weten te komen over de wijzigingen die in elke versie zijn aangebracht, ga je naar de Klaviyo-module op de Add-ons-marktplaats, scrol je naar beneden naar Wat is er nieuw? en klik je op Geschiedenis van wijzigingen weergeven. 

Resultaat 

Je hebt nu PrestaShop geïntegreerd met Klaviyo en kunt beginnen met het gebruik van Klaviyo voor je eigen marketingbehoeften. 

Extra hulpbronnen

• Gids voor PrestaShop-gegevens

• Prijzen inclusief btw inschakelen voor PrestaShop
• Coupons maken voor PrestaShop