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.

NOTE
Adobe Experience Platform Launch wird als eine Suite von Datenerfassungstechnologien in Adobe Experience Platform integriert. In der Benutzeroberfläche wurden verschiedene terminologische Änderungen eingeführt, die Sie bei der Verwendung dieses Inhalts beachten sollten:

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

  1. Klicken Sie im linken Navigationsbereich auf Erweiterungen .

  2. Klicken Sie auf Katalog , um zur Seite "Erweiterungskatalog"zu wechseln.

  3. Beachten Sie die verschiedenen Erweiterungen, die im Katalog verfügbar sind.

  4. Geben Sie oben im Filter „id“ ein, um den Katalog zu filtern.

  5. Klicken Sie auf der Karte für den Adobe Experience Platform Identity-Dienst auf Installieren .

    Installieren der Identity Service-Erweiterung

  6. Beachten Sie, dass Ihre Experience Cloud-Organisations-ID automatisch erkannt wird.

  7. Behalten Sie alle Standardeinstellungen bei und klicken Sie auf In Bibliothek speichern und erstellen

    Speichern der Erweiterung

NOTE
Jede Version der Identity Service-Erweiterung enthält eine spezifische Version von VisitorAPI.js, die in der Erweiterungsbeschreibung vermerkt ist. Sie aktualisieren die VisitorAPI.js-Version, indem Sie die Identity Service-Erweiterung aktualisieren.

