Erstanbieter-Geräte-IDs im Web SDK

Das Adobe Experience Platform Web SDK weist Website-Besuchern mithilfe von Cookies Adobe Experience Cloud IDs (ECIDs) zu, um das Benutzerverhalten zu verfolgen. Um Browserbeschränkungen für Cookie-Lebenszyklen zu berücksichtigen, können Sie stattdessen Ihre eigenen Geräte-IDs festlegen und verwalten. Diese werden als Erstanbieter-Geräte-IDs (FPIDs) bezeichnet.

In diesem Dokument wird beschrieben, wie Sie Erstanbieter-Geräte-IDs für Ihre Web SDK-Implementierung konfigurieren.

Voraussetzungen

In diesem Handbuch wird davon ausgegangen, dass Sie mit der Funktionsweise von Identitätsdaten für das Platform Web SDK vertraut sind, einschließlich der Rolle von ECIDs und identityMap. Weitere Informationen finden Sie in der Übersicht zu Identitätsdaten im Web SDK .

Verwenden von Erstanbieter-Geräte-IDs (FPIDs) using-fpid

Geräte-IDs von Erstanbietern (FPIDs) verfolgen Besucher anhand von Erstanbieter-Cookies. Erstanbieter-Cookies sind am effektivsten, wenn sie mit einem Server gesetzt werden, der einen DNS-Eintrag A record (für IPv4) oder einen AAAA-Eintrag (für IPv6) verwendet, im Gegensatz zu einem DNS-Code CNAME oder JavaScript.

Sobald ein FPID -Cookie gesetzt ist, kann der zugehörige Wert abgerufen und an Adobe gesendet werden, während Ereignisdaten erfasst werden. Erfasste FPIDs werden als Samen verwendet, um ECIDs zu generieren, die weiterhin die primäre ID in Adobe Experience Cloud-Anwendungen sind.

Um eine FPID für einen Website-Besucher an das Edge Network zu senden, müssen Sie die FPID in die identityMap für diesen Besucher aufnehmen. Weitere Informationen finden Sie im Abschnitt weiter unten in diesem Dokument zu Verwendung von FPIDs in identityMap .

Formatierungsanforderungen für Geräte-IDs von Erstanbietern formatting-requirements

Das Edge Network akzeptiert nur IDs, die dem UUIDv4-Format entsprechen. Geräte-IDs, die nicht im Format UUIDv4 vorliegen, werden abgelehnt.

Die Erstellung eines UUID -Werts führt fast immer zu einer eindeutigen, zufälligen Kennung, wobei die Wahrscheinlichkeit einer Kollision vernachlässigbar ist. UUIDv4 kann nicht mit IP-Adressen oder anderen personenbezogenen Daten (PII) gesendet werden. UUIDs sind allgegenwärtig und es gibt Bibliotheken für praktisch jede Programmiersprache, um sie zu generieren.

Festlegen eines Erstanbieter-ID-Cookies in der Benutzeroberfläche von Datastreams setting-cookie-datastreams

Sie können in der Benutzeroberfläche von Datastreams einen Cookie-Namen angeben, in dem sich die FPID befinden kann, anstatt den Cookie-Wert lesen und die FPID in die Identitätszuordnung aufnehmen zu müssen.

Detaillierte Informationen zum Konfigurieren eines Datenspeichers finden Sie in der Dokumentation zu datastreams .

Aktivieren Sie beim Konfigurieren Ihres Datastreams die Option Erstanbieter-ID-Cookie . Diese Einstellung weist das Edge Network an, beim Suchen einer Erstanbieter-Geräte-ID auf ein bestimmtes Cookie zu verweisen, anstatt diesen Wert in der Identitätszuordnung nachzuschlagen.

Weitere Informationen zur Arbeit mit Adobe Experience Cloud finden Sie in der Dokumentation zu Erstanbieter-Cookies .

Wenn Sie diese Einstellung aktivieren, müssen Sie den Namen des Cookies angeben, in dem die ID gespeichert werden soll.

Wenn Sie Erstanbieter-IDs verwenden, können Sie keine ID-Synchronisierungen von Drittanbietern durchführen. Die ID-Synchronisierungen von Drittanbietern basieren auf dem Visitor ID-Dienst und dem von diesem Dienst generierten UUID. Bei Verwendung der Erstanbieter-ID-Funktion wird ECID ohne Verwendung des Visitor ID-Dienstes generiert, was die Synchronisierung von Drittanbieter-IDs unmöglich macht.

Wenn Sie Erstanbieter-IDs verwenden, werden Audience Manager-Funktionen, die auf die Aktivierung in Partnerplattformen abzielen, nicht unterstützt, da die Audience Manager-Partner-ID-Synchronisierungen hauptsächlich auf UUIDs oder DIDs basieren. Die ECID, die von einer Erstanbieter-ID abgeleitet wird, ist nicht mit einer UUID verknüpft, sodass sie nicht adressierbar ist.

Festlegen eines Cookies mithilfe eines eigenen Servers set-cookie-server

