Naar de hoofdinhoud

Hoe maak ik een koppeling met WooCommerce (met Deep Data integratie)?

In dit artikel wordt uitgelegd hoe je vanuit MailBlue een Deep Data integratie kunt maken met je WooCommerce-omgeving, welke informatie er meekomt en hoe je dit kunt inzetten.

Geschreven door Team MailBlue
Functionaliteit beschikbaar vanaf het Starter-abonnement

In dit artikel laten we je stap voor stap zien hoe je vanuit MailBlue een Deep Data-integratie kunt maken met je WooCommerce-omgeving. Omdat het om 'Deep Data' gaat, is een hoop data vanuit WooCommerce direct inzichtelijk in je MailBlue-account.

Zo kun je gemakkelijk een aankoop opvolgen vanuit een automatisering, of bijvoorbeeld in MailBlue segmenteren op basis van de ordergeschiedenis.

Om de deep data-integratiekoppeling te voltooien, dien je de integratie op twee plaatsen te activeren:

  • In je MailBlue-account

  • De 'ActiveCampaign for WooCommerce' WordPress plugin

Beiden worden in dit artikel toegelicht.

Let op: hoewel een Deep Data-koppeling met WooCommerce met ingang van 3 februari 2025 al beschikbaar is vanaf een Starter-abonnement, nemen de Deep Data-functionaliteiten toe vanaf een Plus-abonnement.

De synchronisatie vanuit WooCommerce naar MailBlue is een eenrichtingssynchronisatie. Dit betekent dat WooCommerce data naar MailBlue stuurt. Je hebt WooCommerce 3.0 of hoger en versie 1.2.0 of hoger van de 'ActiveCampaign for WooCommerce' WordPress-plugin nodig om de koppeling te configureren.

Met de plugin kun je historische orders, verlaten winkelwagens en data van alle klanten synchroniseren. Ook kun je de volledige productcatalogus synchroniseren. Contacten die via deze integratie binnenkomen, krijgen de tag 'woocommerce-customer' mee.

Je kunt meerdere WooCommerce-winkels aan je MailBlue-account koppelen. De plugin ondersteunt multisites niet volledig wanneer één winkel meerdere URL's heeft.

Orders die naar MailBlue zijn gesynchroniseerd en later in WooCommerce worden verwijderd, blijven zichtbaar in MailBlue.

Contacten die via de WooCommerce-koppeling worden gesynchroniseerd en het selectievakje 'Marketing accepteren' hebben aangevinkt, worden standaard toegevoegd aan de door MailBlue aangemaakte 'Hoofdlijst voor contacten'. Verwijder je deze lijst of wijzig je de naam? Dan worden contacten niet automatisch aan een lijst toegevoegd.

Hoe configureer ik de integratie in mijn MailBlue-account?

  1. Klik rechts bovenin het menu op het tandwieltje voor 'Instellingen'.

    Schermafbeelding van het instellingenmenu met de optie 'Integraties'.

  2. Klik op 'Integraties'.

    Schermafbeelding van de pagina 'Integraties' in MailBlue.

  3. Klik op 'Integratie toevoegen'.

    Schermafbeelding van de knop om een integratie toe te voegen.

  4. Selecteer 'WooCommerce'.

    Schermafbeelding waarin WooCommerce als integratie wordt geselecteerd.

  5. Vul je WooCommerce domein in en klik op 'Verbinden'.

    Schermafbeelding van het veld waarin je de WooCommerce webshop-URL invult.

  6. Je wordt hierna doorverwezen naar jouw WooCommerce-shop en gevraagd of je de connectie wil autoriseren. Klik op 'Klaar' in het integratiescherm.

Hoe configureer ik de ActiveCampaign for WooCommerce-plugin?

