Show Menu
THEMEN×

Declared IDs

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

Declared ID Zielsetzung

Tauschen Sie Benutzer-IDs mit Audience Manager Geräten oder Browsern aus, die keine persistenten Datenspeicherung verwenden oder akzeptieren, wie z. B. Drittanbieter, und synchronisieren Sie diese cookies.

Zweck des Declared ID Targeting

Einige Browser und die meisten Mobilgeräte akzeptieren kein Drittanbieter cookies. Dadurch wird es schwierig, Informationen über Site-Besucher beizubehalten oder beständige IDs zuzuweisen. Um dieses Problem zu beheben, Audience Manager können Sie DIL es verwenden, um einen Ereignis-Aufruf declared IDs zu übermitteln. Darüber hinaus declared ID kann ein Benutzer als universelle ID fungieren, die für denselben Benutzer in allen Lösungen in der Experience CloudBenutzeroberfläche gilt. Die folgende Tabelle beschreibt den ID-Targeting-/Abgleichungsprozess:
Verarbeitung Beschreibung
Ereignis-Aufruf
Zur Arbeit benötigen Sie DIL und den Adobe Experience Platform Identity Service -Code auf der Seite. DIL erhält deklarierte IDs aus der setVisitorID Funktion, die vom Identitätsdienst der Adobe Experience Platform bereitgestellt wird, und übergibt diese an den Audience Manager .
Übereinstimmung-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 diese 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 Datenspeicherung-Bereich) in der Clientdomäne oder Anwendung.
Nachfolgende Ereignis-Aufrufe
Zusätzliche Ereignis-Aufrufe lesen die Audience Manager-ID aus der Clientdomäne und senden diese an den Audience Manager.
Um zu beginnen, müssen Sie den Experience Cloud ID-Dienst und DIL über die Seiten Ihrer Site, die Sie für die Datenerfassung verwenden möchten, konfigurieren. Siehe DIL-Variablen erstellen und deklarieren .

Ausschluss-Anrufe