Ü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

  1. Öffnen Sie die Site „Luma“.

  2. Stellen Sie sicher, dass der Debugger die Tag-Eigenschaft Ihrer Entwicklungsumgebung zuordnet, wie in der früheren Lektion beschrieben.

  3. Auf der Registerkarte "Zusammenfassung"des Debuggers sollte der Abschnitt "Tags"angeben, dass die Adobe Experience Platform Identity Service-Erweiterung implementiert ist.

  4. 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:

    Überprüfen, ob die Adobe Experience Platform Identity Service-Erweiterung implementiert ist

  5. 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:
    Überprüfen, ob eine Anforderung an den Identity Service mit Ihrer Organisations-ID vorhanden ist

  6. 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:

    1. Öffnen Sie die Entwicklertools Ihres Browsers.

    2. Navigieren Sie zur Registerkarte Application.

    3. Erweitern Sie „Cookies“ auf der linken Seite.

    4. Klicken Sie auf die Domain https://luma.enablementadobe.com.

    5. 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.

      Überprüfen des „AMCV_“-Cookies

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:

  1. Authentication State zur Erfassung, ob der Besucher angemeldet ist oder nicht.
  2. 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

  1. Klicken Sie im linken Navigationsbereich auf Datenelemente .

  2. Klicken Sie auf die Schaltfläche Datenelement hinzufügen .

    Klicken Sie auf „Datenelement hinzufüge“

  3. Benennen Sie das Datenelement Authentication State.

  4. Wählen Sie für den Datenelementtyp Benutzerdefinierter Code aus.

  5. Klicken Sie auf die Schaltfläche Editor öffnen .

    Öffnen Sie den Editor, um den benutzerdefinierten Code für das Datenelement hinzuzufügen

  6. 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"
    
  7. Klicken Sie auf Speichern , um den benutzerspezifischen Code zu speichern.

    Speichern Sie den benutzerspezifischen Code

  8. Behalten Sie bei allen anderen Einstellungen die Standardwerte bei.

  9. 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.

    Speichern Sie das Datenelement

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

  1. Klicken Sie auf die Schaltfläche Datenelement hinzufügen .

    Datenelemente hinzuzufügen

  2. Benennen Sie das Datenelement Email (Hashed).

  3. Wählen Sie für den Datenelementtyp JavaScript-Variable aus.

  4. Verwenden Sie als JavaScript-Variablennamen den folgenden Zeiger auf eine Variable im Datenschicht der Site "Luma": digitalData.user.0.profile.0.attributes.username

  5. Behalten Sie bei allen anderen Einstellungen die Standardwerte bei.

  6. Klicken Sie auf In Bibliothek speichern , um das Datenelement zu speichern.

    Speichern Sie das Datenelement

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

  1. Klicken Sie im linken Navigationsbereich auf Regeln .

  2. Klicken Sie auf Regel hinzufügen , um den Regel-Builder zu öffnen.

    Eine Regel hinzufügen

  3. 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.
  4. Klicken Sie unter Ereignisse auf Hinzufügen .

    Ereignis hinzufügen

    1. Wählen Sie für den Ereignistyp Bibliothek geladen (Seitenanfang) aus.
    2. 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 Reihenfolge 50.
    3. Klicken Sie auf die Schaltfläche Änderungen beibehalten , um zum Regel-Builder zurückzukehren.

    Ereignis speichern

  5. Klicken Sie unter Bedingungen auf Hinzufügen .

    Eine Bedingung zur Regel hinzufügen

    1. Wählen Sie für den Bedingungstyp Wertvergleich aus.

    2. Klicken Sie auf das Symbol Datenelementsymbol , um das Datenelement-Modal zu öffnen.

      Datenelement-Modal öffnen

    3. Klicken Sie im Datenelement-Modal auf Authentifizierungsstatus und dann auf Auswählen

      Authentifizierungsstatus festlegen

  6. Stellen Sie sicher, dass der Operator Equals lautet.

  7. Geben Sie im Textfeld „Angemeldet“ ein, wodurch die Regel ausgelöst wird, sobald das Datenelement „Authentifizierungsstatus“ den Wert „Angemeldet“ aufweist.

  8. Klicken Sie auf Änderungen beibehalten

    Bedingung speichern

  9. Klicken Sie unter Aktionen auf Hinzufügen .

    Hinzufügen einer neuen Aktion

    1. Wählen Sie für die Erweiterung Experience Cloud ID-Dienst aus.

    2. Wählen Sie für den Aktionstyp 1 Kunden-IDs festlegen aus.

    3. Geben Sie für den Integrationscode crm_id ein.

    4. Geben Sie für den Wert das Datenelement-Selektor-Modal ein und wählen Sie den Wert Email (Hashed)

    5. Wählen Sie für den Authentifizierungsstatus Authentifiziert aus.

    6. Klicken Sie auf die Schaltfläche Änderungen beibehalten , um die Aktion zu speichern und zum Regel-Builder zurückzukehren.

      Konfigurieren Sie die Aktion und speichern Sie die Änderungen

  10. Klicken Sie auf die Schaltfläche In Bibliothek speichern und erstellen , um die Regel zu speichern.

    Speichern Sie die Regel

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“

  1. Öffnen Sie die Site „Luma“.

  2. Stellen Sie sicher, dass der Debugger die Tag-Eigenschaft Ihrer Entwicklungsumgebung zuordnet, wie in der früheren Lektion beschrieben.

    Ihre Tags-Entwicklungsumgebung wird im Debugger angezeigt

  3. Klicken Sie oben rechts auf der Site "Luma"auf den Link ANMELDEN .

    Klicken Sie in der oberen Navigation auf „Anmelden“

  4. Geben Sie test@adobe.com als Benutzernamen ein.

  5. Geben Sie test als Passwort ein.

  6. Klicken Sie auf die Schaltfläche ANMELDEN

    Anmeldedaten eingeben und auf „Anmelden“ klicken

  7. 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

  1. Stellen Sie sicher, dass die Registerkarte mit der Site „Luma“ im Fokus ist.

  2. Wechseln Sie im Debugger zur Registerkarte „Adobe Experience Platform Identity Service“.

  3. Erweitern Sie die Organisations-ID.

  4. Klicken Sie auf die Zelle mit dem Wert Customer ID - crm_id.

  5. Im Modal werden der Wert der Kunden-ID sowie der Status AUTHENTICATED angezeigt:

    Kunden-ID im Debugger bestätigen

  6. 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:

    Gehashte E-Mail im Quellcode

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 .

Umschalten auf die Konsolenprotokollierung von Tags

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:

Registerkarte „Protokolle“ des Debuggers

Weiter mit "Adobe Target hinzufügen">

recommendation-more-help
45774420-d03e-4a6b-94b5-cd639ae825b2