Je kunt nu de plugin downloaden. Met deze plugin kun je:

  • De historische order data-sync aanzetten.

  • Aangeven hoe lang MailBlue moet wachten voordat de 'Verlaten winkelwagen'-automatisering mag starten met de 'Verlaten winkelwagen'-trigger.

  • De 'Verlaten winkelwagen'-logs inzien en handmatig synchroniseren.

  • Een opt-in-checkbox wel of niet tonen bij het afrekenen.

  • Het synchroniseren van het veld 'Marketing accepteren'. Zodra deze informatie is gesynchroniseerd, worden contacten verdeeld in segmenten voor 'Heeft marketing geaccepteerd' en 'Heeft marketing niet geaccepteerd'. Deze informatie wordt niet getoond op de profielpagina van het contact.

  • De volledige productcatalogus synchroniseren.

Met deze plugin kun je 'Verlaten winkelwagen'-data uit het verleden niet inladen via de historische ordersynchronisatie.

Om te starten, volg deze stappen:

  1. Log in bij WordPress.

  2. Klik in het menu op 'Plugins' > 'Nieuwe plugin' en zoek naar de plugin 'ActiveCampaign for WooCommerce'. Of klik hier om deze te downloaden.

  3. Installeer de plugin.

  4. Ga naar de geïnstalleerde plugins en klik op 'Activeren' bij de 'ActiveCampaign for WooCommerce'-plugin.

  5. Klik onder de instellingen voor 'ActiveCampaign for WooCommerce' op 'Verbinding' en vul hier je API-URL en API-sleutel in.

  6. Klik op 'Instellingen bijwerken'.

  7. Klik op 'Winkelinstellingen' en geef aan hoe lang MailBlue moet wachten voordat automatiseringen worden gestart die de 'Verlaten winkelwagen'-trigger hebben. Hier kun je ook aangeven welke tekst naast de opt-in-checkbox wordt getoond, of de checkbox zichtbaar is en of deze standaard aangevinkt is.

  8. Klik op 'Instellingen bijwerken'.

Beide instellingen staan nu goed en vanaf nu komen alle orders en verlaten winkelwagensituaties binnen bij MailBlue. Contacten die via deze integratie binnenkomen, krijgen de tag 'woocommerce-customer' mee.

Hoe maak ik de integratie ongedaan?

  1. Om de connectie tussen MailBlue en WooCommerce te verbreken, dien je naar 'Instellingen' te gaan in MailBlue, gevolgd door 'Integraties'.

  2. Klik op de WooCommerce-winkel die je wilt ontkoppelen van MailBlue.

  3. Klik vervolgens op de knop 'Integratie verbreken'.

Schermafbeelding van de knop waarmee je de WooCommerce-integratie verbreekt.

De verbinding tussen je winkel en MailBlue is nu verbroken. Er wordt geen nieuwe data opgehaald vanuit WooCommerce. Data die eerder is gesynchroniseerd naar MailBlue, blijft in de software aanwezig. Deze gegevens worden niet automatisch verwijderd uit MailBlue als de connectie wordt verbroken.

Let op: gebruik 'Integratie verbreken' alleen wanneer je deze WooCommerce-winkel niet meer gebruikt. Toekomstige orders en klantgegevens worden na het verbreken niet meer naar MailBlue gesynchroniseerd.

Heb je problemen met de WooCommerce-koppeling? Dan kun je de integratie opnieuw verbinden of de verbindings-ID herstellen via de plugin. Opnieuw verbinden zorgt ervoor dat je webwinkel opnieuw wordt geautoriseerd en kan synchronisatiefouten oplossen.

Om opnieuw te verbinden, ga je in MailBlue naar 'Instellingen' > 'Integraties', klik je op 'Beheren' en daarna op 'Opnieuw verbinden'. Om de verbindings-ID te herstellen, ga je naar de 'ActiveCampaign for WooCommerce'-plugin > 'Instellingen' > 'Geavanceerde instellingen' en klik je op 'Verbindings-ID herstellen'.

Hoe laad ik orders uit het verleden in?

