Audiences Tealium dans Personyze, côté serveur : d’AudienceStream aux listes d’audience

Personyze lit déjà Tealium dans le navigateur : badges, audiences AudienceStream et variables utag pendant que le visiteur est sur votre page (voir Ciblage et personnalisation avec Tealium). La connexion côté serveur couvre le reste : les serveurs de Tealium eux-mêmes préviennent Personyze quand une personne entre dans une audience AudienceStream ou en sort, même quand elle n’est pas sur votre site.

Ce que cela fait

• Chaque audience Tealium devient une liste d’audience dans Personyze, nommée “Tealium: <nom de l’audience>”. Ciblez-la dans n’importe quelle campagne : site web, e-mail ou hors ligne.
• Une personne qui entre dans l’audience est ajoutée à la liste ; une personne qui en sort en est retirée. Le site voit le changement dès la page suivante du visiteur.
• Les attributs que vous envoyez — niveau de fidélité, offre, consentements, étape du cycle de vie — sont enregistrés sur le profil du visiteur. Les champs standard comme first_name, last_name ou phone remplissent le champ du profil ; tout le reste devient un attribut personnalisé que vous pouvez cibler.

Ce qu’il vous faut

• Tealium AudienceStream, avec le droit d’ajouter des connecteurs.
• Une clé API Personyze : Paramètres → Intégrations → Tealium, en bas de la section Envoyer les audiences Tealium vers Personyze (côté serveur), cliquez sur Générer une nouvelle clé. Ce sont les mêmes clés que sur la carte API complète : une clé que vous avez déjà fonctionne aussi.

Mise en place

1. Dans Personyze, ouvrez Paramètres → Intégrations → Tealium et prenez les deux URL de la section côté serveur :
   • URL d’entrée : https://personyze.com/api/audiences/tealium?action=joined
   • URL de sortie : https://personyze.com/api/audiences/tealium?action=left

   Si vous utilisez Personyze sous votre propre domaine, prenez les URL dans le panneau : elles utilisent le domaine que vous consultez.

2. Dans Tealium AudienceStream, ajoutez un connecteur Webhook et choisissez BasicAuth. Saisissez api comme BasicAuth Username, et votre clé API Personyze comme BasicAuth Password. Gardez la clé en lieu sûr : quiconque la possède peut agir au nom de votre compte.
3. Ajoutez une action pour l’audience à envoyer :
   • Trigger : Joined Audience
   • Action type : Send Customized Data via HTTP Request (Advanced)
   • Method : POST
   • URL : l’URL d’entrée
   • Body Content Type : application/x-www-form-urlencoded
4. Sous Body Data, ajoutez les correspondances du tableau. Il vous faut email ou user_id, ou les deux.
5. Ajoutez une seconde action avec le déclencheur Left Audience, les mêmes correspondances et l’URL de sortie. Copy Mappings dans Tealium les recopie depuis la première action.
6. Enregistrez et publiez dans Tealium.

Associer aussi l’Audience ID, en plus du nom, permet à une audience renommée de garder sa liste dans Personyze. Répétez les étapes 3 à 5 pour chaque audience voulue dans Personyze : chacune a sa propre liste.

Comment les personnes sont reconnues

Personyze reconnaît chaque personne à l’identifiant utilisateur que votre site envoie à Personyze lors de la connexion, puis à l’adresse e-mail. Une personne que Personyze n’a encore jamais vue est aussi ajoutée à la liste, et reconnue la première fois qu’elle se connecte sur votre site. Un message de sortie concernant une personne jamais vue est ignoré.

Où la trouver

Audiences → Listes d’audience. Les listes s’appellent “Tealium: <nom de l’audience>”. Choisissez-en une dans le ciblage d’une campagne avec la règle Listes d’utilisateurs. Vous pouvez renommer une liste dans Personyze : la synchronisation continue de l’utiliser.

Autres façons d’envoyer les données

Un corps JSON à partir d’un modèle

Avec Body Content Type application/json, créez un modèle de corps :

{
  "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}}"
  }
}

Associez les variables du modèle audience, audience_id, email, user_id et tier à vos attributs, et utilisez l’URL d’entrée ou de sortie comme plus haut. Entourez les valeurs texte de escapeJson pour qu’un guillemet dans une valeur ne casse pas le JSON. Vous pouvez aussi indiquer le sens dans le corps plutôt que dans l’URL : "action": "joined" ou "action": "left".

Par lots, pour les gros volumes

Utilisez Send Batched Customized Data via HTTP Request (Advanced) avec le même modèle, et réglez Prefix [, Joiner , et Suffix ]. Tealium envoie alors jusqu’à 100 personnes par requête ; Personyze en accepte jusqu’à 1 000.

Le profil complet du visiteur

Send Visitor Data via HTTP Request envoie la fiche complète du visiteur dans Tealium, sans rien à associer. Personyze y lit les audiences actuelles du visiteur :

• Avec ?audience=<audience name> à la fin de l’URL, seule cette audience est synchronisée : la personne est ajoutée si elle en fait partie, et retirée sinon.
• Sans cela, toutes les audiences de la fiche sont rejointes, et la personne est retirée de toute autre liste “Tealium:” synchronisée par nom.

Personyze trouve l’e-mail dans une propriété nommée Email, Email Address ou Customer Email, et l’identifiant utilisateur dans User ID, Customer ID ou CRM ID. Si les vôtres portent un autre nom, ajoutez email_attribute=<name> ou user_id_attribute=<name> à l’URL. Les propriétés et les indicateurs sont enregistrés sur le profil, sous des noms comme customer_tier; attributes=none n’en enregistre aucun, et attributes=Name 1,Name 2 n’enregistre que ceux-là. Activez Print Attribute Names dans l’action pour que les attributs arrivent avec leur nom.

Attributs seulement

Une requête sans audience met seulement le profil à jour. Cela fonctionne aussi depuis EventStream : associez les attributs de l’événement à email ou user_id, et les attributs voulus.

Limites

• Jusqu’à 1 000 personnes par requête, et 5 Mo par requête.
• Jusqu’à 100 attributs par personne. Noms d’attribut jusqu’à 64 caractères, valeurs jusqu’à 1 000 caractères ; au-delà, ils sont ignorés, pas tronqués.
• E-mails et identifiants utilisateur jusqu’à 80 caractères.
• Noms d’audience jusqu’à 120 caractères, sauf si vous envoyez aussi l’Audience ID.
• Envoyer deux fois le même message est sans risque : personne n’est ajouté deux fois.

Si quelque chose ne fonctionne pas

Personyze répond à chaque requête par un court message qui dit ce qu’il a fait, ou ce qui ne va pas. Tealium l’affiche dans le journal du connecteur.

Voir aussi

• Ciblage et personnalisation avec Tealium — le côté navigateur : badges, audiences et variables utag sur la page.
• Amplitude et Mixpanel — la même synchronisation de listes d’audience pour leurs cohortes.
• Dépannage : une intégration a cessé de se synchroniser