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 Service legt eine gemeinsame Besucher-ID für alle Adobe-Lösungen fest, um Experience Cloud-Funktionen wie die gemeinsame Nutzung von Audiences zwischen Lösungen zu ermöglichen. 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 mehrere 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 bereits im Abschnitt Konfigurieren von Tags 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 tun müssen.

Hinzufügen der Identity Service-Erweiterung

  1. Klicken Sie in der linken Navigation auf Erweiterungen

  2. Klicken Sie 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 Service auf Installieren

    Installieren der Identity Service-Erweiterung

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

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

    Speichern der Erweiterung

NOTE
Jede Version der Identity Service-Erweiterung enthält eine bestimmte Version von VisitorAPI.js, die in der Beschreibung der Erweiterung aufgeführt 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 eine Anfrage stellt, 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 Ihre zuordnet, wie in der Lektion.

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

  4. Außerdem sollte der Abschnitt Identity Service auf der Registerkarte Zusammenfassung mit derselben Organisations-ID ausgefüllt werden, die sich auf dem Konfigurationsbildschirm Ihrer Erweiterung in der Datenerfassungs-Oberflä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 sehen Sie mehrere , seit Sie die Luma-Site geladen haben, indem Sie sowohl ihre hartcodierte Tag-Eigenschaft als auch ihre eigene Eigenschaft zugeordnet haben.

      Ü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 linken Navigationsbereich auf Datenelemente“

  2. Klicken Sie auf Schaltfläche „Datenelement"

    Klicken Sie auf „Datenelement hinzufüge“

  3. Benennen Sie das Datenelement Authentication State.

  4. Wählen Sie für Datenelementtyp die Option Benutzerdefinierter Code

  5. Klicken Sie auf 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 Speichern, um den benutzerdefinierten Code zu speichern

    Speichern Sie den benutzerspezifischen Code

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

  9. Klicken Sie In Bibliothek speichern, um das Datenelement zu speichern und zur Seite „Datenelemente“ zurückzukehren. Wir müssen erst dann einen Build erstellen, wenn wir alle unsere Änderungen vorgenommen haben und bereit zur Validierung sind.

    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 Schaltfläche „Datenelement"

    Datenelemente hinzuzufügen

  2. Benennen Sie das Datenelement Email (Hashed).

  3. Wählen Sie für Datenelementtyp die Option JavaScript-Variable

  4. Verwenden Sie als JavaScript Variablennamen den folgenden Zeiger auf eine Variable in der Datenschicht der Luma-Site: 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 in der linken Navigation auf Regeln

  2. Klicken Sie 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 ist, und sie hat die Reihenfolge „10“. 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 unter "" auf Hinzufügen

    Ereignis hinzufügen

    1. Wählen Sie für Ereignistyp die Option Bibliothek geladen (Seitenanfang)
    2. Erweitern Sie den Abschnitt Erweiterte Optionen und geben Sie für Bestellung den 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 Änderungen beibehalten, um zum Regel-Builder zurückzukehren

    Ereignis speichern

  5. Klicken unter „Bedingungen auf Hinzufügen

    Eine Bedingung zur Regel hinzufügen

    1. Wählen Sie für Bedingungstyp die Option Wertevergleich

    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 Änderungen beibehalten

    Bedingung speichern

  9. Klicken Sie unter Aktionen auf Hinzufügen

    Hinzufügen einer neuen Aktion

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

    2. Wählen Sie für Aktionstyp die Option Kunden-IDs festlegen

    3. Für den Integrationscode geben Sie crm_id

    4. Geben als Wert“ das Modal „Datenelementauswahl öffnen“ ein und wählen Sie die Email (Hashed) aus

    5. Wählen Sie für Authentifizierungsstatus die Option Authentifiziert

    6. Klicken Sie auf Ä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 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 Ihre zuordnet, wie in der Lektion beschrieben

    Die Tag-Entwicklungsumgebung wird im Debugger angezeigt

  3. Klicken Sie auf Link ANMELDEN“ in der oberen rechten Ecke der Luma-Site

    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 ANMELDEN-Schaltfläche

    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ügt außerdem über umfangreiche Konsolenprotokollierungsfunktionen. Um sie zu aktivieren, wechseln Sie zur Registerkarte Tools im Debugger und aktivieren Sie den Umschalter Protokollierung in der Tag-Konsole.

Konsolenprotokollierung für Tags ein/aus

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 "Adobe Target hinzufügen“ >

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