Je kunt historische data uit je WooCommerce inladen bij MailBlue. Het gaat om de volgende gegevens:

  • Alle contacten in jouw WooCommerce-account met elke order die ze geplaatst hebben.

  • Alle contacten in jouw WooCommerce-account die geen enkele order hebben geplaatst.

  • Alle orders die zijn geplaatst door de contacten die al in jouw MailBlue-account staan.

De historische synchronisatie is beschikbaar vanaf versie 1.5.0 van de 'ActiveCampaign for WooCommerce'-plugin en is niet beschikbaar binnen het Starter-abonnement.

Met de historische synchronisatie kun je alle contacten in je WooCommerce-winkel synchroniseren die een aankoop hebben gedaan of toestemming hebben gegeven voor marketingupdates. Tijdens de synchronisatie kun je zien welke orders worden gesynchroniseerd en welke orders niet konden worden gesynchroniseerd. Ook zie je een voortgangsbalk waarmee je de synchronisatie kunt annuleren, pauzeren of resetten.

Historische data starten geen automatiseringen die de 'Doet een aankoop'-trigger gebruiken. Verlaten winkelwagen-data uit het verleden wordt niet via de historische ordersynchronisatie opgehaald.

Om de historische data in te laden, volg deze stappen:

  1. Klik links in de balk in WordPress op de 'ActiveCampaign for WooCommerce'-plugin.

  2. Klik op 'Historische synchronisatie'.

  3. Klik op de knop 'Historische synchronisatie starten' en start de synchronisatie.

Schermafbeelding van de historische synchronisatie in de WooCommerce-plugin.

Zodra de synchronisatie klaar is, vind je het synchronisatierapport onder 'Resultaten laatste historische synchronisatie'.

Gebruik je de historische synchronisatie en zie je de status 'Incompatibele status'? Dan kan dit betekenen dat een item niet is gemapt, dat het om een abonnementsorder of ander ordertype gaat, of dat een product niet compatibel is met MailBlue.

Hoe synchroniseer ik verlaten winkelwagens, browsegegevens, terugkerende betalingen en producten?

Verlaten winkelwagens
Verlaten winkelwagens worden gesynchroniseerd zodra de plugin is geïnstalleerd en geactiveerd. Ze worden niet gesynchroniseerd via de historische ordersynchronisatie. Verlaten winkelwagens kunnen in bulk of individueel worden gesynchroniseerd via hun synchronisatietaak. Handmatig gesynchroniseerde verlaten winkelwagens starten actieve verlaten-winkelwagen-automatiseringen.

Om verlaten winkelwagens te synchroniseren, ga je in WordPress naar de 'ActiveCampaign for WooCommerce'-plugin, klik je op 'Verlaten winkelwagens' en klik je op 'Verlaten winkelwagens synchroniseren starten'. Wil je één specifieke verlaten winkelwagen synchroniseren? Klik dan op 'Synchroniseren' bij die verlaten winkelwagen.

Browsegegevens
Browsegegevens synchroniseren is beschikbaar vanaf versie 2.8.7 van de 'ActiveCampaign for WooCommerce'-plugin. Browsegegevens gebruiken site tracking en sessiedata om details van verlaten browsersessies naar MailBlue te synchroniseren. Je kunt deze informatie gebruiken voor browse-abandonment-automatiseringen, e-mails en segmenten.

Terugkerende betalingen
Terugkerende betalingen synchroniseren is beschikbaar vanaf versie 2.6 van de 'ActiveCampaign for WooCommerce'-plugin. Hiervoor moet je de Woo Subscriptions-app in WooCommerce installeren. De data en opties voor terugkerende betalingen verschijnen in MailBlue nadat je een historische synchronisatie uitvoert of nadat er een nieuw abonnement wordt gekocht.

Producten
Productsynchronisatie is beschikbaar vanaf versie 1.9.0 van de 'ActiveCampaign for WooCommerce'-plugin. Hiermee kun je de volledige productcatalogus van je WooCommerce-winkel synchroniseren en deze producten gebruiken in e-mails met het productcatalogusblok in de e-mailontwerper.