Beim Festlegen eines Cookies mithilfe eines Servers, dessen Eigentümer Sie sind, können Sie verschiedene Methoden verwenden, um zu verhindern, dass das Cookie aufgrund von Browserrichtlinien eingeschränkt wird:

Festlegen des Cookies when-to-set-cookie

Das Cookie FPID sollte idealerweise gesetzt werden, bevor Anforderungen an das Edge Network gesendet werden. In Szenarien, in denen dies nicht möglich ist, wird jedoch weiterhin ein ECID mit vorhandenen Methoden generiert und dient als primäre Kennung, solange das Cookie vorhanden ist.

Wenn die ECID irgendwann von einer Browser-Löschrichtlinie beeinflusst wird, die FPID jedoch nicht, wird die FPID beim nächsten Besuch zur primären Kennung und wird zum Testen der ECID bei jedem nachfolgenden Besuch verwendet.

Festlegen des Ablaufs für das Cookie set-expiration

Das Festlegen des Ablaufs eines Cookies sollte bei der Implementierung der FPID -Funktion sorgfältig berücksichtigt werden. Bei der Entscheidung sollten Sie die Länder oder Regionen berücksichtigen, in denen Ihre Organisation tätig ist, sowie die Gesetze und Richtlinien in jeder dieser Regionen.

Im Rahmen dieser Entscheidung möchten Sie möglicherweise eine unternehmensweite Cookie-Einstellung oder eine Richtlinie festlegen, die für Benutzer in jedem Gebietsschema, in dem Sie tätig sind, unterschiedlich ist.

Unabhängig von der Einstellung, die Sie für den anfänglichen Ablauf eines Cookies auswählen, müssen Sie sicherstellen, dass Sie eine Logik einschließen, die den Ablauf des Cookies bei jedem neuen Besuch der Site verlängert.

Auswirkungen von Cookie-Flags cookie-flag-impact

Es gibt verschiedene Cookie-Flags, die sich auf die Behandlung von Cookies in verschiedenen Browsern auswirken:

HTTPOnly http-only

Auf Cookies, die mit dem Flag HTTPOnly gesetzt wurden, kann nicht mithilfe clientseitiger Skripte zugegriffen werden. Wenn Sie beim Festlegen von FPID eine HTTPOnly -Markierung setzen, müssen Sie also eine serverseitige Skriptsprache verwenden, um den Cookie-Wert zur Aufnahme in identityMap zu lesen.

Wenn Sie sich dafür entscheiden, dass das Edge Network den Wert des FPID -Cookies liest, stellt das Setzen des HTTPOnly -Flags sicher, dass der Wert von keinem clientseitigen Skript aufgerufen wird, jedoch keine negativen Auswirkungen auf die Fähigkeit des Edge Networks, das Cookie zu lesen.

Secure secure

Mit dem Attribut Secure festgelegte Cookies werden nur mit einer verschlüsselten Anfrage über das Protokoll HTTPS an den Server gesendet. Die Verwendung dieses Flag kann dazu beitragen, sicherzustellen, dass man-in-the-Middle-Angreifer nicht einfach auf den Wert des Cookies zugreifen können. Wenn möglich, ist es immer empfehlenswert, das Secure -Flag festzulegen.

SameSite same-site

Mit dem Attribut SameSite können Server bestimmen, ob Cookies mit Site-übergreifenden Anforderungen gesendet werden. Das -Attribut bietet einen gewissen Schutz vor Site-übergreifenden Fälschungsangriffen. Es gibt drei mögliche Werte: Strict, Lax und None. Wenden Sie sich an Ihr internes Team, um zu bestimmen, welche Einstellung für Ihr Unternehmen geeignet ist.

Wenn kein SameSite -Attribut angegeben ist, ist die Standardeinstellung für einige Browser jetzt SameSite=Lax.

Verwenden von FPIDs in identityMap identityMap

Nachfolgend finden Sie ein Beispiel dafür, wie Sie einen FPID im identityMap festlegen:

{
  "identityMap": {
    "FPID": [
      {
        "id": "123e4567-e89b-42d3-9456-426614174000",
        "authenticatedState": "ambiguous",
        "primary": true
      }
    ]
  }
}

Wie bei anderen Identitätstypen können Sie die FPID mit anderen Identitäten in identityMap einbeziehen. Im Folgenden finden Sie ein Beispiel für die FPID, die mit einem authentifizierten CRM ID enthalten ist:

{
  "identityMap": {
    "FPID": [
      {
        "id": "123e4567-e89b-42d3-9456-426614174000",
        "authenticatedState": "ambiguous",
        "primary": false
      }
    ],
    "EMAIL": [
      {
        "id": "email@mail.com",
        "authenticatedState": "authenticated",
        "primary": true
      }
    ]
  }
}

Wenn der FPID in einem Cookie enthalten ist, das vom Edge Network gelesen wird, wenn die Erstanbieter-Datenerfassung aktiviert ist, sollten Sie nur den authentifizierten CRM ID erfassen:

{
  "identityMap": {
    "EMAIL": [
      {
        "id": "email@mail.com",
        "authenticatedState": "authenticated",
        "primary": true
      }
    ]
  }
}

