Hoe je met DonorPerfect integreert

Wat je leert

Ontdek hoe je DonorPerfect 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. Hier zijn enkele gegevens die we uit DonorPerfect synchroniseren:

• 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
• Of de bijdrager anoniem wil blijven

Eerst moet je je DonorPerfect API-sleutel vinden en daarna schakel je de integratie in Klaviyo in.

Zoek je API-sleutel

Je kunt je API-sleutel ophalen bij je DonorPerfect Account Manager. Stuur je accountmanager een e-mail met het verzoek om je API-sleutel en ze sturen deze binnenkort naar je op.

Voeg de DonorPerfect-integratie toe in Klaviyo

1. Selecteer in Klaviyo het tabblad Integraties.
2. Klik op de volgende pagina op Apps ontdekken, zoek naar DonorPerfect en klik op de kaart.
3. Klik vervolgens op Installeren.
4. Voeg je DonorPerfect API-sleutel toe en klik op Verbinding maken met DonorPerfect.
5. Kies op de volgende pagina Alle DonorPerfect-donors toevoegen aan een Klaviyo-lijst en selecteer vervolgens een lijst in de dropdown die verschijnt.
   

6. Klik op Installatie afronden.

Controleer de Klaviyo-sync en verifieer de gegevens

Zo controleer je je DonorPerfect-integratie nadat je hebt geïntegreerd:

1. Klik op de dropdown Analytics in Klaviyo en selecteer het tabblad meetwaarde.
2. Klik op de meetwaarde Made Contribution om te verifiëren dat er gegevens zijn ingevuld voor deze meetwaarde. Als er gegevens zijn, hoef je alleen maar te wachten tot de eerste synchronisatie van je DonorPerfect-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 DonorPerfect-gegevens. Om dit te verifiëren, kun je het aantal bijdragen op een bepaalde dag in Klaviyo vergelijken met wat er in je DonorPerfect-interface staat en bevestigen dat ze overeenkomen.
3. Wanneer je bijvoorbeeld de meetwaarde Made Contribution in Klaviyo verkent, kun je de muisaanwijzer boven het gegevenspunt van gisteren houden of de gegevenstabel onder de grafiek bekijken om te zien hoeveel bijdragen er gisteren zijn gerapporteerd.
4. Vergelijk dat nummer met wat er gisteren in DonorPerfect is opgeslagen en je zou moeten zien dat ze exact overeenkomen. Als dat niet het geval is, komt het probleem waarschijnlijk doordat de tijdzone van je Klaviyo-account niet overeenkomt met de tijdzone van je DonorPerfect-account.
5. Zo controleer je je tijdzone-instelling in Klaviyo:
   1. Klik linksonder op je accountnaam.
   2. Selecteer en klik vervolgens op Instellingen > Organisatie.
   3. Scrol naar beneden naar Tijdzone.

DonorPerfect-gegevens

Er is 1 belangrijke meetwaarde die door DonorPerfect wordt vastgelegd en in Klaviyo wordt geladen: Bijdrage geleverd.

De meetwaarde Heeft bijgedragen

Deze gebeurtenis wordt bijgehouden wanneer een supporter een bijdrage levert in DonorPerfect. De gebeurtenis die Klaviyo bijhoudt, bevat alle informatie die DonorPerfect verzamelt, waaronder het bijdragebedrag, of de donatie terugkerend is en, zo ja, hoe vaak de donatie terugkeert. Je kunt gebeurtenissen Bijdrage geleverd filteren en targeten op basis van de volgende criteria:

• Waarde
• Campagne
• Eerste cadeau
• Type cadeau
• Ter nagedachtenis aan
• Is terugkerend (True of False)

Hier is een voorbeeld van de gegevens die we ontvangen samen met een event Made Contribution :

klantgegevens

Naast de meetwaarde die Klaviyo synchroniseert vanuit DonorPerfect, zijn er ook aangepaste eigenschappen die aan elk Klaviyo-profiel worden toegevoegd. Je kunt deze eigenschappen gebruiken in segmenten en flows. Hier zijn de eigenschappen die automatisch worden gesynchroniseerd vanuit DonorPerfect:

• E-mail
• Voornaam
• Achternaam
• Plaats
• Staat/regio
• Postcode
• Land
• Telefoonnummer

Hoe vaak DonorPerfect-gegevens worden gesynchroniseerd

Meetwaarden en profieleigenschappen van DonorPerfect worden gesynchroniseerd via webhooks. Dit betekent dat DonorPerfect aan Klaviyo doorgeeft wanneer er een event heeft plaatsgevonden, waarna Klaviyo alle gegevens voor het event 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.

1. Je vindt het volgende tracking-script in Klaviyo door het tabblad integraties te selecteren en vervolgens rechtsboven op Gegevens beheren > Webtracking instellen te klikken.
2. 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, die je vindt onder Accountnaam > Instellingen > API-sleutel, 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>

1. 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 DonorPerfect, je gesynchroniseerde gegevens geverifieerd en Klaviyo onsite tracking toegevoegd.

Extra hulpbronnen