Om producten te synchroniseren, ga je in WordPress naar de 'ActiveCampaign for WooCommerce'-plugin, klik je op 'Productsynchronisatie' en klik je op 'Productsynchronisatietaken plannen'.

Welke velden importeer ik vanuit WooCommerce?

In de synchronisatie tussen WooCommerce en MailBlue worden vanuit WooCommerce een aantal velden mee geïmporteerd.

De e-commercevelden zijn geen contactvelden, maar worden in de achtergrond meegegeven. Dit betekent dat de waarden hiervan niet zichtbaar zijn binnen een contactveld, maar dat de informatie voor ieder aangekocht product te segmenteren is via de segmentatiebouwer. Op deze manier kun je bijvoorbeeld zoeken op alle contacten die ooit een product hebben aangekocht met een bepaald product-ID.

Lijst van velden die gesynchroniseerd worden:

WooCommerce

MailBlue

First name

First name

Last name

Last name

E-mail

E-mail

Company veld onder 'Customer billing address'

Account

Phone onder 'Customer billing address'

Phone

Product name

Product name

Product category

Product category

Product ID

Product ID

Order price

Order price

Order currency

Order currency

Order shipping method

Order shipping method

Daarnaast worden extra ordergegevens gesynchroniseerd. Deze gegevens kunnen zichtbaar zijn in orderdetails of gebruikt worden binnen geavanceerde zoekopdrachten.

WooCommerce-veld

MailBlue-veld

Betekenis

status

Order - Orderstatus

De status van de order in MailBlue.

connection_id

Order - Verbindings-ID

De unieke ID van de koppeling met MailBlue.

id

Order - Order-ID van winkel

De ID van de order in je winkel.

number

Order - Ordernummer

Het leesbare ordernummer in je winkel.

externalcheckoutid

Order - Winkelwagen-ID

De ID van de winkelwagen die bij de order hoort.

id

Order - Externe order-ID van winkel

Een externe order-ID, bijvoorbeeld bij dropshipping.

(dynamisch op basis van code)

Order - Aanmaakbron

Of de order via actieve of historische synchronisatie is gesynchroniseerd.

billing_email

Order - E-mail

Het e-mailadres van de klant bij de order.

ac_customer_id

Order - Klant-ID van winkel

De ID van de klant in je winkel.

date_created

Order - Aanmaakdatum winkel

De datum waarop de order in je winkel is aangemaakt.

date_modified

Order - Wijzigingsdatum winkel

De meest recente datum waarop de order is gewijzigd.

status

Order - Winkelstatus

De status van de order in je winkel.

customer_note

Order - Notities

Notities die aan de order zijn gekoppeld.

Order - Locatie-ID

De ID van de winkellocatie.

shipping_method

Order - Verzendmethode

De verzendmethode van de order.

(WC-functie get_edit_order_url)

Order - Order-URL

De URL van de order in je winkel.

Order - Testorder

Geeft aan of het om een testorder gaat.

accepts_marketing

Order - Marketing accepteren

Geeft aan of de klant toestemming heeft gegeven voor marketing.

Order - Taal/regio klant

De taal en regio van de klant.

Order - Kanaal

Het kanaal waar de verkoop vandaan kwam.

total

Order - Eindbedrag

Het totale orderbedrag.

discount_total

Order - Kortingsbedrag

Het totale bedrag aan toegepaste kortingen.

shipping_total

Order - Verzendbedrag

Het bedrag dat voor verzending is gerekend.

payment_method

Order - Betaalmethode

De gebruikte betaalmethode.

shipping_first_name

Order - Voornaam verzendadres

De voornaam op het verzendadres.

shipping_last_name

Order - Achternaam verzendadres

De achternaam op het verzendadres.

shipping_address_1

Order - Verzendadres regel 1

De eerste adresregel van het verzendadres.

shipping_address_2

Order - Verzendadres regel 2

De tweede adresregel van het verzendadres.

Order - Verzendadres regel 3

