Declared IDs declared-ids

Funktionsweise von declared IDs, Einrichten von Verfahren, Codebeispielen und Variablen.

Declared ID Zielsetzung declared-id-targeting

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

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

Einige Browser und die meisten Mobilgeräte akzeptieren nicht den Drittanbieter cookies. Dadurch wird es schwierig, Informationen über Site-Besucher beizubehalten oder beständige IDs zuzuweisen. Um dieses Problem zu beheben, verwendet Audience Manager DIL, damit Sie declared IDs bei einem Ereignisaufruf übergeben können. Außerdem kann ein declared ID als universelle ID fungieren, die für denselben Benutzer für alle Lösungen in der Experience Cloud gilt. In der folgenden Tabelle wird der ID-Targeting-/Matching-Prozess beschrieben:

Verarbeitung
Beschreibung
Ereignisaufruf
Um zu funktionieren, benötigen Sie DIL und den Code für den Adobe Experience Platform Identity Serviceauf der Seite. DIL erhält deklarierte IDs aus der setVisitorID -Funktion, die vom Adobe Experience Platform Identity Service bereitgestellt wird, und übergibt diese an Audience Manager .
Übereinstimmung mit ID

Audience Manager versucht, die Client- und Besucher-ID mit einer entsprechenden ID in unserem System abzugleichen. Wenn keine übereinstimmende ID vorhanden ist, erstellt Audience Manager eine neue ID und ordnet sie der Client- und Besucher-ID zu.

Hinweis: Die neueste Zuordnung wird verwendet, wenn Ihre ID mehr als einer Audience Manager-ID zugeordnet ist.

Rückgabe-ID
Audience Manager schreibt seine synchronisierte ID in ein Erstanbieter-Cookie (oder einen anderen adressierbaren Speicher) in der Client-Domäne oder Anwendung.
Nachfolgende Ereignisaufrufe
Zusätzliche Ereignisaufrufe lesen die Audience Manager-ID aus der Domäne des Kunden und senden sie an den Audience Manager.

Um zu beginnen, müssen Sie den Experience Cloud ID-Dienst und DIL für die Seiten Ihrer Site konfigurieren, die Sie für die Datenerfassung verwenden möchten. Siehe DIL create und Declared ID Variables.

Opt-out-Aufrufe opt-out-calls

Der Prozess declared ID berücksichtigt die Site-Besucherpräferenzen, um das Targeting von Audience Manager durch Ihre Website abzuwählen. Wenn Audience Manager eine Opt-out-Anfrage erhält, enthält der von DCS zurückgegebene JSON den Fehlercode 171 mit der Meldung Encountered opt out tag anstelle der Audience Manager Benutzer-ID.

  • Audience Manager kann ein declared ID Opt-out neben einem Audience Manager UUID in der URL übergeben.
  • Das Opt-out declared ID wird pro Partner in den Profile Cache Server (PCS) gespeichert. Es gibt kein Opt-out auf Plattformebene mit declared IDs. Außerdem wählt Audience Manager den Benutzer aus diesem bestimmten Bereich am Rand aus (der Opt-out erstreckt sich nicht über DCS Bereiche).

Weitere Informationen zum Abmelden von der Datenerfassung finden Sie unter Datenschutz .

Declared ID Opt-out-Beispiele opt-out-examples

Sie können mit den Schlüssel-Wert-Paaren d_cid und d_cid_ic Opt-out-Anfragen für declared ID 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-out über
Code-Beispiel
Eine Datenanbieter-ID und eine Benutzer-ID.
https://domain name/demoptout.jpg?d_cid=123%01987...
Einen Integrations-Code und eine Benutzer-ID.
https://domain name/demoptout?d_cid_ic=456%01321...
Mehrere Schlüssel-Wert-Paare d_cid und d_cid_ic .
https://domain name/demoptout?d_cid=123%01987&d_cid_ic=456%01321...

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

Diese Methoden funktionieren weiterhin, werden jedoch als veraltet betrachtet. Diese Informationen werden für veraltete Zwecke und als Referenz bereitgestellt. Zu den alten Opt-outs gehören:

Opt-out (veraltet)
Code-Beispiel
Nur d_uuid
https://domain/demoptout.jpg?d_uuid=AAM ID
Opt-out auf Partnerebene

https://demoptout.jpg?d_dpuuid= user ID&d_dpid= data provider ID

Ein Opt-out auf Partnerebene wird für die neueste Zuordnung dieses dpid + dpuuid -Paares zu einer AAM UUID gespeichert. Wenn noch keine vorhandene Zuordnung vorhanden ist, prüft der Audience Manager, ob die Anforderung eine AAM UUID im Cookie enthält, und verwendet diese, falls sie dies tut, zum Speichern der Opt-out-Funktion. Andernfalls generiert Audience Manager eine neue AAM-UUID und speichert die Opt-out-Option darunter.

d_dpuuid + d_dpid und explizit d_uuid

https://domain/demoptout.jpg?d_uuid= user ID&d_dpuuid= data provider's user ID&d_dpid=data provider ID

d_uuid hat immer Vorrang. Wenn die Kombination dpid + dpuuid einer anderen AAM UUID zugeordnet ist, wird die Opt-out-Funktion unter der in der Anfrage übergebenen AAM UUID ( d_uuid ) gespeichert.

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

In der folgenden Tabelle sind die Schlüssel-Wert-Paare aufgeführt, die Ihre Audience Manager Datenanbieter-IDs und Benutzer-IDs oder Integrationscodes übergeben, falls verwendet. Hinweis: kursiv gibt einen Variablenplatzhalter an. Es wurden Leerzeichen hinzugefügt, die das Lesen erleichtern.

