Tealium-doelgroepen in Personyze, server-side: van AudienceStream naar doelgroeplijsten

Personyze leest Tealium al in de browser: badges, AudienceStream-doelgroepen en utag variabelen zolang de bezoeker op uw pagina is (zie Targeting en personalisatie met Tealium). De server-side koppeling doet de rest: de eigen servers van Tealium laten Personyze weten wanneer iemand een AudienceStream-doelgroep binnenkomt of verlaat, ook als die persoon niet op uw site is.

Wat het doet

• Elke Tealium-doelgroep wordt een doelgroeplijst in Personyze, met de naam “Tealium: <naam van de doelgroep>”. Target die in elke campagne: website, e-mail of offline.
• Wie de doelgroep binnenkomt, wordt aan de lijst toegevoegd; wie hem verlaat, wordt verwijderd. De website ziet de wijziging op de volgende pagina van de bezoeker.
• Alle kenmerken die u meestuurt — loyaliteitsniveau, abonnement, opt-ins, levensfase — worden op het profiel van de bezoeker opgeslagen. Standaardvelden zoals first_name, last_name of phone vullen het profielveld; al het andere wordt een eigen kenmerk waarop u kunt targeten.

Wat u nodig hebt

• Tealium AudienceStream, met rechten om connectors toe te voegen.
• Een API-sleutel van Personyze: Instellingen → Integraties → Tealium, onderaan de sectie Tealium-doelgroepen naar Personyze sturen (server-side), klik op Nieuwe sleutel genereren. Het zijn dezelfde sleutels als op de kaart Full-featured API, dus een sleutel die u al hebt, werkt ook.

Instellen

1. Open in Personyze Instellingen → Integraties → Tealium en neem de twee URL’s uit de server-side sectie:
   • URL voor binnenkomen: https://personyze.com/api/audiences/tealium?action=joined
   • URL voor verlaten: https://personyze.com/api/audiences/tealium?action=left

   Gebruikt u Personyze onder uw eigen domein, neem de URL’s dan uit het paneel: ze gebruiken het domein waarop u kijkt.

2. Voeg in Tealium AudienceStream een Webhook-connector toe en kies BasicAuth. Vul api in als BasicAuth Username, en uw Personyze-API-sleutel als BasicAuth Password. Bewaar de sleutel veilig: wie hem heeft, kan als uw account optreden.
3. Voeg een actie toe voor de doelgroep die u wilt versturen:
   • Trigger: Joined Audience
   • Action type: Send Customized Data via HTTP Request (Advanced)
   • Method: POST
   • URL: de URL voor binnenkomen
   • Body Content Type: application/x-www-form-urlencoded
4. Voeg onder Body Data de toewijzingen uit de tabel toe. U hebt email of user_id nodig, of allebei.
5. Voeg een tweede actie toe met de trigger Left Audience, dezelfde toewijzingen en de URL voor verlaten. Met Copy Mappings in Tealium kopieert u ze uit de eerste actie.
6. Sla op en publiceer in Tealium.

Wijst u naast de naam ook Audience ID toe, dan houdt een hernoemde doelgroep zijn lijst in Personyze. Herhaal stap 3 tot 5 voor elke doelgroep die u in Personyze wilt: elke doelgroep krijgt zijn eigen lijst.

Hoe mensen worden herkend

Personyze herkent iedereen aan de gebruikers-ID die uw site naar Personyze stuurt wanneer iemand inlogt, en daarna aan het e-mailadres. Iemand die Personyze nog niet heeft gezien, wordt ook aan de lijst toegevoegd en herkend zodra hij voor het eerst op uw site inlogt. Een verlaat-bericht over iemand die Personyze nooit heeft gezien, wordt genegeerd.

Waar u het vindt

