Dokumentation Audience Manager Benutzerhandbuch für Audience Manager

Declared IDs

Letzte Aktualisierung: 5. Mai 2025

Themen:

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

Declared ID Zielsetzung

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

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:

Verarbeitung	Beschreibung
Ereignisaufruf	Dazu benötigen Sie DIL- und den Adobe Experience Platform Identity Service--Code auf der Seite. DIL erhält deklarierten IDs aus der `setVisitorID` , die von der Adobe Experience Platform Identity Service- bereitgestellt wird, und übergibt diese an Audience Manager .
Match-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 verknüpft sie mit der Client- und Besucher-ID. 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 Speicherplatz) in der Client-Domain oder im Programm.
Nachfolgende Ereignisaufrufe	Zusätzliche Ereignisaufrufe lesen die Audience Manager-ID aus der Domain des Clients und senden sie an Audience Manager.

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 deklarierte ID-Variablen.

Opt-out-Aufrufe

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.

Audience Manager können eine declared ID-Abmeldung zusammen mit einer Audience Manager-UUID im URL übergeben.
Die declared ID Opt-out-Option wird in der Profile Cache Server (PCS) pro Partner gespeichert. Es gibt kein Opt-out auf Plattformebene mit declared IDs. Darüber hinaus verhindert Audience Manager, dass Benutzende aus diesem bestimmten Bereich am Edge abgemeldet werden (die Abmeldung betrifft nicht DCS Bereiche).

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

Beispiele für Declared ID Opt-out

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-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 `d_cid` und `d_cid_ic` Schlüssel-Wert-Paare.	`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, gelten aber als veraltet. Diese Informationen werden zu Legacy-Zwecken und als Referenz bereitgestellt. Zu den Legacy-Opt-outs gehören:

Opt-out (veraltet) Code-Beispiel

Nur d_uuid https://domain/demoptout.jpg?d_uuid=AAM ID

Opt-out auf Partnerebene

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 keine zuvor bestehende Zuordnung vorhanden ist, prüft Audience Manager, ob die Anfrage eine AAM-UUID im Cookie enthält. Ist dies der Fall, verwendet diese zum Speichern des Opt-outs. Andernfalls generiert Audience Manager eine neue AAM-UUID und speichert die Abmeldung darunter.
`d_dpuuid` + `d_dpid` und explizite `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 das Opt-out unter der in der Anfrage übergebenen AAM-UUID gespeichert ( `d_uuid` ).

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 keine zuvor bestehende Zuordnung vorhanden ist, prüft Audience Manager, ob die Anfrage eine AAM-UUID im Cookie enthält. Ist dies der Fall, verwendet diese zum Speichern des Opt-outs. Andernfalls generiert Audience Manager eine neue AAM-UUID und speichert die Abmeldung darunter.

d_dpuuid + d_dpid und explizite 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 das Opt-out unter der in der Anfrage übergebenen AAM-UUID gespeichert ( d_uuid ).

Variablen und Syntax für Declared IDs

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:

Das = trennt den Schlüssel von den zugehörigen Werten.
Die nicht druckbare ASCII trennt die Werte %01.

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

Beispiele für Ereignisaufrufe

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

Der Ereignisaufruf umfasst	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 `d_cid` und `d_cid_ic` Schlüssel-Wert-Paare.	`https://domain name/event?d_cid=123%01987&d_cid_ic=456%01321...`

Declared ID Variablen

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

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 Erste Schritte mit Experience Cloud-Services.

Veraltete Funktionen

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:

Name

Typ

Beschreibung

dpid

Zeichenfolge

Von Audience Manager zugewiesene Datenpartner-ID.

dpuuid

Zeichenfolge

Die eindeutige Datenanbieter-ID für den Benutzer.

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
    }
 });

NOTE

Sie müssen programmgesteuert den Code entwickeln, der die ID-Werte für die d_dpuuid- und d_dpid bereitstellt.

Übergeben von IDs nach DIL Instanziierung

NOTE

Wenn Sie einen API Aufruf mit einer anderen declaredID ausführen, wird die neue Kombination nur für diesen Aufruf verwendet. Weitere regelmäßige Ereignisaufrufe verwenden die ursprüngliche DIL.create declaredID.

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

Beispiele für Anfragen/Antworten

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

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.

recommendation-more-help