De derde adresregel van het verzendadres.

shipping_city

Order - Plaats verzendadres

De plaats van het verzendadres.

shipping_state

Order - Provincie verzendadres

De provincie van het verzendadres.

shipping_country

Order - Land verzendadres

Het land van het verzendadres.

shipping_postcode

Order - Postcode verzendadres

De postcode van het verzendadres.

shipping_phone

Order - Telefoon verzendadres

Het telefoonnummer op het verzendadres.

shipping_company

Order - Bedrijf verzendadres

Het bedrijf op het verzendadres.

shipping_email

Order - E-mail verzendadres

Het e-mailadres op het verzendadres.

billing_first_name

Order - Voornaam factuuradres

De voornaam op het factuuradres.

billing_last_name

Order - Achternaam factuuradres

De achternaam op het factuuradres.

billing_address_1

Order - Factuuradres regel 1

De eerste adresregel van het factuuradres.

billing_address_2

Order - Factuuradres regel 2

De tweede adresregel van het factuuradres.

Order - Factuuradres regel 3

De derde adresregel van het factuuradres.

billing_city

Order - Plaats factuuradres

De plaats van het factuuradres.

billing_state

Order - Provincie factuuradres

De provincie van het factuuradres.

billing_country

Order - Land factuuradres

Het land van het factuuradres.

billing_postcode

Order - Postcode factuuradres

De postcode van het factuuradres.

billing_phone

Order - Telefoon factuuradres

Het telefoonnummer op het factuuradres.

billing_company

Order - Bedrijf factuuradres

Het bedrijf op het factuuradres.

billing_email

Order - E-mail factuuradres

Het e-mailadres op het factuuradres.

get_coupons

Order - Kortingen

Een lijst met kortingscode, kortingsbedrag en kortingstype.

SMS-velden worden niet vanuit WooCommerce naar MailBlue gesynchroniseerd.

​​

Welke e-commerce-data zie ik in het contactoverzicht?

Wanneer contacten worden gesynchroniseerd vanuit WooCommerce door de 'Deep data'-integratie, worden de door hen geplaatste bestellingen en de bijbehorende e-commerce-data getoond in het contactoverzicht bij de box 'E-commerce'.

Schermafbeelding van het 'E-commerce'-blok in het contactprofiel.

De 'E-commerce'-widget en de 'Bestellingen'-widget tonen nieuwe orders en orders die via een historische synchronisatie zijn opgehaald. De 'E-commerce'-widget toont een overzicht van orders. De 'Bestellingen'-widget toont orders in meer detail.

Je kan hier de e-commerceactiviteit filteren op of een aankoop is voltooid of de verlaten winkelwagen. Ook is het mogelijk om meerdere WooCommerce-winkels te koppelen via de 'Deep data'-integratie. In de E-commercebox kan je sorteren op winkelnaam.

Verder kan je hier in een oogopslag zien wat de totale omzet is geweest van het contact, hoeveel orders er door het contact zijn geplaatst en hoeveel producten er in totaal zijn aangekocht.

Daarnaast is het ook mogelijk om verdere informatie in te zien, zoals ordernummer, datum en tijd van de geplaatste order en de status van de bestelling.

Door te klikken op 'Producten' krijg je een overzicht te zien van de bestelling. Dit overzicht bevat onder andere de winkelnaam, orderdatum en -tijd, orderstatus, ordernummer, ordertotaal, kortingscode, kortingsbedrag en een lijst met producten in de order. Per product kun je de productafbeelding, productnaam, productcategorie, SKU, bestelde hoeveelheid en productprijs zien wanneer deze gegevens beschikbaar zijn.

Schermafbeelding van de knop 'Producten' binnen een e-commerce bestelling.

In de 'Bestellingen'-widget zie je ook gegevens zoals verbindings-ID, order-ID van de winkel, ordernummer, winkelwagen-ID en externe order-ID van de winkel. Klik op de drie puntjes rechts in de widget en daarna op 'Details' om het venster 'Bestellingen' te openen.