Die folgende identityMap würde zu einer Fehlerantwort des Edge Networks führen, da die primary -Anzeige für die FPID fehlt. Mindestens eine der in identityMap vorhandenen IDs muss als primary markiert sein.

{
  "identityMap": {
    "FPID": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "authenticatedState": "ambiguous"
      }
    ],
    "EMAIL": [
      {
        "id": "email@mail.com",
        "authenticatedState": "authenticated"
      }
    ]
  }
}

Die vom Edge Network zurückgegebene Fehlerantwort ähnelt in diesem Fall der folgenden:

{
    "type": "https://ns.adobe.com/aep/errors/EXEG-0306-400",
    "status": 400,
    "title": "No primary identity set in request (event)",
    "detail": "No primary identity found in the input event. Update the request accordingly to your schema and try again.",
    "report": {
        "requestId": "{REQUEST_ID}",
        "configId": "{CONFIG_ID}",
        "orgId": "{ORG_ID}"
    }
}

Festlegen einer FPID in Ihrer eigenen Domäne setting-fpid-domain

Zusätzlich zum Festlegen von FPID in der Identitätszuordnung können Sie das FPID -Cookie in Ihrer eigenen Domäne setzen, wenn Sie eine Erstanbieter-Datenerfassung CNAME konfiguriert haben.

Wenn die Erstanbieter-Datenerfassung mit dem Wert "CNAME"aktiviert wird, werden alle Cookies für Ihre Domäne auf Anforderungen gesendet, die an den Datenerfassungsendpunkt gesendet werden.

Alle Cookies, die für die Datenerfassung in Adobe nicht relevant sind, werden gelöscht. Für FPID können Sie den Namen des FPID -Cookies in der Datastream-Konfiguration angeben. Wenn Sie dies tun, liest das Edge Network den Inhalt des Cookies FPID, anstatt nach dem Wert FPID in der Identitätszuordnung zu suchen.

Um diese Funktion verwenden zu können, müssen Sie die FPID auf der obersten Ebene Ihrer Domäne und nicht auf eine bestimmte Subdomäne festlegen. Wenn Sie ihn für eine Subdomäne festlegen, wird der Cookie-Wert nicht an das Edge Network gesendet und die FPID -Lösung funktioniert nicht wie gewünscht.

ID-Hierarchie id-hierarchy

Wenn sowohl ECID als auch FPID vorhanden sind, wird die ECID bei der Identifizierung des Benutzers priorisiert. Dadurch wird sichergestellt, dass ein vorhandener ECID-Wert im Browser-Cookie-Store weiterhin die primäre Kennung bleibt und die vorhandenen Besucherzahlen keine Auswirkungen haben. Für bestehende Benutzer wird der FPID erst dann zur primären Identität, wenn der ECID abläuft oder infolge einer Browserrichtlinie oder eines manuellen Prozesses gelöscht wird.

Identitäten werden in der folgenden Reihenfolge priorisiert:

Migration zu Erstanbieter-Geräte-IDs migrating-to-fpid

Wenn Sie von einer früheren Implementierung zu Erstanbieter-Geräte-IDs migrieren, ist es möglicherweise schwierig, sich vorzustellen, wie die Transition auf einer niedrigen Ebene aussehen könnte.

Zur Veranschaulichung dieses Vorgangs sollten Sie sich ein Szenario ansehen, an dem ein Kunde beteiligt ist, der Ihre Site bereits besucht hat, und welche Auswirkungen eine Migration von FPID auf die Identifizierung dieses Kunden in Adobe-Lösungen haben würde.

Häufig gestellte Fragen faq

Im Folgenden finden Sie eine Liste von Antworten auf häufig gestellte Fragen zu Erstanbieter-Geräte-IDs.

Inwiefern unterscheidet sich das Senden einer ID vom bloßen Generieren einer ID?

Das Sitzungskonzept ist insofern einzigartig, als die an Adobe Experience Cloud übergebenen FPID mithilfe eines deterministischen Algorithmus in eine ECID umgewandelt werden. Jedes Mal, wenn derselbe FPID an das Edge Network gesendet wird, wird derselbe ECID von den FPID sediert.

Wann sollte die Erstanbieter-Geräte-ID generiert werden?

Um die potenzielle Besucherinflation zu reduzieren, sollte der FPID generiert werden, bevor Sie Ihre erste Anfrage mit dem Web SDK stellen. Wenn Sie dies jedoch nicht tun können, wird für diesen Benutzer weiterhin ein ECID generiert und als primäre Kennung verwendet. Die FPID, die generiert wurde, wird erst dann zur primären Kennung, wenn die ECID nicht mehr vorhanden ist.

Welche Datenerfassungsmethoden unterstützen Erstanbieter-Geräte-IDs?

Derzeit unterstützt nur das Web SDK Erstanbieter-Geräte-IDs.

Werden Erstanbieter-Geräte-IDs in Platform- oder Experience Cloud-Lösungen gespeichert?

Sobald die FPID zum Testen eines ECID verwendet wurde, wird sie aus dem identityMap entfernt und durch den generierten ECID ersetzt. Der FPID wird nicht in Adobe Experience Platform- oder Experience Cloud-Lösungen gespeichert.