Adobe Experience Platform Identity Service hinzufügen
Diese Lektion führt Sie durch die Schritte, die zur Implementierung der Adobe Experience Platform Identity Service-Erweiterung und zum Senden von Kunden-IDs erforderlich sind.
Der Adobe Experience Platform Identity-Dienst legt eine gemeinsame Besucher-ID für alle Adobe-Lösungen fest, um Experience Cloud-Funktionen wie die Freigabe von Zielgruppen zwischen-Lösungen zu unterstützen. Sie können auch eigene Kunden-IDs an den Service senden, um geräteübergreifendes Targeting und die Integration in Ihr CRM (Customer Relationship Management)-System zu ermöglichen.
- Platform launch (Client-seitig) ist jetzt tags
- Platform launch Server Side ist jetzt event forwarding
- Edge-Konfigurationen sind jetzt datastreams
Lernziele
Am Ende dieser Lektion können Sie:
- Identity Service-Erweiterung hinzufügen
- ein Datenelement zur Erfassung Ihrer Kunden-IDs erstellen
- eine Regel erstellen, die die Aktion „Kunden-IDs festlegen“ verwendet, um die Kunden-IDs an Adobe zu senden
- die Sortierreihenfolge für Regeln verwenden, die beim selben Ereignis ausgelöst werden
Voraussetzungen
Sie sollten die Lektionen im Abschnitt Tags konfigurieren bereits abgeschlossen haben.
Identity Service-Erweiterung hinzufügen
Da dies die erste Erweiterung ist, die Sie hinzufügen, hier eine kurze Übersicht über Erweiterungen. Erweiterungen sind eine der Kernfunktionen von Tags. Eine Erweiterung ist eine Integration, die von Adobe, einem Adobe-Partner oder einem Adobe-Kunden erstellt wurde und zahllose neue Optionen für die Tags bietet, die Sie auf Ihren Websites bereitstellen können. Wenn Sie sich Tags als Betriebssystem vorstellen, sind Erweiterungen die Apps, die Sie installieren, damit Tags die Dinge tun können, die Sie benötigen.
Hinzufügen der Identity Service-Erweiterung
-
Klicken Sie im linken Navigationsbereich auf Erweiterungen .
-
Klicken Sie auf Katalog , um zur Seite "Erweiterungskatalog"zu wechseln.
-
Beachten Sie die verschiedenen Erweiterungen, die im Katalog verfügbar sind.
-
Geben Sie oben im Filter „id“ ein, um den Katalog zu filtern.
-
Klicken Sie auf der Karte für den Adobe Experience Platform Identity-Dienst auf Installieren .
-
Beachten Sie, dass Ihre Experience Cloud-Organisations-ID automatisch erkannt wird.
-
Behalten Sie alle Standardeinstellungen bei und klicken Sie auf In Bibliothek speichern und erstellen
Überprüfen der Erweiterung
Die Identity Service-Erweiterung ist eine der wenigen Tag-Erweiterungen, die Anfragen senden, ohne eine Regelaktion verwenden zu müssen. Die Erweiterung sendet beim ersten Seitenladevorgang des ersten Besuchs einer Website automatisch eine Anforderung an den Identity Service. Sobald die ID angefordert wurde, wird sie in einem Erstanbieter-Cookie gespeichert, das mit „AMCV_“ beginnt.
Überprüfen der Identity Service-Erweiterung
-
Öffnen Sie die Site „Luma“.
-
Stellen Sie sicher, dass der Debugger die Tag-Eigenschaft Ihrer Entwicklungsumgebung zuordnet, wie in der früheren Lektion beschrieben.
-
Auf der Registerkarte "Zusammenfassung"des Debuggers sollte der Abschnitt "Tags"angeben, dass die Adobe Experience Platform Identity Service-Erweiterung implementiert ist.
-
Außerdem sollte auf der Registerkarte "Zusammenfassung"im Abschnitt "Identity Service"dieselbe Organisations-ID angezeigt werden, die sich auf dem Erweiterungskonfigurationsbildschirm in der Datenerfassungsoberfläche befand:
-
Die erste Anforderung zum Abrufen der Besucher-ID wird möglicherweise auf der Registerkarte „Identity Service“ des Debuggers angezeigt. Sie wurde jedoch möglicherweise bereits angefordert; wenn sie also nicht angezeigt wird, ist dies kein Grund zur Sorge:
-
Nach der ersten Anforderung zum Abrufen der Besucher-ID wird die ID in einem Cookie gespeichert, dessen Name mit
AMCV_
beginnt. Sie können bestätigen, dass das Cookie festgelegt wurde, indem Sie wie folgt vorgehen:-
Öffnen Sie die Entwicklertools Ihres Browsers.
-
Navigieren Sie zur Registerkarte
Application
. -
Erweitern Sie „
Cookies
“ auf der linken Seite. -
Klicken Sie auf die Domain
https://luma.enablementadobe.com
. -
Suchen Sie auf der rechten Seite nach dem „AMCV_“-Cookie. Möglicherweise gibt es mehrere Fälle, in denen die Site "Luma"sowohl mit der fest codierten Tag-Eigenschaft als auch mit Ihrer eigenen geladen wurde.
-
Das ist alles! Sie haben Ihre erste Erweiterung hinzugefügt! Weitere Informationen zu den Konfigurationsoptionen des Identity Service finden Sie in der Dokumentation.
Senden von Kunden-IDs
Als Nächstes senden Sie eine Kunden-ID an den Identity Service. Dadurch können Sie Ihr CRM in Experience Cloud integrieren und Besucher geräteübergreifend verfolgen.
In der früheren Lektion Hinzufügen von Datenelementen, Regeln und Bibliotheken haben Sie ein Datenelement erstellt und in einer Regel verwendet. Jetzt werden Sie dieselben Methoden verwenden, um eine Kunden-ID zu senden, wenn der Besucher authentifiziert wird.
Erstellen von Datenelementen für Kunden-IDs
Erstellen Sie zunächst zwei Datenelemente:
Authentication State
zur Erfassung, ob der Besucher angemeldet ist oder nicht.Email (Hashed)
erfasst die gehashte Version der E-Mail-Adresse (als Kunden-ID verwendet) aus dem Daten-Layer.
Erstellen des Datenelements für den Authentifizierungsstatus
-
Klicken Sie im linken Navigationsbereich auf Datenelemente .
-
Klicken Sie auf die Schaltfläche Datenelement hinzufügen .
-
Benennen Sie das Datenelement
Authentication State
. -
Wählen Sie für den Datenelementtyp Benutzerdefinierter Code aus.
-
Klicken Sie auf die Schaltfläche Editor öffnen .
-
Verwenden Sie im Fenster Code bearbeiten den folgenden Code, um die Werte „angemeldet“ oder „abgemeldet“ basierend auf einem Attribut im Daten-Layer der Site „Luma“ zurückzugeben:
code language-javascript if (digitalData.user[0].profile[0].attributes.loggedIn) return "logged in" else return "logged out"
-
Klicken Sie auf Speichern , um den benutzerspezifischen Code zu speichern.
-
Behalten Sie bei allen anderen Einstellungen die Standardwerte bei.
-
Klicken Sie auf In Bibliothek speichern , um das Datenelement zu speichern und zur Seite mit den Datenelementen zurückzukehren. Wir müssen erst dann einen "Build"erstellen, wenn wir alle Änderungen vorgenommen haben und bereit sind zu validieren.
Indem Sie den Authentifizierungsstatus des Benutzers kennen, wissen Sie, wann eine Kunden-ID auf der Seite vorhanden sein sollte, die an den Identity Service gesendet werden kann. Der nächste Schritt besteht darin, ein Datenelement für die Kunden-ID selbst zu erstellen. Auf der Demosite „Luma“ verwenden Sie die gehashte Version der E-Mail-Adresse des Besuchers.
Hinzufügen des Datenelements für die gehashte-E-Mail
-
Klicken Sie auf die Schaltfläche Datenelement hinzufügen .
-
Benennen Sie das Datenelement
Email (Hashed)
. -
Wählen Sie für den Datenelementtyp JavaScript-Variable aus.
-
Verwenden Sie als JavaScript-Variablennamen den folgenden Zeiger auf eine Variable im Datenschicht der Site "Luma":
digitalData.user.0.profile.0.attributes.username
-
Behalten Sie bei allen anderen Einstellungen die Standardwerte bei.
-
Klicken Sie auf In Bibliothek speichern , um das Datenelement zu speichern.
Hinzufügen einer Regel zum Senden der Kunden-IDs
Adobe Experience Platform Identity Service übergibt die Kunden-IDs in Regeln mit der Aktion „Festlegen von Kunden-IDs“. Erstellen Sie nun eine Regel, die diese Aktion auslöst, wenn der Besucher authentifiziert wird.
Hinzufügen einer Regel zum Senden der Kunden-IDs
-
Klicken Sie im linken Navigationsbereich auf Regeln .
-
Klicken Sie auf Regel hinzufügen , um den Regel-Builder zu öffnen.
-
Geben Sie einen Namen für die Regel ein
All Pages - Library Loaded - Authenticated - 10
.note tip TIP Diese Namenskonvention gibt an, dass Sie diese Regel oben auf allen Seiten auslösen, wenn der Benutzer authentifiziert wird, und dass die Reihenfolge "10"lautet. Die Verwendung einer Namenskonvention wie dieser – anstatt sie für die in den Aktionen ausgelösten Lösungen zu benennen – ermöglicht es Ihnen, die Gesamtzahl der von Ihrer Implementierung benötigten Regeln zu minimieren. -
Klicken Sie unter Ereignisse auf Hinzufügen .
- Wählen Sie für den Ereignistyp Bibliothek geladen (Seitenanfang) aus.
- Erweitern Sie den Abschnitt Erweiterte Optionen und geben Sie für die Reihenfolge den Wert
10
ein. Hiermit steuern Sie die Reihenfolge von Regeln, die durch dasselbe Ereignis ausgelöst werden. Regeln mit einer niedrigeren Zahl werden vor Regeln mit einer höheren Zahl ausgelöst. In diesem Fall möchten Sie die Kunden-ID festlegen, bevor Sie die Target-Anforderung auslösen. Dies wird in der nächsten Lektion behandelt – mit einer Regel mit der Reihenfolge50
. - Klicken Sie auf die Schaltfläche Änderungen beibehalten , um zum Regel-Builder zurückzukehren.
-
Klicken Sie unter Bedingungen auf Hinzufügen .
-
Wählen Sie für den Bedingungstyp Wertvergleich aus.
-
Klicken Sie auf das Symbol , um das Datenelement-Modal zu öffnen.
-
Klicken Sie im Datenelement-Modal auf Authentifizierungsstatus und dann auf Auswählen
-
-
Stellen Sie sicher, dass der Operator
Equals
lautet. -
Geben Sie im Textfeld „Angemeldet“ ein, wodurch die Regel ausgelöst wird, sobald das Datenelement „Authentifizierungsstatus“ den Wert „Angemeldet“ aufweist.
-
Klicken Sie auf Änderungen beibehalten
-
Klicken Sie unter Aktionen auf Hinzufügen .
-
Wählen Sie für die Erweiterung Experience Cloud ID-Dienst aus.
-
Wählen Sie für den Aktionstyp 1 Kunden-IDs festlegen aus.
-
Geben Sie für den Integrationscode
crm_id
ein. -
Geben Sie für den Wert das Datenelement-Selektor-Modal ein und wählen Sie den Wert
Email (Hashed)
-
Wählen Sie für den Authentifizierungsstatus Authentifiziert aus.
-
Klicken Sie auf die Schaltfläche Änderungen beibehalten , um die Aktion zu speichern und zum Regel-Builder zurückzukehren.
-
-
Klicken Sie auf die Schaltfläche In Bibliothek speichern und erstellen , um die Regel zu speichern.
Sie haben jetzt eine Regel erstellt, die die Kunden-ID als crm_id
-Variable sendet, wenn der Besucher authentifiziert wird. Da Sie die Reihenfolge als 10
angegeben haben, wird diese Regel vor der All Pages - Library Loaded
-Regel ausgelöst, die Sie in der Lektion Hinzufügen von Datenelementen, Regeln und Bibliotheken erstellt haben, die den standardmäßigen Reihenfolgenwert von 50
hat.
Überprüfen der Kunden-IDs
Um Ihre Arbeit zu überprüfen, melden Sie sich bei der Site „Luma“ an, um das Verhalten der neuen Regel zu bestätigen.
Anmelden bei der Site „Luma“
-
Öffnen Sie die Site „Luma“.
-
Stellen Sie sicher, dass der Debugger die Tag-Eigenschaft Ihrer Entwicklungsumgebung zuordnet, wie in der früheren Lektion beschrieben.
-
Klicken Sie oben rechts auf der Site "Luma"auf den Link ANMELDEN .
-
Geben Sie
test@adobe.com
als Benutzernamen ein. -
Geben Sie
test
als Passwort ein. -
Klicken Sie auf die Schaltfläche ANMELDEN
-
Kehren Sie zur Startseite zurück.
Bestätigen Sie als Nächstes mithilfe des Dienstes, dass die Kunden-ID an die Debugger-Erweiterung gesendet wird.
Überprüfen, ob der Identity Service die Kunden-ID weitergibt
-
Stellen Sie sicher, dass die Registerkarte mit der Site „Luma“ im Fokus ist.
-
Wechseln Sie im Debugger zur Registerkarte „Adobe Experience Platform Identity Service“.
-
Erweitern Sie die Organisations-ID.
-
Klicken Sie auf die Zelle mit dem Wert
Customer ID - crm_id
. -
Im Modal werden der Wert der Kunden-ID sowie der Status
AUTHENTICATED
angezeigt: -
Beachten Sie, dass Sie den gehashten E-Mail-Wert bestätigen können, indem Sie den Quellcode der Seite „Luma“ anzeigen und sich die Benutzernamen-Eigenschaft ansehen. Diese sollte mit dem Wert übereinstimmen, der Ihnen im Debugger angezeigt wird:
Weitere Tipps zur Überprüfung
Tags verfügen auch über umfassende Protokollierungsfunktionen. Um sie zu aktivieren, wechseln Sie zur Registerkarte Tools im Debugger und aktivieren Sie den Umschalter Tags-Konsolenprotokollierung .
Hierdurch wird die Konsolenprotokollierung aktiviert – sowohl in Ihrer Browserkonsole als auch auf der Registerkarte „Protokolle“ im Debugger. Die Protokollierung aller bisher erstellten Regeln sollte angezeigt werden! Beachten Sie, dass neue Protokolleinträge oben in der Liste hinzugefügt werden, sodass Ihre Regel „Alle Seiten – Bibliothek geladen – Authentifiziert – 10“ vor der Regel „Alle Seiten – Bibliothek geladen“ ausgelöst und unten in der Konsolenprotokollierung des Debuggers angezeigt wird:
Weiter mit "Adobe Target hinzufügen">