Postadresgegevens en de opt-in-informatie voor 'Marketing accepteren' zijn alleen zichtbaar in het venster 'Bestellingen' binnen de 'Bestellingen'-widget.

Terugkerende betalingen en browsegegevens worden als custom object gesynchroniseerd en kunnen op contactrecords verschijnen zodra deze data vanuit WooCommerce naar MailBlue wordt gesynchroniseerd.

In de activiteitenstream van een contact kunnen gesynchroniseerde orderinformatie en verlaten winkelwagens verschijnen.

Hoe werkt de informatie voor 'Marketing accepteren'?

De WooCommerce-koppeling synchroniseert zowel contacten die het selectievakje 'Marketing accepteren' aanvinken als contacten die dit niet doen.

Wil je zien welke contacten via je WooCommerce-winkel toestemming hebben gegeven voor marketing? Dan kun je het veld 'Marketing accepteren' bekijken in de orderdetails via de knop 'Details' in de 'Bestellingen'-widget. Je kunt hiervoor ook een geavanceerde zoekopdracht maken met de segmentvoorwaarde 'E-commerce' > 'Heeft marketing geaccepteerd' of met 'E-commerce' > 'Order' > 'Marketing accepteren' = 'true'.

Hoe map ik aangepaste orderstatussen?

Met de 'ActiveCampaign for WooCommerce'-plugin kun je aangepaste orderstatussen uit WooCommerce mappen naar een standaard orderstatus in MailBlue. Zo blijven de orderstatussen in WooCommerce en MailBlue beter op elkaar afgestemd.

Ga hiervoor naar de 'ActiveCampaign for WooCommerce'-plugin en klik op 'Instellingen' > 'Geavanceerde instellingen'.

WooCommerce standaard orderstatus

MailBlue standaard orderstatus

pending

PENDING PAYMENT

on-hold

WAITING

processing

COMPLETED

completed

COMPLETED

failed

FAILED

refunded

REFUNDED

canceled

CANCELED

wc-pending

PENDING_PAYMENT

wc-on-hold

WAITING

wc-processing

COMPLETED

wc-completed

COMPLETED

wc-failed

FAILED

wc-refunded

REFUNDED

wc-canceled

CANCELED

Je kunt de standaard status-mappingopties in MailBlue niet wijzigen.

Hoe kan ik segmenteren met e-commercedata?

Je kan segmenten aanmaken met de e-commercedata die vanuit WooCommerce wordt doorgezet naar MailBlue. In het volgende artikel wordt stap voor stap uitgelegd hoe je een segment kunt aanmaken. Ook kun je in het bovenstaande artikel alle mogelijke segmentatieopties vinden die een deep data-koppeling biedt.

Zo kan je gemakkelijk contacten verder segmenteren op bijvoorbeeld:

  • Totale omzet

  • Totaal aantal orders

  • Laatste order datum

  • Laatste product ID

  • Laatste product SKU

  • Verzendmethode

  • Verlaten winkelwagens

Veelgestelde vragen

Is de WooCommerce-koppeling een eenrichtingssynchronisatie?

Ja. De WooCommerce-koppeling stuurt data vanuit WooCommerce naar MailBlue.

Zijn historische orders beschikbaar binnen het Starter-abonnement?

Nee. De historische synchronisatie is niet beschikbaar binnen het Starter-abonnement.

Worden verlaten winkelwagens via de historische synchronisatie opgehaald?

Nee. Verlaten winkelwagens worden niet via de historische ordersynchronisatie opgehaald. Ze synchroniseren zodra de plugin is geïnstalleerd en geactiveerd, of wanneer je ze handmatig synchroniseert.

Wat gebeurt er met eerder gesynchroniseerde data als de integratie wordt verbroken?

Eerder gesynchroniseerde data blijft in MailBlue aanwezig. Nieuwe orders en klantgegevens worden na het verbreken niet meer gesynchroniseerd.

Was dit een antwoord op uw vraag?