Doelgroepen → Doelgroeplijsten. De lijsten heten “Tealium: <naam van de doelgroep>”. Kies er een in de targeting van een campagne met de regel Gebruikerslijsten. U kunt een lijst in Personyze hernoemen; de synchronisatie blijft hem gebruiken.

Andere manieren om de gegevens te sturen

Een JSON-body uit een template

Maak met Body Content Type application/json een Body-template:

{
  "audience": "{{#escapeJson}}{{audience}}{{/escapeJson}}",
  "audience_id": "{{#escapeJson}}{{audience_id}}{{/escapeJson}}",
  "email": "{{#escapeJson}}{{email}}{{/escapeJson}}",
  "user_id": "{{#escapeJson}}{{user_id}}{{/escapeJson}}",
  "attributes": {
    "loyalty_tier": "{{#escapeJson}}{{tier}}{{/escapeJson}}"
  }
}

Wijs de templatevariabelen audience, audience_id, email, user_id en tier toe aan uw kenmerken, en gebruik de URL voor binnenkomen of verlaten zoals hierboven. Zet tekstwaarden in escapeJson zodat een aanhalingsteken in een waarde de JSON niet breekt. U kunt de richting ook in de body sturen in plaats van in de URL: "action": "joined" of "action": "left".

Batches, voor grote volumes

Gebruik Send Batched Customized Data via HTTP Request (Advanced) met hetzelfde template, en stel Prefix [, Joiner , en Suffix ] in. Tealium stuurt dan tot 100 mensen per verzoek; Personyze accepteert er tot 1.000.

Het volledige bezoekersprofiel

Send Visitor Data via HTTP Request stuurt het volledige bezoekersrecord van Tealium, zonder iets toe te wijzen. Personyze leest daaruit de huidige doelgroepen van de bezoeker:

• Met ?audience=<audience name> aan het einde van de URL wordt alleen die doelgroep gesynchroniseerd: de persoon wordt toegevoegd als hij erin zit en verwijderd als dat niet zo is.
• Zonder dat wordt elke doelgroep in het record binnengekomen, en wordt de persoon verwijderd uit elke andere “Tealium:”-lijst die op naam is gesynchroniseerd.

Personyze zoekt het e-mailadres in een eigenschap met de naam Email, Email Address of Customer Email, en de gebruikers-ID in User ID, Customer ID of CRM ID. Hebben die bij u een andere naam, voeg dan email_attribute=<name> of user_id_attribute=<name> toe aan de URL. Eigenschappen en vlaggen worden op het profiel opgeslagen, met namen als customer_tier; attributes=none slaat niets op, en attributes=Name 1,Name 2 slaat alleen die op. Zet Print Attribute Names aan in de actie, zodat kenmerken met hun naam binnenkomen.

Alleen kenmerken

Een verzoek zonder doelgroep werkt alleen het profiel bij. Dat werkt ook vanuit EventStream: wijs eventkenmerken toe aan email of user_id, en de kenmerken die u wilt.

Beperkingen

• Tot 1.000 mensen per verzoek, en 5 MB per verzoek.
• Tot 100 kenmerken per persoon. Kenmerknamen tot 64 tekens, waarden tot 1.000 tekens; wat langer is, wordt overgeslagen, niet ingekort.
• E-mailadressen en gebruikers-ID’s tot 80 tekens.
• Doelgroepnamen tot 120 tekens, tenzij u ook de Audience ID meestuurt.
• Hetzelfde bericht twee keer sturen is veilig: niemand wordt twee keer toegevoegd.

Als iets niet werkt

Personyze beantwoordt elk verzoek met een kort bericht over wat het deed, of wat er mis is. Tealium toont het in het log van de connector.

Gerelateerd

• Targeting en personalisatie met Tealium — de browserkant: badges, doelgroepen en utag-variabelen op de pagina.
• Amplitude en Mixpanel — dezelfde synchronisatie van doelgroeplijsten voor hun cohorten.
• Problemen oplossen: een integratie synchroniseert niet meer