Tealium AudienceStream
Tealium AudienceStream ist eine Omnichannel-Kundensegmentierung und Realtime-Action-Engine. AudienceStream nimmt die Daten, die in EventStream einfließen, und erstellt Besucherprofile, die die wichtigsten Attribute des Engagements Ihrer Kund:innen mit Ihrer Marke darstellen.
Die Integration von Braze und Tealium nutzt die AudienceStream-Besucherprofile. Gemeinsame Verhaltensweisen segmentieren diese Profile, um Gruppen von Besuchern mit gemeinsamen Merkmalen zu erstellen, die als Zielgruppen bezeichnet werden. Diese Zielgruppen können Ihren Marketingtechnologie-Stack in Realtime über Konnektoren unterstützen.

Tealium AudienceStreams und EventStreams bieten sowohl Batch- als auch Non-Batch-Konnektor-Aktionen. Der Non-Batch-Konnektor sollte verwendet werden, wenn Realtime-Anfragen für den Anwendungsfall wichtig sind und keine Bedenken bestehen, die Spezifikationen für die Rate-Limits der Braze API zu überschreiten. Kontaktieren Sie den Braze-Support oder Ihren Customer-Success-Manager, wenn Sie Fragen haben.
Voraussetzungen
| Name | Beschreibung |
|---|---|
| Tealium-Konto | Ein Tealium-Konto mit serverseitigem Zugriff ist erforderlich. Wir empfehlen, auch die clientseitigen Integrationen zu nutzen, um von dieser Partnerschaft zu profitieren. |
| REST-API-Schlüssel | Ein Braze-REST-API-Schlüssel mit den Berechtigungen users.track, users.delete und subscription.status.set.Dieser kann erstellt werden unter Braze-Dashboard > Entwicklungskonsole > REST-API-Schlüssel > Neuen API-Schlüssel erstellen. |
| Braze-REST-Endpunkt | Ihre REST-Endpunkt-URL. Ihr Endpunkt hängt von der Braze-URL für Ihre Instanz ab. |
Integration
1. Schritt: Attribute und Badges einrichten
Attribute verstehen
Der erste Schritt bei der Verwendung von AudienceStream besteht darin, Attribute zu erstellen. Attribute erlauben es Ihnen, die wichtigen Merkmale zu definieren, die die Gewohnheiten, Vorlieben, Aktionen und das Engagement eines Besuchers mit Ihrer Marke repräsentieren.
Visit-Attribute: Visit-Attribute beziehen sich auf den aktuellen Besuch (oder die Sitzung) der Nutzer:innen. Die in diesen Attributen gespeicherten Daten bleiben für die Dauer des Besuchs erhalten. Einige Beispiele für Visit-Attribute sind:
- Besuchsdauer (Zahl)
- Aktueller Browser (String)
- Aktuelles Gerät (String)
- Anzahl der Seitenaufrufe (Zahl)
Visitor-Attribute: Visitor-Attribute beziehen sich auf die aktuellen Nutzer:innen. Die in diesen Attributen gespeicherten Daten bleiben für die Lifetime der Nutzer:innen bestehen. Einige Beispiele für Visitor-Attribute sind:
- Lifetime-Bestellwert (Zahl)
- Vorname (String)
- Geburtsdatum (Datum)
- Gekaufte Marken (Tally)
Besuchen Sie Tealium für eine vollständige Liste der verfügbaren Datentypen.
Anreicherung von Attributen
Sobald Sie die gewünschten Attribute identifiziert haben, können Sie diese mit Anreicherungen konfigurieren – Geschäftsregeln, die festlegen, wann und wie die Werte der Attribute aktualisiert werden sollen. Jeder Datentyp bietet eine eigene Auswahl an Anreicherungen, um den Wert des Attributs zu manipulieren. Dies steht im Zusammenhang mit der „WHEN“-Einstellung. Die folgenden Optionen stehen für jedes Visit- und Visitor-Attribut zur Verfügung:
- New Visitor: tritt auf, wenn ein Besucher zum ersten Mal auf Ihre Website kommt.
- New Visit: tritt bei einem neuen Besuch eines Besuchers auf.
- Any Event: tritt bei jedem Ereignis ein.
- Visit Ended: tritt auf, wenn ein Besuch endet.
Sie können auch eine angepasste Bedingung, eine sogenannte Regel, erstellen, die bestimmt, wann die Anreicherung stattfindet.
Badges
Badges sind spezielle Visitor-Attribute, die wertvolle Verhaltensmuster darstellen. Badges werden Besuchern auf der Grundlage der Logik ihrer Anreicherungen zugewiesen oder entzogen. Diese Logik kombiniert in der Regel mehrere Bedingungen, um Besuchersegmente zu erfassen, oder legt einen Schwellenwert fest, wenn ein bestimmter Wert erreicht wird.
Attribut- und Badge-Beispiel
Erstellen Sie ein Visitor-Attribut „Lifetime Order Value“, das den kumulativen Betrag berechnet, den die Kund:innen für alle abgeschlossenen Bestellungen (Kauf-Event) ausgegeben haben (order_total). Um den Lifetime-Bestellwert in Ihrem Tealium-Konto einzurichten, befolgen Sie die folgenden Anweisungen:
- Navigieren Sie zu AudienceStream > Visitor/Visit Attributes und klicken Sie auf Add Attribute.
- Wählen Sie den Bereich als Visitor aus und klicken Sie auf Continue.
- Wählen Sie den Datentyp Number aus und klicken Sie auf Continue.
- Geben Sie den Namen des Attributs ein: „Lifetime Order Value“.
- Klicken Sie auf Add Enrichment und wählen Sie Increment or Decrement Number.
- Wählen Sie das Attribut aus, das den Wert enthält, um den erhöht werden soll (
order_total). - Lassen Sie „WHEN“ auf „Any Event“ eingestellt und klicken Sie dann auf Create a New Rule.
- Erstellen Sie eine Regel, die feststellt, wann ein Kauf-Event stattgefunden hat.
- Klicken Sie auf Save und dann auf Finish.
Jetzt wird allen Kund:innen ein Lifetime-Bestellwert-Attribut zugewiesen.
Sie können Badges erstellen, die Ihnen helfen, Ihre Nutzer:innen anhand bestimmter Attribute zu klassifizieren und gezielt anzusprechen. Im folgenden Beispiel erstellen wir ein VIP-Badge für Nutzer:innen mit einem „Lifetime Order Value“ von über 500 $.
- Navigieren Sie zu AudienceStream > Visitor/Visit Attributes und klicken Sie auf Add Attribute.
- Wählen Sie den Bereich als Visitor aus und klicken Sie auf Continue.
- Wählen Sie den Datentyp Badge aus und klicken Sie auf Continue.
- Geben Sie den Namen des Badges ein: „VIP“.
- Klicken Sie auf Add Enrichment und wählen Sie Assign Badge.
- Lassen Sie „WHEN“ auf „Any Event“ eingestellt.
- Erstellen Sie eine Regel für die Badge-Zuweisung, indem Sie Create Rule auswählen. Weisen Sie dieser Regel einen Titel zu und setzen Sie die Regel mithilfe des zuvor erstellten Attributs auf „…has attribute „Lifetime Order Value greater than 500“.
- Klicken Sie auf Save und dann auf Finish.
2. Schritt: Eine Zielgruppe erstellen
Wählen Sie auf der Tealium-Startseite unter AudienceStream in der Seitenleiste Audiences aus. Hier können Sie eine Zielgruppe von Nutzer:innen mit gemeinsamen Attributen erstellen. Der Eintritt oder Austritt von Nutzer:innen aus dieser Zielgruppe ist der Auslöser für die im nächsten Schritt eingerichtete Konnektor-Aktion, die diese Informationen an das Nutzerprofil in Braze weitergibt.
Benennen Sie zunächst Ihre Zielgruppe und überlegen Sie dann, welche Attribute auf die Art der Zielgruppe zutreffen, die Sie erstellen möchten. Um zum Beispiel eine Zielgruppe von VIP-Nutzer:innen zu erstellen, könnten Sie eine Zielgruppe von Besuchern erstellen, die das VIP-Badge haben.
Vergewissern Sie sich, dass Sie Ihre Zielgruppe speichern/veröffentlichen, wenn Sie fertig sind.
3. Schritt: Einen Event-Konnektor erstellen
Ein Konnektor ist eine Integration zwischen Tealium und einem anderen Anbieter, die zur Übertragung von Daten verwendet wird. Diese Konnektoren enthalten Aktionen, die die unterstützten APIs des Partners repräsentieren.
- Navigieren Sie in der Seitenleiste von Tealium unter Server-Side zu AudienceStream > Audience Connectors.
- Wählen Sie den blauen Button + Add Connector, um den Konnektor-Marktplatz zu durchsuchen. In dem neu erscheinenden Dialogfeld verwenden Sie die Spotlight-Suche, um den Braze-Konnektor zu finden.
- Um diesen Konnektor hinzuzufügen, klicken Sie auf die Braze-Konnektor-Kachel. Wenn Sie darauf klicken, können Sie die Verbindungsübersicht und eine Liste der erforderlichen Informationen, der unterstützten Aktionen und der Konfigurationsanweisungen anzeigen. Die Konfiguration umfasst drei Schritte: Quelle, Konfiguration und Aktion.
Quelle
Wählen Sie im daraufhin angezeigten Source-Dialog die Zielgruppe aus, die Sie im vorherigen Schritt erstellt haben, und einen Auslöser, den Sie für Ihre Situation für geeignet halten. Sie können auch die Frequenzbegrenzung aktivieren, um zu kontrollieren, wie oft diese Aktion ausgelöst wird.

