Segment-integratie

Segment en Personyze wisselen in beide richtingen data uit.

• Segment → Personyze. Segment stuurt identify -aanroepen naar Personyze. Elke aanroep maakt vanuit zijn traits een Personyze-bezoekersprofiel aan of werkt het bij. Die traits kunnen uit je CRM, je e-mailplatform, offline transacties en berekende traits en audiences van Segment Engage komen. Daarna kun je ze gebruiken in targetingregels, dynamische content, aanbevelingen en rapporten.
• Personyze → Segment. Personyze stuurt campagnegebeurtenissen (vertoningen, klikken, conversies) naar Segment. Op je website gaan ze via analytics.js van Segment, vanuit automations via de server-API van Segment.

Je kunt elke richting apart instellen, of allebei.

Deel 1: Segment-data naar Personyze sturen

Stap 1: Een Segment-sleutel genereren in Personyze

1. Open in het Personyze-panel Instellingen → Integraties.
2. Zoek de kaart Segment en klik erop.
3. Klik in de sectie Segment → Personyze op Nieuwe sleutel genereren.
4. Bewaar de sleutel veilig — je vult hem in bij Segment.

Deze Segment-sleutels staan los van je sleutels voor de Full-featured API. Trek je er hier een in, dan wordt alleen Segment losgekoppeld.

Stap 2: De Personyze-bestemming toevoegen in Segment

1. Open in Segment Connections → Catalog → Destinations.
2. Zoek naar Personyze en selecteer het.
3. Kies de bron die data naar Personyze moet sturen. Meestal is dat de bron van je website.
4. Vul in de instellingen van de bestemming de sleutel uit stap 1 in bij API Key.
5. Sla de bestemming op en schakel haar in.

Vanaf nu maakt elke identify -aanroep uit die bron een Personyze-bezoekersprofiel aan of werkt het bij.

Stap 3: De bezoekers-id van Segment koppelen aan de websitebezoeker (aanbevolen)

Zo wordt het profiel dat Segment opbouwt verbonden met de bezoeker die Personyze op je site ziet.

1. Ga in Personyze naar Instellingen → Bezoekersattributen.
2. Open Apparaatoverstijgende gebruikersidentifiers.
3. Maak een Internal ID-identifier van het type Cookie die de cookie ajs_anonymous_id uitleest.
4. Sla hem op en schakel hem in.

Alternatief: identify-aanroepen naar de webhook-URL sturen

Gebruik dit als je de Personyze-bestemming niet kunt gebruiken — bijvoorbeeld met een Webhooks-bestemming in Segment, of met een andere CDP.

Voorbeeld-body:

{
  "type": "identify",
  "userId": "u-1029",
  "anonymousId": "5b1c2e9a-7c1f-4f0e-9b1e-2a3c4d5e6f70",
  "traits": {
    "email": "dana@example.com",
    "firstName": "Dana",
    "plan": "pro"
  }
}

In plaats van de Bearer-header kun je ook HTTP Basic-authenticatie gebruiken, met de sleutel als gebruikersnaam en een leeg wachtwoord.

Wat er in Personyze aankomt

• Een identify -aanroep maakt vanuit zijn traits een profiel aan of werkt het bij. Traitnamen in camelCase worden snake_case (firstName wordt first_name). Traits die bij een Personyze-profielveld passen, vullen dat veld. Al het andere wordt opgeslagen als eigen bezoekersattribuut.
• Omgaan met identiteit. Als een aanroep previousId of anonymousId samen met userIdbevat, koppelt Personyze het bestaande profiel opnieuw aan de userId. Een bezoeker die vóór het inloggen anoniem was, houdt zijn geschiedenis in plaats van een tweede profiel te krijgen.
• Engage. Berekende traits en audiences komen binnen als gewone identify -traits (bijvoorbeeld order_completed_last_30days: true). Volgens Segment kan de eerste audiencesynchronisatie zes uur of langer duren.

Deel 2: Personyze-campagnegebeurtenissen naar Segment sturen

Vanaf je website (analytics.js)

Dit werkt op pagina’s waar analytics.js van Segment is geïnstalleerd. Personyze laadt analytics.js nooit zelf. Op een pagina zonder dat script wordt niets verstuurd en gaat er niets stuk.

Elke gebeurtenis wordt verstuurd met analytics.track() en krijgt de naam van de campagneactie. Een vertoning ziet er zo uit:

analytics.track('<action name>', {event: 'shown', source: 'personyze'})

Je kunt op drie manieren kiezen welke gebeurtenissen naar Segment gaan:

1. Alle campagnes. Open Instellingen → Integraties → Segment. Zet in de sectie Personyze → Segment de optie Campagnegebeurtenissen hier rapporteren aan. Vertoningen, klikken en conversies van elke campagne worden naar Segment gestuurd.
2. Eén actie. Vink in de gebeurtenisinstellingen van de actie Segment aan onder Verstuur deze gebeurtenis naar. Zo rapporteer je de gebeurtenissen van één bepaalde actie aan Segment, met een eigen gebeurtenisnaam en eigenschappen.
3. Een eigen gebeurtenis. Voeg de actie Send Event to Analytics toe aan een campagne en vink Segment aan. Jij kiest de gebeurtenisnaam en de eigenschappen.

Vanuit automations (server-API van Segment)

Dit werkt zonder dat de bezoeker op je site is — bijvoorbeeld wanneer de doelgroep van een offline campagne op iemand matcht.

1. Zoek in Segment de write key op van de bron die de gebeurtenissen moet ontvangen (Connections → Sources → je bron → Settings → API Keys).
2. Voeg in Personyze de actie Send Event to Analytics (Automation) toe aan de automation.
3. Vink Segment aan en vul de write key in bij Segment write key.
4. Sla op en publiceer.

Elke gematchte gebruiker wordt naar Segment gestuurd als een track -gebeurtenis. Het e-mailadres wordt gebruikt als de userIdin Segment. Gebruikers zonder e-mailadres worden overgeslagen.

Segment-data gebruiken in Personyze

Targeting

Segment-traits verschijnen als profielvelden in targetingregels. Voeg doelgroepregels toe op demografie, rol, funnelfase of elke eigen trait.

Dynamische content

Voeg Segment-velden in als dynamische variabelen in campagnes, bijvoorbeeld “Welkom terug, {first_name}”.

Aanbevelingen

Gebruik profieldata als aanbevelingsfilters, of laat de algoritmes ze automatisch gebruiken.

Hulp nodig?

Mail naar info@personyze.com.

Op de site van Personyze

• Segment-personalisatie met Personyze — Segment-audiences op je site activeren.
• Websitepersonalisatie — de engine voor targeting en content erachter.