Aan de slag met Shopware

Wat je leert

Leer hoe je kunt integreren met Shopware 6 om gegevens over websiteactiviteiten, bestellingen, catalogi en abonnees aan Klaviyo toe te voegen.

Voordat je van start gaat

Let op het volgende:

• Voordat je gaat integreren, moet je ervoor zorgen dat je bent ingelogd op het Klaviyo-account dat je wilt integreren.
• De Shopware 6-integratie wordt door Klaviyo ondersteund via een derde partij. Als je contact wilt opnemen met support, bekijk dan de sectie hieronder over hoe je dat doet.

Voeg de plug-in toe aan je Shopware-account

1. Ga naar de Klaviyo-plug-inpagina in de Shopware Store.
2. Log in wanneer daarom wordt gevraagd en selecteer vervolgens Toevoegen aan winkelwagen.
3. Ga naar afrekenen en voltooi je bestelling.
4. Zodra de bestelling is bevestigd, klik je op de optie om naar je Shopware-account te gaan.
5. Ga in je Shopware-account naar Verkoper > Winkels.
6. Selecteer de webshop waarvoor je de plug-in hebt gekocht.
7. Zoek in het gedeelte Licenties de plug-in van Klaviyo en open de pagina met plug-ingegevens.

Download en installeer de extensie

Je kunt op twee manieren installeren: via Composer of door onze extensie te downloaden. Nadat je een installatiemethode hebt geselecteerd, moet je elke keer dat je bijwerkt dezelfde methode gebruiken.

Installeren via Composer

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

Gebruik je een Shopware-versie tussen 6.4.4.0 en 6.4.XX.XX? Voer de opdracht uit met de volgende extensieversie:

composer require klaviyo/shopware-klaviyo:1.23.0

Gebruik je een Shopware-versie tussen 6.5.0.0 en 6.5.XX.XX? Voer de opdracht uit met de volgende extensieversie:

composer require klaviyo/shopware-klaviyo:2.23.0

Gebruik je een Shopware-versie tussen 6.6.0.0 en 6.6.XX.XX? Voer de opdracht uit met de volgende extensieversie:

composer require klaviyo/shopware-klaviyo:3.7.0

Gebruik je Shopware versie 6.7.0.0 of nieuwer? Voer de opdracht uit met de volgende extensieversie:

composter require klaviyo/shopware-klaviyo:4.3.0

Installeren via upload

1. Open de pagina met plug-ingegevens en download de laatst beschikbare versie (of een vereiste versie):
   
   • Gebruik je een Shopware-versie tussen 6.4.4.0 en 6.4.XX.XX? Download Klaviyo-extensie versie 1.23.0.
   • Gebruik je een Shopware-versie tussen 6.5.0.0 en 6.5.XX.XX? Download de Klaviyo-extensie versie 2.23.0.
   • Gebruik je een Shopware-versie tussen 6.6.0.0 en 6.6.XX.XX? Download Klaviyo-extensie versie 3.7.0.
   • Gebruik je Shopware versie 6.7.0.0 of hoger? Download Klaviyo-extensie versie 4.3.0.
2. Log in bij je Shopware-beheer voor de webshop die je wilt integreren.
3. Klikextensies > Mijn extensies.
4. Klik op Extensie uploaden en selecteer het ZIP-bestand dat je hebt gedownload van je Shopware-account. Tijdens het uploaden kan er een waarschuwingsbericht verschijnen. Klik op Bevestigen om verder te gaan.
   

5. Zodra de extensie op je extensielijst verschijnt,klik je op Installeren.
   

6. Zet de Klaviyo-extensie aan.
   

De extensie configureren in Shopware