Konfiguration
Als Nächstes wird ein Configuration-Dialog angezeigt. Wählen Sie unten auf der Seite Add Connector aus. Benennen Sie Ihren Konnektor und geben Sie hier Ihren Braze-API-Endpunkt und den Braze-REST-API-Schlüssel an.

Wenn Sie bereits einen Konnektor erstellt haben, können Sie optional einen vorhandenen Konnektor aus der Liste der verfügbaren Konnektoren verwenden und ihn mit dem Bleistiftsymbol an Ihre Bedürfnisse anpassen oder mit dem Papierkorbsymbol löschen.
Nachdem Sie einen Konnektor zur Verknüpfung dieser Zielgruppe erstellt oder ausgewählt haben, klicken Sie auf Done, um fortzufahren.
Aktion
Benennen Sie als Nächstes Ihre Konnektor-Aktion und wählen Sie einen Aktionstyp aus, der Daten gemäß der von Ihnen konfigurierten Abbildung sendet. Hier bilden Sie Braze-Attribute auf Tealium-Attributnamen ab. Je nachdem, welchen Aktionstyp Sie auswählen, gibt es eine unterschiedliche Auswahl an Feldern, die Tealium benötigt. Im Folgenden finden Sie Beispiele und Erläuterungen zu diesen Feldern.

