Tealium-Zielgruppen in Personyze, serverseitig: von AudienceStream zu Zielgruppenlisten

Personyze liest Tealium bereits im Browser: Badges, AudienceStream-Zielgruppen und utag Variablen, solange der Besucher auf Ihrer Seite ist (siehe Targeting und Personalisierung mit Tealium). Die serverseitige Verbindung deckt den Rest ab: die Server von Tealium selbst teilen Personyze mit, wenn eine Person einer AudienceStream-Zielgruppe beitritt oder sie verlässt, auch wenn sie gerade nicht auf Ihrer Website ist.

Was es tut

• Jede Tealium-Zielgruppe wird in Personyze zu einer Zielgruppenliste mit dem Namen “Tealium: <Name der Zielgruppe>”. Zielen Sie in jeder Kampagne darauf: Website, E-Mail oder offline.
• Wer der Zielgruppe beitritt, wird der Liste hinzugefügt; wer sie verlässt, wird entfernt. Die Website sieht die Änderung auf der nächsten Seite des Besuchers.
• Alle Attribute, die Sie mitsenden — Treuestufe, Tarif, Einwilligungen, Lebenszyklusphase —, werden im Besucherprofil gespeichert. Standardfelder wie first_name, last_name oder phone füllen das Profilfeld; alles andere wird zu einem eigenen Attribut, auf das Sie zielen können.

Was Sie brauchen

• Tealium AudienceStream mit der Berechtigung, Connectors hinzuzufügen.
• Einen Personyze-API-Schlüssel: Einstellungen → Integrationen → Tealium, unten im Abschnitt Tealium-Zielgruppen an Personyze senden (serverseitig), klicken Sie auf Neuen Schlüssel erzeugen. Es sind dieselben Schlüssel wie auf der Karte Vollwertige API, ein vorhandener Schlüssel funktioniert also auch.

Einrichtung

1. Öffnen Sie in Personyze Einstellungen → Integrationen → Tealium und übernehmen Sie die beiden URLs aus dem serverseitigen Abschnitt:
   • URL für den Beitritt: https://personyze.com/api/audiences/tealium?action=joined
   • URL für den Austritt: https://personyze.com/api/audiences/tealium?action=left

   Wenn Sie Personyze unter Ihrer eigenen Domain nutzen, übernehmen Sie die URLs aus dem Panel: Sie verwenden die Domain, auf der Sie gerade sind.

2. Fügen Sie in Tealium AudienceStream einen Webhook-Connector hinzu und wählen Sie BasicAuth. Geben Sie api als BasicAuth Username ein und Ihren Personyze-API-Schlüssel als BasicAuth Password. Bewahren Sie den Schlüssel sicher auf: Wer ihn hat, kann als Ihr Konto handeln.
3. Fügen Sie eine Aktion für die Zielgruppe hinzu, die Sie senden möchten:
   • Trigger: Joined Audience
   • Action type: Send Customized Data via HTTP Request (Advanced)
   • Method: POST
   • URL: die URL für den Beitritt
   • Body Content Type: application/x-www-form-urlencoded
4. Fügen Sie unter Body Data die Zuordnungen aus der Tabelle hinzu. Sie brauchen email oder user_id, oder beides.
5. Fügen Sie eine zweite Aktion mit dem Trigger Left Audience hinzu, mit denselben Zuordnungen und der URL für den Austritt. Copy Mappings in Tealium übernimmt sie aus der ersten Aktion.
6. Speichern und veröffentlichen Sie in Tealium.

Ordnen Sie neben dem Namen auch die Audience ID zu, behält eine umbenannte Zielgruppe ihre Liste in Personyze. Wiederholen Sie die Schritte 3 bis 5 für jede Zielgruppe, die Sie in Personyze haben möchten: Jede bekommt ihre eigene Liste.

Wie Personen zugeordnet werden