In jedem Schlüssel-Wert-Paar:

  • Das Symbol = trennt den Schlüssel von den zugehörigen Werten.
  • Das nicht druckbare ASCII Zeichen %01 trennt die Werte.
Variable
Beschreibung
d_cid =data provider ID %01user ID
Enthält eine Datenanbieter-ID und eine zugehörige eindeutige Benutzer-ID in einem einzelnen Schlüssel-Wert-Paar. d_cid ersetzt d_dpid und d_dpuuid , die als veraltet gelten, aber weiterhin unterstützt werden. Siehe CID ersetzt DPID und DPUUID.
d_cid_ic =integration code %01user ID
Enthält einen Integrationscode und eine zugehörige eindeutige Benutzer-ID in einem einzelnen Schlüssel-Wert-Paar. d_cid_ic ersetzt d_dpid und d_dpuuid , die veraltet sind, aber weiterhin unterstützt werden. Siehe CID ersetzt DPID und DPUUID.

Beispielereignisaufrufe sample-event-calls

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

enthält Ereignisaufrufe
Code-Beispiel
Eine Datenanbieter-ID und eine Benutzer-ID.
https://domain name/event?d_cid=123%01987...
Einen Integrations-Code und eine Benutzer-ID.
https://domain name/event?d_cid_ic=456%01321...
Mehrere Schlüssel-Wert-Paare d_cid und d_cid_ic .
https://domain name/event?d_cid=123%01987&d_cid_ic=456%01321...

Declared ID Variablen declared-id-variables

Beschreibt die Konfigurationsvariablen, die verwendet werden, um declared IDs bis DIL an Audience Manager. zu übergeben

DIL verwendet den 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 declared IDs nicht mehr mit den veralteten dpid - und dpuuid -Variablen übergeben. Stattdessen verlassen sich die aktuellen Versionen von DIL darauf, dass die Funktion visitorService die Funktion declared IDs von der Funktion setCustomerIDs in der Adobe Experience Platform Identity Service abruft. Weitere Informationen finden Sie unter Kunden-IDs und Authentifizierungsstatus. Sie würden visitorService in DIL.create aufrufen, wie unten dargestellt.

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

Im Schlüssel-Wert-Paar namespace ist MCORG Ihre Experience Cloud Organisations-ID. Wenn Sie diese ID nicht haben, finden Sie sie im Abschnitt "Administration"des Dashboards "Experience Cloud". Sie benötigen Administratorberechtigungen, um dieses Dashboard anzuzeigen. Siehe Administration: Core Services.

Veraltete Funktionen deprecated-functions

Mit 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 der im obigen Codebeispiel gezeigten Funktion visitorService beruht. Diese Funktion erhält declared IDs von der Adobe Experience Platform Identity Service. Wir verweisen jedoch hier auf diese Variablen aus historischen und veralteten Gründen. Im folgenden Code finden Sie ein Beispiel dafür, wie Sie DIL.create so konfigurieren, dass ein declared ID von der Visitor ID Service abgerufen wird.
In der folgenden Tabelle werden die Legacy-Variablen beschrieben, die vom declaredId -Objekt verwendet werden:

Name
Typ
Beschreibung
dpid
Zeichenfolge
Vom Audience Manager zugewiesene Datenpartner-ID.
dpuuid
Zeichenfolge
Die eindeutige Datenanbieter-ID für den Benutzer.

DPID und DPUUID

Audience Manager vergleicht und stimmt die kombinierten DPID und DPUUID mit einer entsprechenden Benutzer-ID in unserem System überein. Wenn keine ID vorhanden ist, erstellt Audience Manager eine neue Benutzer-ID und synchronisiert sie mit der Kombination DPID/DPUUID . Sobald Audience Manager eine Benutzer-ID (die UUID) erfüllt oder erstellt, wird diese ID in der Antwort JSON an die cookie in der Domäne des Kunden (Erstanbieter-ID cookie) oder in einem anderen lokalen Speicher zurückgegeben.

Rufen Sie diese Funktion auf, wenn Sie DIL v6.1 oder früher verwenden. Diese Funktion wird jedoch nicht mehr für die neue Version unterstützt, die declared IDs von der Adobe Experience Platform Identity Service erhält.

DIL.create({
    partner : "partner name",
    declaredId : {
       dpuuid : dpuuid,
       DPID : dpid
    }
 });
NOTE
Sie müssen programmatisch den Code entwickeln, der die ID-Werte für die Schlüssel d_dpuuid und d_dpid bereitstellt.

Übergeben von IDs nach DIL Instanziierungen

NOTE
Wenn Sie einen API -Aufruf mit einer anderen declaredID -Kombination vornehmen, wird die neue Kombination nur für diesen Aufruf verwendet. Weitere reguläre Ereignisaufrufe verwenden die ursprüngliche Kombination DIL.create declaredID .
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 (z. B. UUID) zurück, die in ein Erstanbieter-Cookie in der Seitendomäne geschrieben wird.

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

Keine Target- und Opt-out-Aufrufe do-not-target

Der Prozess declared ID berücksichtigt die Site-Besucherpräferenzen, um das Targeting von Audience Manager durch Ihre Website abzuwählen. Wenn Audience Manager eine Opt-out-Anfrage erhält, gibt der DCS ein leeres JSON -Objekt anstelle der Audience Manager Benutzer-ID zurück.

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695