Integreren met ActBlue
Wat je leert
Ontdek hoe je ActBlue met Klaviyo kunt integreren. Nadat je deze stappen hebt voltooid, kun je e-mails personaliseren en targeten op basis van de donatie- en websiteactiviteit van elke bijdrager. Dit zijn enkele gegevens die we synchroniseren vanuit ActBlue:
- Bedrag van de bijdrage
- Informatie over bijdragers, waaronder voor- en achternaam, locatie en hoe ze je site hebben gevonden
- Of de donatie terugkerend is en, zo ja, hoe vaak deze zal plaatsvinden
- Het comité waaraan de donatie is gedaan
- De EntityID en FecID
De ActBlue-integratie toevoegen
- Selecteer in Klaviyo het tabblad Integraties.
- Klik op Apps ontdekken, zoek naar ActBlue en klik op de kaart. Klik vervolgens op Installeren.
- Selecteer Verbinden met ActBlue.
- Kopieer op de volgende pagina de webhook-URL, gebruikersnaam en het wachtwoord en stuur die naar je ActBlue-accountmanager. Als je geen contactpersoon bij ActBlue hebt, neem dan contact op met ons supportteam en dan sturen wij het door naar ActBlue (dit proces duurt meestal minder dan 24 uur).
- Klik op Installatie afronden.
Houd de Klaviyo-sync in de gaten
Ga als volgt te werk om je ActBlue-integraties te controleren (zodra je volledig hebt geïntegreerd):
- Klik op de vervolgkeuzelijst Analytics in je Klaviyo-account en selecteer het tabblad Meetwaarden.
- Klik op de meetwaarde Made Contribution (te herkennen aan een ActBlue-pictogram) om te controleren of er gegevens voor deze meetwaarde zijn ingevuld.
- Als er gegevens zijn, hoef je alleen maar te wachten tot de historische synchronisatie van je ActBlue-integratie is voltooid; dit proces kan tot een paar uur duren, afhankelijk van hoeveel gegevens je in je account hebt.
- Klaviyo importeert al je historische ActBlue-gegevens. Om dit te verifiëren, kun je het aantal bestellingen op een specifieke dag in Klaviyo vergelijken met wat er in je ActBlue-interface staat en bevestigen dat ze overeenkomen. Als je bijvoorbeeld de Made Contribution -meetwaarde verkent, kun je met je muis over het datapunt van gisteren gaan of naar de gegevenstabel onder de grafiek kijken om te zien hoeveel bestellingen er gisteren zijn gerapporteerd.
- Vergelijk dat aantal met wat er gisteren in ActBlue is opgeslagen en je zou moeten zien dat ze exact overeenkomen. Als dat niet zo is, komt het probleem waarschijnlijk doordat de tijdzone van je Klaviyo-account niet overeenkomt met je ActBlue-tijdzone.
- Zo controleer je je tijdzone-instelling in Klaviyo:
- Klik linksonder op je accountnaam.
- Selecteer en klik vervolgens op Instellingen > Organisatie.
- Scrol naar beneden naar Tijdzone.
Gegevens gesynchroniseerd vanuit ActBlue
Er is één belangrijke meetwaarde die door ActBlue wordt vastgelegd en naar Klaviyo wordt gesynchroniseerd: Bijdrage geleverd.
Heeft Bijgedragen
Deze gebeurtenis wordt geregistreerd wanneer een klant het afrekenproces voltooit en een bijdrage levert in ActBlue. De gebeurtenis die Klaviyo synchroniseert, bevat alle informatie die ActBlue verzamelt, waaronder het bijdragebedrag, of de donatie terugkerend is en, zo ja, hoe vaak de donatie terugkomt. Je kunt gebeurtenissen Bijdrage geleverd filteren en targeten op basis van de volgende criteria:
- Bedrag
- Terugkerend
Dit is True of False. - Terugkerende periode
Dit is "Eenmaal" als de donatie niet terugkerend is, anders geeft het aan hoe vaak de donatie terugkeert. - Naam commissie
De naam van de commissie waaraan de bijdrage is gedaan. - Entiteit-ID
- FecID
Hier is een voorbeeld van de gegevens die we ontvangen samen met een Bijdrage geleverd -gebeurtenis:
klantgegevens
Naast de twee kernmeetwaarden die Klaviyo synchroniseert vanuit ActBlue, maakt Klaviyo ook een uitgebreid Klaviyo-profiel aan voor elke bijdrager. Naast basiscontactgegevens synchroniseert Klaviyo ook alle aanvullende details die je mogelijk in ActBlue hebt opgeslagen over een bepaalde persoon. Deze details worden gesynchroniseerd als aangepaste eigenschappen die aan elk Klaviyo-profiel worden toegevoegd. Je kunt deze eigenschappen gebruiken in segmenten en flows. Hier zijn de standaardeigenschappen die automatisch worden gesynchroniseerd vanuit ActBlue:
- Voornaam
- Achternaam
- Plaats
- Staat/regio
- Postcode
- Land
- Telefoonnummer
Frequentie van ActBlue-synchronisatie
De meetwaarde Made Contribution en aangepaste profieleigenschappen van ActBlue worden gesynchroniseerd met behulp van webhooks. Dit betekent dat ActBlue aan Klaviyo doorgeeft wanneer er een gebeurtenis heeft plaatsgevonden en Klaviyo vervolgens alle relevante gegevens voor de gebeurtenis ophaalt. Dit gebeurt vrijwel onmiddellijk.
Klaviyo onsite-tracking toevoegen
De laatste stap hier is het toevoegen van de Actief op site -trackingcode van Klaviyo aan de footer van je website. Met deze tracking van Klaviyo kunnen we een meetwaarde voor Actief op site voor je bijhouden, zodat je gegevens over sitebezoeken en bezoekersgedrag kunt bekijken en benutten. Met deze meetwaarde volgt Klaviyo websiteactiviteit voor bekende browsers.
Je kunt bijvoorbeeld de meetwaarde Actief op site gebruiken om segmenten te maken van mensen die je site hebben bezocht (terwijl ze waren ingelogd), maar nog geen donatie hebben gedaan.
- Het volgende trackingscript vind je in Klaviyo door het tabblad Integraties te selecteren en vervolgens rechtsboven op Gegevens beheren > Webtracking instellen te klikken.
- We hebben hier ook het Klaviyo actief op site -tracking-script opgenomen, dat je in de hoofdtemplate van je app kunt plakken vóór de
</body>-tag. Vergeet niet je eigen API-sleutel toe te voegen. Je vindt die onder Instellingen > API-sleutels, waar je 'Public API Key' ziet:
<script type="application/javascript" async
src="https://static.klaviyo.com/onsite/js/klaviyo.js?company_id=Public API Key"></script>- Vervolgens moet je je site-URL invoeren op de pagina Webtracking instellen. Nadat je je URL hebt ingevoerd, klik je op Volgende om de tracking setup te testen. Je zou een succesbericht moeten ontvangen als alles correct werkt.
Resultaat
Je hebt nu geïntegreerd met ActBlue, je gesynchroniseerde gegevens geverifieerd en Klaviyo onsite tracking toegevoegd.