1. Ga in je Shopware-webshopbeheer naar Instellingen en klik op het tabblad Extensies.
2. Select Klaviyo. Je komt nu op de instellingenpagina van de Klaviyo-extensie.
3. Selecteer onder Verkoopkanaal uit het dropdownmenu het verkoopkanaal dat je wilt integreren met Klaviyo. Integreer slechts één verkoopkanaal met Klaviyo per Shopware-webshop. Je moet ook je instellingen voor elk verkoopkanaal afzonderlijk configureren.
4. Selecteer onder Interactie-instellingen de tool voor toestemming voor cookies die je wilt gebruiken met deze integraties. Let op: bezoekers die geen Klaviyo-cookie accepteren, worden niet gevolgd door Klaviyo en kunnen Klaviyo-formulieren niet bekijken. De opties voor de toestemming voor cookies zijn:
   • Niets
     Als deze optie is geselecteerd, heeft Klaviyo gratis toegang tot het opslaan van een cookie.
   • Standaard Shopware
     Als deze optie wordt geselecteerd, wordt cookiebeheer geïmplementeerd via de standaardmethode van Shopware, mits deze is ingeschakeld. Om deze aan te zetten, ga je naar Instellingen > > Basisinformatie, zoek het gedeelte Beveiliging en privacy en schakel Standaard cookiemelding gebruiken in.
   • CookieBot
     Als deze optie wordt geselecteerd, wordt het cookiebeheer geïmplementeerd door CookieBot. Als je CookieBot wilt selecteren, moet je deze al geïnstalleerd hebben in je Shopware-webshop.
   • Toestemmingsmanager
   • Als deze optie wordt geselecteerd, wordt toestemmingsbeheer geïmplementeerd via Toestemmingsmanager. Als je Toestemmingsmanager wilt selecteren, moet je dit al geïnstalleerd hebben in je Shopware-webshop.
   • CMP voor gebruikersgerichte instellingen
     Als deze optie wordt geselecteerd, wordt toestemmingsbeheer geïmplementeerd via Gebruikersgerichte CMP. Als je Usergerichte CMP wilt selecteren, moet je dit al geïnstalleerd hebben in je Shopware-webshop.
5. Als je geen tool voor cookiebeheer gebruikt (die al het laden van het script van Klaviyo blokkeert) en de laadtijden van een pagina wilt versnellen, schakel dan de instelling Klaviyo initialiseren na eerste interactie met pagina in. Dit zal het volgende gedrag mogelijk maken:
   • Nadat de client interactie heeft gehad met de pagina, worden de Klaviyo-scripts geïnitialiseerd.
   • Bij volgende pagina-overgangen worden de scripts onmiddellijk geïnitialiseerd.
     

6. Haal je openbare en privé API-sleutel van Klaviyo om door te gaan. Open hiervoor een nieuw tabblad en log in op het Klaviyo-account dat je met Shopware wilt integreren.
   1. Klik linksonder op je accountnaam en selecteer Instellingen.
   2. Select API-sleutel.
   3. Klik op Privé-API-sleutel maken. Geef de sleutel de naam 'Shopware integraties'. selecteer vervolgens Sleutel voor volledige toegang en klik op Maken. Klik op de volgende pagina op Sleutel kopiëren.
   4. Plak de privé-API-sleutel in de betreffende instelling in Shopware.
   5. Klik terug in Klaviyo op Klaar. Kopieer vervolgens je openbare API-sleutel van de pagina.
   6. Plak de openbare API-sleutel in Shopware in het bijbehorende vak.
7. Kies vervolgens een Klaviyo-lijst uit het dropdownmenu voor profielen, meld je aan via een Shopware-formulier waaraan je wilt worden toegevoegd.
   

1. Selecteer een ID die je wilt gebruiken voor het toewijzen van variatieveld voor Weer op voorraad. Je moet de identificator gebruiken die overeenkomt met de ID die je in je catalogus gebruikt.
2. Zet alle meetwaardes aan die je wilt synchroniseren van Shopware naar Klaviyo.
   

3. Als je ervoor kiest om Weer op Voorraad te volgen, kun je de tekstkleur en -achtergrond aanpassen van de openingsknop voor pop-up, de knop voor sluiten en de knop. Klik op het vakje en gebruik de selector om een kleur te kiezen. Als je hex-kleurcodes voor de kleuren van je merk hebt, plak je deze in het bijbehorende vak.
   

