Amplitude-integratie: campagnegebeurtenissen erheen, cohorten terug

Personyze en Amplitude werken in beide richtingen: Personyze rapporteert campagnegebeurtenissen aan Amplitude, en je Amplitude-cohorten komen terug naar Personyze als doelgroeplijsten waarop je kunt targeten.

Deel 1: Personyze-gebeurtenissen naar Amplitude sturen

Personyze kan een gebeurtenis aan Amplitude rapporteren zodra een bezoeker bij een campagne past — verstuurd vanaf de servers van Personyze via de HTTP V2 API van Amplitude.

Dit is een bestemming die alleen voor Automation werkt. Ze roept de API aan vanaf de eigen servers van Personyze met een sleutel, dus er is geen equivalent op de pagina en het script van die tool hoeft niet op je pagina te staan. Vink haar aan in een Send Event to Analytics-actie.

Amplitude heeft wel een browser-SDK, dus het is terecht om te vragen waarom dit server-side gebeurt. Versturen vanaf onze servers betekent dat de gebeurtenis aankomt of het Amplitude-script op die pagina nu geladen is of niet — het verschil tussen een bestemming die werkt en een die alleen werkt waar toevallig een script geladen is.

Wat je nodig hebt

Veld	Waar je het vindt
Project API key	Amplitude → Settings → Projects → je project → API Key
EU project-selectievakje	Vink dit aan als je Amplitude-project in de EU staat

Staat je project niet in de VS, stel dan de regio in — niets zal je waarschuwen. Een sleutel van een niet-Amerikaans project die naar het Amerikaanse endpoint wordt gestuurd, wordt geaccepteerd, en de data wordt weggegooid. Er is nergens een foutmelding. Komen er geen gebeurtenissen aan, controleer dit dan eerst.

Hoe de persoon wordt herkend

Amplitude-gebeurtenissen zijn gekoppeld aan de Personyze-bezoekers-id, niet aan een e-mailadres — dus deze bestemming werkt ook voor anonieme bezoekers. Zie je “the recipient has no identifier” in het campagnelogboek, dan had de gematchte bezoeker geen id om te versturen, wat zelden voorkomt.

Wat er aankomt

De gebeurtenisnaam die je hebt ingevuld, de bezoekers-id, een tijdstempel en elke eigenschap die je aan de actie hebt toegevoegd — die kan putten uit het Personyze-profiel van de bezoeker en uit live campagnecijfers.

Deel 2: Amplitude-cohorten gebruiken in Personyze

Synchroniseer een Amplitude-cohort met Personyze en het wordt een doelgroeplijst met de naam “Amplitude: <cohortnaam>”. Target die in elke campagne — website, e-mail of offline. Als mensen in Amplitude het cohort in- of uitgaan, komen ze automatisch op de lijst of gaan ze eraf, en de website ziet de wijziging bij de volgende pagina van de bezoeker.

Wat je nodig hebt

Een Amplitude-abonnement met cohort-webhookbestemmingen (een betaald abonnement).
Een Personyze-API-sleutel: Instellingen → Integraties → Amplitude → Nieuwe sleutel genereren (dezelfde sleutels als op de kaart van de Full-featured API).

Instellen

Open in Personyze Instellingen → Integraties → Amplitude en kopieer de Webhook-URL (https://personyze.com/api/audiences/amplitude).
Voeg in Amplitude een Cohort Webhook-bestemming toe. Vul de URL in en voeg een header toe met de naam Authorization en de waarde Bearer <your API key> (het woord Bearer, een spatie en dan de sleutel).
Synchroniseer een cohort met die bestemming.

Amplitude-cohorten in het integratievenster van Personyze — Instellingen → Integraties → Amplitude: de webhook-URL en de API-sleutels voor een cohortsynchronisatie. Klik om te vergroten.

Hoe mensen worden gematcht

Via de user_id van Amplitude, vergeleken met de gebruikers-id die je site naar Personyze stuurt wanneer mensen inloggen, en met het e-mailadres als de user_id een e-mailadres is.

Waar je het vindt

Doelgroepen → Doelgroeplijsten. Kies de lijst in de targeting van een campagne met de regel Gebruikerslijsten.

Gerelateerd

Send Event to Analytics — de actie en haar elf andere bestemmingen.
Mixpanel-integratie — dezelfde twee richtingen voor Mixpanel.
Analytics & rapportage