Aan de slag met Shopware

Wat je leert

Leer hoe je kunt integreren met Shopware 6 om website-activiteit, bestel-, catalogus- en abonneegegevens naar Klaviyo te brengen.

Voordat je van start gaat

Houd rekening met het volgende:

• Zorg ervoor dat u bent ingelogd op het Klaviyo-account dat u wilt integreren voordat u de integratie uitvoert.
• De Shopware 6-integratie wordt niet vermeld op de Klaviyo-appmarktplaats. De onderstaande stappen beschrijven hoe u de integratie kunt uitvoeren. 
• De Shopware 6-integratie wordt door Klaviyo ondersteund via een derde partij. Indien u contact wenst op te nemen met de klantenservice, raadpleeg dan het onderstaande gedeelte voor meer informatie.

De extensie downloaden en installeren

Je kunt op twee manieren installeren: via Composer of door onze extensie te downloaden van Github en vervolgens te uploaden naar Shopware. 

Installeren via Composer

Als je installeert via Composer, moet je de Klaviyo extensie versie opgeven; niet alle extensies werken voor alle Shopware versies. 

Gebruik je een Shopware-versie tussen 6.4.4.0 en 6.4.20.2? Voer het commando uit met de volgende extensieversie:

composer vereist klaviyo/shopware-klaviyo:1.17.0

Gebruik je een Shopware-versie tussen 6.5.0.0 en 6.5.8.10? Voer het commando uit met de volgende extensieversie:

composer vereist klaviyo/shopware-klaviyo:2.19.0

Gebruikt u een Shopware-versie tussen 6.6.0.0 en 6.7.0.0? Voer de opdracht uit met de volgende extensieversie:

composer vereist klaviyo/shopware-klaviyo:3.4.2

Gebruikt u Shopware versie 6.7.0.0 of hoger? Voer de opdracht uit met de volgende extensieversie:

composter vereist klaviyo/shopware-klaviyo:4.0.0

Installeren via upload

1. Zoek de gratis extensie van Klaviyo op deze links en klik op de downloadknop:
   
   • Gebruikt u een Shopware-versie tussen 6.4.4.0 en 6.4.20.2? Download dan de Klaviyo-extensie versie 1.17.0.
   • Gebruikt u een Shopware-versie tussen 6.5.0.0 en 6.5.8.10? Download de Klaviyo-extensie versie 2.19.0.
   • Gebruikt u een Shopware-versie tussen 6.6.0.0 en 6.7.0.0? Download de Klaviyo-extensie versie 3.4.2.
   • Gebruikt u Shopware versie 6.7.0.0 of hoger? Download de Klaviyo-extensie versie 4.0.0.
2. inloggen op je Shopware admin voor de zaak die je wilt integreren.
3. Klik op Extensies > Mijn extensies.
4. Klik op Uitbreiding uploaden.
   
5. Selecteer de Klaviyo extensie uit je bestanden.
6. Zodra de extensie op je extensielijst verschijnt, klik je op Installeren.
   
7. schakelaar op de Klaviyo uitbreiding.
   

De uitbreiding configureren in Shopware

1. Navigeer in je Shopware zaak admin naar Instellingen en klik op het tabblad Extensies .
2. Selecteer Klaviyo. Je komt nu op de instellingenpagina van de Klaviyo extensie.
3. Selecteer onder Verkoopkanaal het verkoopkanaal dat je wilt integreren met Klaviyo uit de dropdown. Integreer slechts één verkoopkanaal met Klaviyo per Shopware-zaak. Je moet ook je instellingen voor elk verkoopkanaal afzonderlijk configureren.
4. Selecteer onder Interactie-instellingen het hulpmiddel cookie voor toestemming dat je wilt gebruiken met deze integratie. Bezoekers die de cookie Klaviyo niet accepteren, worden niet gevolgd door Klaviyo en kunnen ook geen Klaviyo formulieren bekijken. De opties van het hulpmiddel cookie voor toestemming zijn:
   • Niets
     Als deze optie is geselecteerd, heeft Klaviyo vrije toegang tot het cookie van de zaak.
   • Shopware standaard
     Als deze optie is geselecteerd, wordt cookie beheer geïmplementeerd via de standaardmethode van Shopware, mits deze is ingeschakeld. Om dit in te schakelen, navigeer je naar Instellingen > Shop > Basisinformatie, zoek je het gedeelte Beveiliging en privacy op en schakel je vervolgens Gebruik standaard cookie-melding in.
   • CookieBot
     Als deze optie is geselecteerd, wordt cookie beheer uitgevoerd door CookieBot. Als je CookieBot wilt selecteren, moet deze al geïnstalleerd zijn op je Shopware zaak.
   • Toestemmingsbeheerder
   • Als deze optie is geselecteerd, wordt het toestemmingsbeheer geïmplementeerd via Consent manager. Als je Consent manager wilt selecteren, moet deze al geïnstalleerd zijn op je Shopware zaak.
   • Gebruikerscentrieken CMP
     Als deze optie is geselecteerd, wordt het toestemmingsbeheer geïmplementeerd via Usercentrics CMP. Als je Usercentrics CMP wilt selecteren, moet dit al geïnstalleerd zijn op je Shopware zaak.