Der declared ID Audience Manager Vorgang berücksichtigt die Voreinstellungen des Site-Besuchers, um das Targeting auf Ihrer Website abzuwählen. When Audience Manager receives an opt-out request, the JSON returned by the DCS contains the error code 171, with the message Encountered opt out tag , instead of the Audience Manager user ID.
  • Audience Manager kann ein declared ID Opt-out zusammen mit einem Audience Manager in der UUID URL.
  • Der declared ID Ausschluss wird im Profil Cache Server (PCS) pro Partner gespeichert. Es gibt keinen Ausschluss auf Plattformebene declared IDs. Darüber hinaus Audience Manager wird der Benutzer an der Kante aus dieser bestimmten Region ausgeschlossen (das Opt-out erfolgt nicht über [DCS Regionen hinweg).
Weitere Informationen zum Ausschluss von der Datenerfassung finden Sie unter Datenschutz .

Declared ID Ausschluss-Beispiele

You can make a declared ID opt-out requests with the d_cid and d_cid_ic key-value pairs. 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, DPUUIDund UUID (nicht mehr unterstützt)

Diese Methoden funktionieren weiterhin, werden jedoch als veraltet betrachtet. Diese Informationen werden zu veralteten Zwecken und als Referenz bereitgestellt. Ältere Opt-outs umfassen:
Ausschluss (überholt) Code-Beispiel
d_uuid erst dann
https:// domain /demoptout.jpg?d_uuid=AAM ID
Ausschluss auf Partnerebene
https://demoptout.jpg?d_dpuuid= user ID&d_dpid= data provider ID
Ein Ausschluss auf Partnerebene wird für die neueste Zuordnung dieses dpid +- dpuuid Paars zu einer AAM-UUID gespeichert. Wenn es keine bereits vorhandene Zuordnung gibt, prüft Audience Manager, ob die Anforderung eine AAM-UUID im Cookie enthält, und verwendet diese gegebenenfalls zum Speichern der Ausschluss-ID. Andernfalls generiert Audience Manager eine neue AAM-UUID und speichert die Ausschluss-Option darin.
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 immer Vorrang hat. Wenn die dpid +- dpuuid Kombination einer anderen AAM-UUID zugeordnet wird, wird die Abmeldung unter der AAM-UUUID gespeichert, die in der Anforderung weitergegeben wird ( d_uuid ).

Variablen und Syntax für Declared IDs

In der folgenden Tabelle werden die Schlüssel-Wert-Paare Liste, die bei Verwendung Ihre Audience Manager Datenanbieter-ID und Benutzer-IDs oder Integrationscodes weitergeben. Note, italics indicates a variable placeholder. Es wurden Leerzeichen hinzugefügt, um das Lesen zu vereinfachen.
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 %01 user ID
Enthält eine Datenanbieter-ID und eine zugehörige eindeutige Benutzer-ID in einem Schlüssel/Wert-Paar. d_cid ersetzt d_dpid und d_dpuuid , die als nicht mehr unterstützt, aber dennoch unterstützt werden. Siehe CID ersetzt DPID und DPUUID .
d_cid_ic = integration code %01 user 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 nicht mehr unterstützt, aber trotzdem unterstützt werden. Siehe CID ersetzt DPID und DPUUID .

Ereignis-Beispielaufrufe

Angesichts dieser Schlüssel-Wert-Paare und ihrer erforderlichen Syntax würden Sie wie unten gezeigt Ereignis-Aufrufe durchführen.
Ereignis-Aufruf beinhaltet 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, die verwendet werden, um declared IDs DIL an Audience Manager.

DIL verwendet Adobe Experience Platform Identity Service die Declared IDs

Bei Verwendung mit dem Identitätsdienst für Adobe Experience Platformen müssen Sie nicht mehr declared IDs mit den veralteten dpid und dpuuid Variablen weitergeben. Stattdessen DIL verlassen sich die aktuellen Versionen auf die visitorService Funktion, um die declared IDs aus der setCustomerIDs Funktion in der Adobe Experience Platform Identity Servicezu erhalten. For more information, see Customer IDs and Authentication States . Sie rufen visitorService wie unten gezeigt DIL.create an.
var vDil = DIL.create({
  partner:"partner name",
  visitorService:{
    namespace:"INSERT-MCORG-ID-HERE"
  }
});

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

Veraltete Funktionen

Bei den neuesten Versionen von DIL (6.2+) müssen Sie diese Schlüssel-Wert-Paare nicht verwenden, um sie weiterzugeben declared IDs. Das liegt daran, dass DIL jetzt die im obigen Codebeispiel dargestellte visitorService Funktion verwendet wird. Diese Funktion wird declared IDs von der Adobe Experience Platform Identity Service. Wir verweisen hier jedoch auf diese Variablen aus historischen und alten Gründen. Im folgenden Code finden Sie ein Beispiel für die Konfiguration DIL.create zum Abrufen eines declared ID Formulars aus dem Visitor ID Service. In der folgenden Tabelle werden die vom declaredId Objekt verwendeten Variablen beschrieben:
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 stimmt mit der kombinierten DPID und DPUUID einer entsprechenden Benutzer-ID in unserem System überein. Wenn keine ID vorhanden ist, Audience Manager wird eine neue Benutzer-ID erstellt und mit der DPID/DPUUID Kombination synchronisiert. Sobald eine Benutzer-ID (die Audience Manager ) UUID übereinstimmt oder erstellt wird, gibt sie diese ID in der JSON Antwort auf die cookie cookieDomäne des Kunden (Erstanbieter-ID) oder eine andere lokale Datenspeicherung zurück.
Rufen Sie diese Funktion auf, wenn Sie DIL v6.1 oder früher verwenden. Diese Funktion wurde jedoch zugunsten der neuen Version aufgegeben, die declared IDs von der Adobe Experience Platform Identity Service.
DIL.create({
    partner : "partner name",
    declaredId : {
       dpuuid : dpuuid,
       DPID : dpid
    }
 });

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

Weitergeben von IDs nach DIL Instanziierung

Wenn Sie einen API Aufruf mit einer anderen declaredID Kombination durchführen, wird die neue Kombination nur für diesen Aufruf verwendet. Bei weiteren regulären Ereignis-Aufrufen wird die ursprüngliche DIL.create Kombination verwendet declaredID .
DIL.getDil('partner name').api.signals({...}).declaredId({
  dpuuid : dpuuid
  dpid : dpid
}).submit();

Anforderungs-/Antwortbeispiele

Die Anforderung 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 Zielgruppe- und Ausschluss-Aufrufe

Der declared ID Audience Manager Vorgang berücksichtigt die Voreinstellungen des Site-Besuchers, um das Targeting auf Ihrer Website abzuwählen. Wenn Audience Manager eine Abmeldeanforderung eingeht, gibt die DCS ein leeres JSON Objekt anstelle der Audience Manager Benutzer-ID zurück.