4. Onder Fragmentnamen vind je een handleiding voor verwijzing naar verschillende Weer op voorraad-componenten in HTML. Je kunt ze aanpassen in je sitecode.
   

5. Toewijzing aangepaste velden: Hier zie je aangepaste velden die je hebt ingesteld in Shopware (met de technische naam in grijs). Elk veld dat aan het object Klant is toegewezen, kan met Klaviyo worden gesynchroniseerd. Om deze aangepaste velden te synchroniseren met Klaviyo profiel, zet je de individuele velden op actief. Typ vervolgens onder Veldnaam de naam die je aan het veld wilt geven in Klaviyo.
   

6. Als je klaar bent, klik je op Opslaan.
7. Als je een synchronisatie van historische gebeurtenissen wilt uitvoeren, klik je op Historische gebeurtenissen synchroniseren bovenaan de pagina.
8. Om een synchronisatie van bestaande abonnees uit te voeren, klik je op 'Abonnees synchroniseren' bovenaan de pagina.

Je catalogusfeed synchroniseren

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

1. Log in bij je Shopware-webshopbeheer.
2. Klik op + naast Verkoopkanaal om een nieuw kanaal toe te voegen.
3. Klik naast Productvergelijking op Verkoopkanaal toevoegen.
4. Kies onder template Klaviyo XML.
5. Geef het kanaal een naam, zoals Klaviyo Export.
6. Selecteer onder Belastinginning (horizontale) berekening regel.
7. Onder Storefront-verkoopkanaal:
   • Selecteer het Storefront-verkoopkanaal waarvoor deze catalogus is.
   • Selecteer het Storefront-domein.
   • Selecteer de valuta.
   • Selecteer de taal.
   • Selecteer de klantgroep.
8. Onder Product exporteren:
   • Geef het bestand een naam (bijv. Klaviyo.xml).
   • Selecteer de codering UTF-8.
   • Selecteer het bestandstype XML.
9. Laat Variatie exporteren als afzonderlijke producten.
10. Selecteer het interval: 1 dag.
11. Laat Genereren via planner uitgeschakeld.
12. Selecteer je dynamische productgroep.
13. Zet onder Status op actief.
14. Klik rechtsboven op Opslaan.
15. Scrol naar beneden en kopieer de export-URL die je gaat gebruiken voor de Klaviyo-synchronisatie.
16. Nu de feed is gegenereerd, moet je deze synchroniseren met Klaviyo. Volg de instructies om een aangepaste catalogusfeed te synchroniseren met Klaviyo.

Gegevens gesynchroniseerd vanuit Shopware

Wil je alles weten over de gegevens die vanuit Shopware worden gesynchroniseerd en hoe je ze kunt openen in Klaviyo? Lees dan onze Shopware-gegevensreferentie.

Klaviyo-aanmeldingsformulier

Je kunt Klaviyo-aanmeldingsformulieren toevoegen aan je Shopware-winkel om abonnees te verzamelen. Houd er rekening mee dat alleen sitebezoekers die Klaviyo-cookies accepteren Klaviyo-aanmeldingsformulieren kunnen zien.

Contact opnemen met support

De Klaviyo Shopware 6-integratie wordt door Klaviyo ondersteund via een derde partij. Als je vragen hebt over de integratie en support nodig hebt, kun je contact opnemen met integratie-specifieke support door ons formulier in te vullen.

Als je algemene ondersteuning nodig hebt voor vragen over Klaviyo, neem contact op met Klaviyo Support.

Resultaat

Je hebt Shopware 6 geïntegreerd met Klaviyo om gegevens over websiteactiviteit, bestelling, catalogus en abonnee naar Klaviyo over te brengen. Je kunt nu Klaviyo gaan gebruiken voor je eigen marketingbehoeften.

Extra hulpbronnen