Nicht alle angebotenen Felder sind erforderlich.

Mit dieser Aktion können Sie Nutzer:innen-, Event- und Kauf-Attribute in einer einzigen Aktion tracken. Obwohl die Aktion „Track User“ sowohl für AudienceStream als auch für EventStream gleich ist, empfiehlt Tealium, die Abbildungen der Nutzerattribute mit AudienceStream-Aktionen und die Event- und Kauf-Abbildungen mit EventStream-Aktionen einzurichten.
| Parameter | Beschreibung |
|---|---|
| Nutzer-ID | Verwenden Sie dieses Feld, um das Tealium-Nutzer-ID-Feld auf das entsprechende Braze-Feld abzubilden. Bilden Sie ein oder mehrere Nutzer-ID-Attribute ab. Wenn mehrere IDs angegeben werden, wird der erste nicht-leere Wert in der folgenden Prioritätsreihenfolge ausgewählt: Externe ID, Braze ID, Alias-Name und Alias-Label. - Externe ID und Braze ID sollten beim Import von Push-Tokens nicht angegeben werden. - Wenn Sie einen Nutzer-Alias angeben, sollten Alias-Name und Alias-Label festgelegt werden. Weitere Informationen finden Sie unter dem Braze-Endpunkt /users/track. |
| Nutzerattribute | Verwenden Sie die vorhandenen Feldnamen der Braze-Nutzerprofile, um die Werte der Nutzerprofile im Braze-Dashboard zu aktualisieren, oder fügen Sie den Nutzerprofilen Ihre eigenen angepassten Nutzerattribut-Daten hinzu. - Standardmäßig werden neue Nutzer:innen angelegt, wenn noch keine vorhanden sind. - Wenn Sie Update Existing Only auf true setzen, werden nur vorhandene Nutzer:innen aktualisiert und keine neuen Nutzer:innen angelegt.- Wenn ein Tealium-Attribut leer ist, wird es in Null umgewandelt und aus dem Braze-Nutzerprofil entfernt. Anreicherungen sollten verwendet werden, wenn keine Nullwerte an Braze gesendet werden sollen, um ein Nutzerattribut zu entfernen. |
| Nutzerattribute ändern | Verwenden Sie dieses Feld, um bestimmte Nutzerattribute zu erhöhen oder zu verringern. - Integer-Attribute können um positive oder negative ganze Zahlen inkrementiert werden. - Array-Attribute können durch Hinzufügen oder Entfernen von Werten in bestehenden Arrays geändert werden. |
| Event | Ein Event stellt ein einzelnes Vorkommen eines angepassten Events durch bestimmte Nutzer:innen zu einem bestimmten Zeitstempel dar. Verwenden Sie dieses Feld zum Tracking und zur Abbildung von Event-Attributen, wie sie im Braze-Event-Objekt enthalten sind. - Das Event-Attribut Name ist für jedes zugeordnete Event erforderlich.- Das Event-Attribut Time wird automatisch auf „jetzt“ gesetzt, wenn es nicht explizit abgebildet wird. - Standardmäßig werden neue Events erstellt, wenn noch keines vorhanden ist. Wenn Sie Update Existing Only auf true setzen, werden nur bestehende Events aktualisiert und es wird kein neues Event erstellt.- Bilden Sie Array-Typ-Attribute ab, um mehrere Events hinzuzufügen. Array-Typ-Attribute müssen gleich lang sein. - Einzelwert-Attribute können verwendet und auf jedes Event angewendet werden. |
| Event-Template | Stellen Sie Event-Templates zur Verfügung, auf die in den Body-Daten referenziert werden kann. Templates können verwendet werden, um Daten zu transformieren, bevor sie an Braze gesendet werden. Weitere Informationen finden Sie in der Template-Anleitung von Tealium. |
| Event-Template-Variable | Stellen Sie Event-Template-Variablen als Dateneingabe bereit. Weitere Informationen finden Sie im Leitfaden für Template-Variablen von Tealium. |
| Kauf | Verwenden Sie dieses Feld, um Nutzer-Kaufattribute zu tracken und abzubilden, wie sie im Braze-Kauf-Objekt enthalten sind. - Die Kaufattribute Product ID, Currency und Price sind für jeden zugeordneten Kauf erforderlich.- Das Kaufattribut Time wird automatisch auf „jetzt“ gesetzt, wenn es nicht explizit abgebildet wird.- Standardmäßig werden neue Käufe angelegt, wenn noch keine vorhanden sind. Wenn Sie Update Existing Only auf true setzen, werden nur bestehende Käufe aktualisiert und es wird kein neuer Kauf angelegt.- Bilden Sie Array-Typ-Attribute ab, um mehrere Kaufartikel hinzuzufügen. Array-Typ-Attribute müssen gleich lang sein. - Einzelwert-Attribute können verwendet werden und gelten dann für jeden Artikel. |
| Kauf-Template | Templates können verwendet werden, um Daten zu transformieren, bevor sie an Braze gesendet werden. - Definieren Sie ein Kauf-Template, wenn Sie Unterstützung für verschachtelte Objekte benötigen. - Wenn ein Kauf-Template definiert wird, wird die Konfiguration, die im Kaufbereich Ihrer Aktion eingerichtet wurde, ignoriert. - Weitere Informationen finden Sie in der Template-Anleitung von Tealium. |
| Kauf-Template-Variable | Stellen Sie Produkt-Template-Variablen als Dateneingabe bereit. Weitere Informationen finden Sie im Leitfaden für Template-Variablen von Tealium. |