5. Als je geen cookie beheertool gebruikt (die het laden van Klaviyo's script al blokkeert) en je wilt het laden van pagina's versnellen, schakel dan de instelling Initialize Klaviyo After First Interaction With Page in. Hierdoor wordt het volgende gedrag ingeschakeld:
   • Nadat de client de interactie met de pagina start, worden de Klaviyo scripts geïnitialiseerd.
   • Bij volgende pagina-overgangen worden de scripts onmiddellijk geïnitialiseerd.
     
6. Om verder te gaan, vraag je je publieke en private API-sleutel aan via Klaviyo. Open hiervoor een nieuw tabblad en log in op de Klaviyo account die je wilt integreren met Shopware. 
   1. Klik linksonder op je account naam en selecteer Instellingen.
   2. Selecteer API-sleutel.
   3. Klik op Maak privé API-sleutel. Geef de sleutel een naam, selecteer dan Volledige toegangssleutel en klik op Maken. Klik op de volgende pagina op Sleutel kopiëren.
   4. Plak de privé API-sleutel in de bijbehorende instelling in Shopware.
   5. terug in Klaviyo, klik op Klaar. Kopieer vervolgens je openbare API-sleutel van de pagina.
   6. Plak de openbare API-sleutel in Shopware in het overeenkomstige vak.
7. Kies vervolgens een Klaviyo lijst uit de dropdown voor profielen die zich aanmelden via een Shopware formulier om aan toegevoegd te worden.
   
8. Selecteer een identifier om te gebruiken voor weer op voorraad variatie veld mapping. Je moet de identifier gebruiken die overeenkomt met de identifier die je in je catalogus gebruikt.
9. schakelaar op alle meetwaarde die je wilt synchroniseren van Shopware naar Klaviyo.
   
10. Als je ervoor kiest om weer op voorraad te volgen, kun je de tekstkleur en achtergrond van de weer op voorraad pop-up openingsknop, pop-up sluitknop en aanmeldknop aanpassen. Klik op het vierkantje en gebruik de selector om een kleur te kiezen of, als je de hexadecimale kleurcodes hebt voor de kleuren van je merk, plak deze in het bijbehorende vakje.
    
11. Onder Snippernamen vind je een verwijzing naar verschillende weer op voorraad componenten in HTML. Je kunt ervoor kiezen om ze aan te passen binnen de code van je site.
    
12. Aangepaste velden in kaart brengen: Hier zie je aangepaste velden die je in Shopware hebt ingesteld (met de technische naam in het grijs). Elk veld dat is toegewezen aan het klantobject kan worden gesynchroniseerd met Klaviyo. Om deze aangepaste velden te synchroniseren met Klaviyo profiel, schakel je het individuele veld naar actief. Typ vervolgens onder Veldnaam de naam die je aan het veld wilt geven in Klaviyo.
    
13. Klik op Opslaan als je klaar bent. 
14. Om een synchronisatie van historische gebeurtenissen uit te voeren, klik je op Synchroniseer historische gebeurtenissen boven aan de pagina. 
15. Om een synchronisatie van bestaande abonnees uit te voeren, klik je op Synchroniseer abonnee bovenaan de pagina. 

Synchroniseer je catalogus feed

Om je integratie met Klaviyo te voltooien, moet je een feed van je productcatalogus genereren en deze vervolgens synchroniseren met Klaviyo. De voeding genereren:

1. inloggen op je Shopware zaak admin.
2. Klik op + naast Verkoopkanaal om een nieuw kanaal toe te voegen.
3. Klik naast Productvergelijking op Verkoopkanaal toevoegen.
4. Kies onder sjabloon Klaviyo XML.
5. Geef het kanaal een naam, zoals Klaviyo Export.
6. Selecteer bij Belastinginning Lijn voor lijn (horizontaal) berekenen.
7. Onder Verkoopkanaal:
   • Selecteer het Storefront Verkoopkanaal waar deze catalogus voor is.
   • Selecteer het Storefront-domein.
   • Selecteer de valuta.
   • Selecteer de taal.
   • Selecteer de klantgroep.
8. Onder Productuitvoer:
   • Geef het bestand een naam (bijvoorbeeld Klaviyo.xml).
   • Selecteer de codering UTF-8.
   • Selecteer het bestandsformaat XML.
9. Laat Export variatie als discrete producten schakelaar uit.
10. Selecteer het interval: 1 dag.
11. Laat Genereren via planner schakelaar uit. 
12. Selecteer je dynamische productgroep.
13. Onder Status, schakelaar op actief. 
14. Klik rechtsboven op Opslaan.
15. Scroll naar beneden en kopieer de Export URL, die je gaat gebruiken voor de Klaviyo synchronisatie.
16. Nu de feed is gegenereerd, moet je hem synchroniseren met Klaviyo. Volg de instructies om een aangepaste catalogusfeed te synchroniseren met Klaviyo.

gegevens gesynchroniseerd vanuit Shopware

Om alles te weten te komen over de gegevens die vanuit Shopware worden gesynchroniseerd en hoe je deze kunt openen in Klaviyo, lees onze Shopware gegevens referentie.

Klaviyo aanmeldingsformulier

Je kunt Klaviyo aanmeldingsformulier toevoegen aan je Shopware-zaak om abonnee te verzamelen. Merk op dat alleen websitebezoekers die Klaviyo cookie accepteren Klaviyo aanmeldingsformulier kunnen zien. 

Meer informatie over hoe je contact opneemt met support

De Klaviyo Shopware 6 integratie wordt ondersteund door Klaviyo via een derde partij. Als u vragen hebt over de integratie en ondersteuning nodig hebt, kunt u contact opnemen met integratiespecifieke ondersteuning door ons formulier in te vullen.

Als je algemene support voor Klaviyo-gerelateerde vragen nodig hebt, neem dan contact op met Klaviyo support .

Resultaat

Je hebt Shopware 6 geïntegreerd met Klaviyo om website-activiteit, bestel-, catalogus- en abonneegegevens naar Klaviyo te brengen. Je kunt Klaviyo nu gaan gebruiken voor je eigen marketingbehoeften.

Extra hulpbronnen

• Hoe een aangepaste catalogusfeed synchroniseren met Klaviyo
• Shopware 6 gegevens referentie