Declared IDs declared-ids

Funktionsweisedeclared IDs Einrichtung von Prozeduren, Code-Beispielen und Variablen.

Declared ID Zielsetzung declared-id-targeting

Austausch und Synchronisierung von Benutzer-IDs mit Audience Manager von Geräten oder Browsern, die keine persistenten Speichermechanismen wie cookies von Drittanbietern verwenden oder akzeptieren.

Zweck des Declared ID Targeting declared-id-targeting-purpose

Einige Browser und die meisten Mobilgeräte akzeptieren keine cookies von Drittanbietern. Dies erschwert die Speicherung von Informationen über Site-Besucher oder die Zuweisung persistenter IDs. Um dieses Problem zu beheben, verwendet Audience Manager DIL, damit Sie bei einem Ereignisaufruf declared IDs übergeben können. Außerdem kann ein declared ID als universelle ID agieren, die für denselben Benutzer für alle Lösungen in der Experience Cloud gilt. Die folgende Tabelle beschreibt den Prozess zum Targeting von IDs/Abgleich:

Zu Beginn müssen Sie den Experience Cloud-ID-Service konfigurieren und die Seiten auf Ihrer Site DIL, die Sie für die Datenerfassung verwenden möchten. Siehe DIL erstellen und Declared ID Variables.

Opt-out-Aufrufe opt-out-calls

Der declared ID berücksichtigt die Präferenzen der Site-Besucher, die sich vom Targeting Audience Manager Ihrer Website abmelden möchten. Wenn Audience Manager eine Opt-out-Anfrage erhält, enthält die vom DCS zurückgegebene JSON den Fehlercode 171 mit der Encountered opt out tag Nachricht anstelle der Audience Manager Benutzer-ID.

Weitere zum Opt-out von der Datenerfassung findenunter „Datenschutz“.

Beispiele für Declared ID Opt-out opt-out-examples

Mit den Schlüssel-Wert-Paaren d_cid und d_cid_ic können Sie declared ID Anfragen zum Opt-out stellen. Die veralten Parameter wie d_dpid und d_dpuuid funktionieren weiterhin, werden jedoch als veraltet betrachtet. Siehe CID ersetzt DPID und DPUUID. In den Beispielen werden Variablenplatzhalter kursiv angegeben.

Opt-outs mit CID und CID_IC

Eine Beschreibung und Syntax finden Sie unter URL-Variablen und -Syntax für deklarierte IDs.

Opt-outs mit DPID, DPUUID und UUID (veraltet)

Diese Methoden funktionieren weiterhin, gelten aber als veraltet. Diese Informationen werden zu Legacy-Zwecken und als Referenz bereitgestellt. Zu den Legacy-Opt-outs gehören:

Variablen und Syntax für Declared IDs variables-and-syntax

In der folgenden Tabelle sind die Schlüssel-Wert-Paare aufgeführt, die bei Verwendung Ihre Audience Manager-Datenanbieter-ID sowie Benutzer-IDs oder Integrations-Codes übergeben. Hinweis: Kursiv gibt einen Variablenplatzhalter an. Es wurden Leerzeichen hinzugefügt, um die Lesbarkeit zu verbessern.

In jedem Schlüssel-Wert-Paar:

Beispiele für Ereignisaufrufe sample-event-calls

Angesichts dieser Schlüssel-Wert-Paare und ihrer erforderlichen Syntax würden Sie wie unten dargestellt Ereignisaufrufe durchführen.

Declared ID Variablen declared-id-variables

Beschreibt die Konfigurationsvariablen, mit denen declared IDs über DIL an Audience Manager. weitergeleitet werden

DIL verwendet die Adobe Experience Platform Identity Service, um Declared IDs zu übergeben dil-id-service-pass-declared-ids

Bei Verwendung mit dem Adobe Experience Platform Identity Service müssen Sie keine declared IDs mit den veralteten dpid- und dpuuid-Variablen mehr übergeben. Stattdessen verwenden die aktuellen Versionen von DIL die Funktion visitorService , um die declared IDs aus der Funktion setCustomerIDs in der Adobe Experience Platform Identity Service abzurufen. Weitere Informationen finden Sie unter Kunden-IDs und Authentifizierungsstatus. Sie würden visitorService wie unten dargestellt in DIL.create aufrufen.

var vDil = DIL.create({
  partner:"partner name",
  visitorService:{
    namespace:"INSERT-MCORG-ID-HERE"
  }
});

Im namespace Schlüssel-Wert-Paar ist MCORG Ihre Experience Cloud Organisations-ID. Wenn Sie diese ID nicht haben, finden Sie sie im Abschnitt Administration des Experience Cloud-Dashboards. Sie benötigen Administratorberechtigungen, um dieses Dashboard anzeigen zu können. Siehe Administration: Zentrale Dienste.

Veraltete Funktionen deprecated-functions

Bei den neuesten Versionen von DIL (6.2+) müssen Sie diese Schlüssel-Wert-Paare nicht verwenden, um declared IDs zu übergeben. Dies liegt daran, dass DIL jetzt auf die im obigen Codebeispiel dargestellte visitorService angewiesen ist. Diese Funktion wird aus der Adobe Experience Platform Identity Service declared IDs. Wir verweisen hier jedoch aus historischen und Legacy-Gründen auf diese Variablen. Im folgenden Code finden Sie ein Beispiel dafür, wie Sie DIL.create konfigurieren, um eine declared ID aus dem Visitor ID Service abzurufen.
In der folgenden Tabelle werden die Legacy-Variablen beschrieben, die vom declaredId-Objekt verwendet werden:

DPID und DPUUID

Audience Manager vergleicht und gleicht die kombinierten DPID und DPUUID mit einer entsprechenden Benutzer-ID in unserem System ab. Wenn keine ID vorhanden ist, erstellt Audience Manager eine neue Benutzer-ID und synchronisiert sie mit der DPID/DPUUID. Sobald Audience Manager mit einer Benutzer-ID (der UUID) übereinstimmt oder eine solche erstellt, wird diese ID in der JSON Antwort auf die cookie in der Domain des Clients (Erstanbieter-cookie) oder einem anderen lokalen Speicher zurückgegeben.

Rufen Sie diese Funktion auf, wenn Sie DIL v6.1 oder früher verwenden. Diese Funktion wird jedoch zugunsten der neuen Version, die aus der Adobe Experience Platform Identity Service declared IDs wird, nicht mehr unterstützt.

DIL.create({
    partner : "partner name",
    declaredId : {
       dpuuid : dpuuid,
       DPID : dpid
    }
 });

Übergeben von IDs nach DIL Instanziierung

DIL.getDil('partner name').api.signals({...}).declaredId({
  dpuuid : dpuuid
  dpid : dpid
}).submit();

Beispiele für Anfragen/Antworten request-response-examples

Die Anfrage sendet einen Datenanbieter und eine Benutzer-ID an Audience Manager:

https://my_domain.net/event?d_rtbd=json&d_cb=myCallback&key=val&d_dpuuid=1234&d_dpid=5678

Die Antwort gibt die Audience Manager-ID zurück (z. B. UUID), die in ein Erstanbieter-Cookie in der Seiten-Domain geschrieben wird.

myCallback({
...
   "uuid":"abc123"
})

KEIN Targeting von und Opt-out-Aufrufen do-not-target

Der declared ID berücksichtigt die Präferenzen der Site-Besucher, die sich vom Targeting Audience Manager Ihrer Website abmelden möchten. Wenn Audience Manager eine Opt-out-Anfrage erhält, gibt die DCS ein leeres JSON-Objekt anstelle der Audience Manager Benutzer-ID zurück.