Diese Aktion erlaubt es Ihnen, Nutzer:innen aus dem Braze-Dashboard zu löschen.
| Parameter | Beschreibung |
|---|---|
| Nutzer-ID | Verwenden Sie dieses Feld, um das Tealium-Nutzer-ID-Feld auf das entsprechende Braze-Feld abzubilden. - Bilden Sie ein oder mehrere Nutzer-ID-Attribute ab. Wenn mehrere IDs angegeben werden, wird der erste nicht-leere Wert in der folgenden Prioritätsreihenfolge ausgewählt: Externe ID, Braze ID, Alias-Name und Alias-Label. - Wenn Sie einen Nutzer-Alias angeben, sollten sowohl Alias-Name als auch Alias-Label festgelegt werden. Weitere Informationen finden Sie unter dem Braze-Endpunkt /users/delete. |

Wählen Sie Finish.
Zusammenfassung
Sehen Sie sich die Zusammenfassung des von Ihnen erstellten Konnektors an. Wenn Sie die von Ihnen gewählten Optionen ändern möchten, wählen Sie Back zum Bearbeiten oder Finish zum Abschließen.
Ihr Konnektor wird nun in der Liste der Konnektoren auf Ihrer Tealium-Startseite angezeigt.
Stellen Sie sicher, dass Sie Ihren Konnektor speichern oder veröffentlichen, wenn Sie fertig sind. Die von Ihnen konfigurierten Aktionen werden nun ausgelöst, wenn die Trigger-Verbindungen erfüllt sind.
4. Schritt: Ihren Tealium-Konnektor testen
Nachdem Ihr Konnektor betriebsbereit ist, sollten Sie ihn testen, um sicherzustellen, dass er ordnungsgemäß funktioniert. Der einfachste Weg, dies zu testen, ist die Verwendung des Tealium Trace Tools. Um Trace nutzen zu können, müssen Sie die Tealium-Tools-Browsererweiterung hinzugefügt haben.
- Um einen neuen Trace zu starten, wählen Sie Trace in der Seitenleiste unter Server-Side-Optionen. Klicken Sie auf Start und erfassen Sie die Trace-ID.
- Öffnen Sie die Browsererweiterung und geben Sie die Trace-ID in AudienceStream Trace ein.
- Prüfen Sie das Realtime-Protokoll.
- Suchen Sie nach der Aktion, die Sie validieren möchten, indem Sie auf den Eintrag Actions Triggered klicken, um ihn zu erweitern.
- Suchen Sie nach der Aktion, die Sie validieren möchten, und sehen Sie sich den Protokollstatus an.
Ausführlichere Anweisungen zur Implementierung des Trace-Tools von Tealium finden Sie in der Trace-Dokumentation von Tealium.
Demo zur Integration
Mögliche Mehrkosten für Datenpunkte
Es gibt drei Hauptwege, wie Sie bei der Integration von Braze über Tealium versehentlich auf Mehrkosten bei den Datenpunkten stoßen können:
Doppelte Daten senden – nur Braze-Deltas von Attributen senden
Tealium sendet keine Braze-Deltas von Nutzerattributen. Wenn Sie zum Beispiel eine EventStream-Aktion haben, die den Vornamen, die E-Mail und die Handynummer von Nutzer:innen trackt, sendet Tealium alle drei Attribute an Braze, sobald die Aktion getriggert wird. Tealium sucht nicht danach, was sich geändert hat oder aktualisiert wurde, und sendet nur diese Informationen.
Lösung:
Sie können in Ihrem Backend überprüfen, ob sich ein Attribut geändert hat oder nicht, und wenn ja, die entsprechenden Methoden von Tealium aufrufen, um das Nutzerprofil zu aktualisieren. Das tun Nutzer:innen, die Braze direkt integrieren, normalerweise auch.
ODER
Wenn Sie keine eigene Version eines Nutzerprofils in Ihrem Backend speichern und nicht feststellen können, ob sich Attribute ändern oder nicht, können Sie AudienceStream verwenden und Anreicherungen erstellen, um Nutzerattribute nur dann zu senden, wenn sich die Werte geändert haben.
Irrelevante Daten senden oder Daten unnötig überschreiben
Wenn Sie mehrere EventStreams haben, die auf denselben Event-Feed zielen, werden alle für diesen Konnektor aktivierten Aktionen automatisch ausgelöst, sobald eine einzelne Aktion getriggert wird. Dies kann auch dazu führen, dass Daten in Braze überschrieben werden.
Lösung:
Richten Sie eine separate Ereignisspezifikation oder einen Feed ein, um jede Aktion zu tracken.
ODER
Deaktivieren Sie Aktionen (oder Konnektoren), die Sie nicht auslösen möchten, mit den Umschaltern im Tealium-Dashboard.
Braze zu früh initialisieren
Wenn Sie Tealium mit dem Braze Web SDK Tag integrieren, können Sie einen dramatischen Anstieg Ihrer MAU verzeichnen. Wenn Braze beim Laden der Seite initialisiert wird, erstellt Braze jedes Mal ein anonymes Profil, wenn Web-Nutzer:innen zum ersten Mal auf die Website navigieren. Dies schließt Bot-Traffic ein, der Ihre Zahl aktiver Nutzer:innen aufblähen kann. Manche möchten das Nutzerverhalten nur dann tracken, wenn Nutzer:innen eine Aktion abgeschlossen haben, wie z. B. „Angemeldet“ oder „Video angesehen“, um ihre MAU-Zahl zu senken.
Lösung:
Richten Sie Laderegeln ein, um genau zu bestimmen, wann und wo ein Tag auf Ihrer Website geladen wird. Umfassendere Anleitungen zum Filtern von Bot-Traffic und zur bedingten Initialisierung des SDK finden Sie unter Bot-Traffic filtern.