Personyze ordnet jede Person über die Benutzer-ID zu, die Ihre Website beim Login an Personyze sendet, und danach über die E-Mail-Adresse. Wen Personyze noch nicht kennt, wird ebenfalls in die Liste aufgenommen und beim ersten Login auf Ihrer Website erkannt. Eine Austrittsmeldung zu jemandem, den Personyze nie gesehen hat, wird ignoriert.

Wo Sie es finden

Zielgruppen → Zielgruppenlisten. Die Listen heißen “Tealium: <Name der Zielgruppe>”. Wählen Sie eine im Targeting einer Kampagne mit der Regel Benutzerlisten. Sie können eine Liste in Personyze umbenennen; die Synchronisation verwendet sie weiter.

Weitere Wege, die Daten zu senden

Ein JSON-Body aus einer Vorlage

Legen Sie mit Body Content Type application/json eine Body-Vorlage an:

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

Ordnen Sie die Vorlagenvariablen audience, audience_id, email, user_id und tier Ihren Attributen zu und verwenden Sie wie oben die URL für den Beitritt oder Austritt. Setzen Sie Textwerte in escapeJson , damit ein Anführungszeichen in einem Wert das JSON nicht beschädigt. Sie können die Richtung auch im Body statt in der URL senden: "action": "joined" oder "action": "left".

Batches, für große Mengen

Verwenden Sie Send Batched Customized Data via HTTP Request (Advanced) mit derselben Vorlage und setzen Sie Prefix [, Joiner , und Suffix ]. Tealium sendet dann bis zu 100 Personen pro Anfrage; Personyze nimmt bis zu 1.000 an.

Das vollständige Besucherprofil

Send Visitor Data via HTTP Request sendet den vollständigen Besucherdatensatz von Tealium, ohne dass etwas zugeordnet werden muss. Personyze liest daraus die aktuellen Zielgruppen des Besuchers:

• Mit ?audience=<audience name> am Ende der URL wird nur diese Zielgruppe synchronisiert: Die Person wird hinzugefügt, wenn sie dazugehört, und sonst entfernt.
• Ohne diesen Zusatz tritt die Person allen Zielgruppen im Datensatz bei und wird aus jeder anderen per Namen synchronisierten “Tealium:”-Liste entfernt.

Personyze findet die E-Mail-Adresse in einer Eigenschaft namens Email, Email Address oder Customer Email, und die Benutzer-ID in User ID, Customer ID oder CRM ID. Heißen Ihre anders, fügen Sie email_attribute=<name> oder user_id_attribute=<name> an die URL an. Eigenschaften und Flags werden im Profil gespeichert, mit Namen wie customer_tier; attributes=none speichert keine, und attributes=Name 1,Name 2 speichert nur diese. Aktivieren Sie Print Attribute Names in der Aktion, damit Attribute mit ihrem Namen ankommen.

Nur Attribute

Eine Anfrage ohne Zielgruppe aktualisiert nur das Profil. Das funktioniert auch aus EventStream: Ordnen Sie Event-Attribute email oder user_id zu, dazu die gewünschten Attribute.

Grenzen

• Bis zu 1.000 Personen pro Anfrage und 5 MB pro Anfrage.
• Bis zu 100 Attribute pro Person. Attributnamen bis 64 Zeichen, Werte bis 1.000 Zeichen; Längeres wird ausgelassen, nicht gekürzt.
• E-Mail-Adressen und Benutzer-IDs bis 80 Zeichen.
• Zielgruppennamen bis 120 Zeichen, es sei denn, Sie senden auch die Audience ID.
• Dieselbe Nachricht zweimal zu senden ist unbedenklich: Niemand wird doppelt hinzugefügt.

Wenn etwas nicht funktioniert

Personyze beantwortet jede Anfrage mit einer kurzen Nachricht, was es getan hat oder was falsch ist. Tealium zeigt sie im Log des Connectors.

Siehe auch

• Targeting und Personalisierung mit Tealium — die Browserseite: Badges, Zielgruppen und utag-Variablen auf der Seite.
• Amplitude und Mixpanel — dieselbe Synchronisation von Zielgruppenlisten für ihre Kohorten.
• Fehlerbehebung: Eine Integration synchronisiert nicht