Declared IDs

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

Declared ID Zielsetzung

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

Zweck von 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, verwendet Audience Manager DIL, damit Sie declared IDs bei einem Ereignis-Aufruf übermitteln können. Außerdem kann ein declared ID als universelle ID fungieren, die für denselben Benutzer in allen Lösungen von Experience Cloud gilt. Die folgende Tabelle beschreibt den ID-Targeting-/Abgleichungsprozess:

Verarbeitung Beschreibung
Ereignis-Aufruf

Für die Arbeit benötigen Sie DIL und den -Adobe Experience Platform-Identitätsdienst -Code auf der Seite. DIL erhält deklarierte IDs aus der setVisitorID Funktion des Adobe Experience Platform-Identitätsdienstes 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 für die Seiten Ihrer Site konfigurieren, die Sie für die Datenerfassung verwenden möchten. Siehe DIL create und Deklarierte ID-Variablen.

Ausschluss-Aufrufe

Der declared ID-Prozess berücksichtigt Site-Besucher-Voreinstellungen, um Audience Manager-Targeting von Ihrer Website abzuwählen. Wenn Audience Manager eine Abmeldeanforderung empfängt, enthält das 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 übergeben URL.
  • Die declared ID-Abmeldung wird pro Partner im Profile Cache Server (PCS) gespeichert. Mit declared IDs gibt es kein Ausschluss auf Plattformebene. Außerdem wird der Benutzer durch Audience Manager aus dieser bestimmten Region am Rand ausgeschlossen (die Ausschluss-Option überschreitet nicht die Bereiche DCS).

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

Declared ID Ausschluss-Beispiele

Sie können mit den Schlüssel-Wert-Paaren d_cid und d_cid_ic Abmeldeanfragen stellen. declared ID 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 (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 letzte 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 UUUID im Cookie enthält. Ist dies der Fall, verwendet diese zum Speichern der Ausschluss-ID. Andernfalls generiert Audience Manager eine neue AAM UUID und speichert die Ausschluss-ID 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 Kombination dpid + dpuuid einer anderen AAM UUUID zugeordnet wird, wird die Ausschluss-ID unter der AAM UUID gespeichert, die in der Anforderung ( d_uuid ) übergeben wird.

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 übermitteln. Hinweis: kursiv gibt einen Variablenplatzhalter an. 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 %01user 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 %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 nicht mehr unterstützt, aber dennoch unterstützt werden. Siehe CID ersetzt DPID und DPUUID .

Beispiel-Ereignis-Aufrufe

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 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

Beschreibt die Konfigurationsvariablen, mit denen declared IDs durch DIL an Audience Manager. übergeben wird

DIL verwendet Adobe Experience Platform Identity Service die Declared IDs

Bei Verwendung mit dem Adobe Experience Platform-Identitätsdienst müssen Sie declared IDs nicht mehr mit den nicht mehr unterstützten Variablen dpid und dpuuid übergeben. Stattdessen verlassen sich die aktuellen Versionen von DIL auf die Funktion visitorService, um declared IDs von der Funktion setCustomerIDs in Adobe Experience Platform Identity Service abzurufen. 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 Experience Cloud-Dashboards. Sie benötigen Administratorrechte, um dieses Dashboard Ansicht. Siehe Administration: Hauptdienste.

Veraltete Funktionen

Bei den neuesten Versionen von DIL (6.2+) müssen Sie diese Schlüssel-Wert-Paare nicht verwenden, um declared IDs weiterzugeben. Das liegt daran, dass DIL jetzt auf der Funktion visitorService basiert, die im obigen Codebeispiel gezeigt wird. Diese Funktion ruft declared IDs von Adobe Experience Platform Identity Service ab. Wir verweisen hier jedoch auf diese Variablen aus historischen und alten Gründen. Im folgenden Code finden Sie ein Beispiel dafür, wie DIL.create so konfiguriert wird, dass ein declared ID von Visitor ID Service abgerufen wird.
Die folgende Tabelle beschreibt die vom declaredId-Objekt verwendeten alten Variablen:

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 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. Wenn Audience Manager eine Benutzer-ID (die UUID) erfüllt oder erstellt, gibt sie diese ID in der JSON-Antwort auf das cookie in der Clientdomäne (Erstanbieter cookie) oder in einer anderen lokalen 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 Adobe Experience Platform Identity Service erhält.

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

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

HINWEIS

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 declaredID-Kombination verwendet.

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-Prozess berücksichtigt Site-Besucher-Voreinstellungen, um Audience Manager-Targeting von Ihrer Website abzuwählen. Wenn Audience Manager eine Abmeldeanforderung empfängt, gibt DCS ein leeres JSON-Objekt anstelle der Audience Manager-Benutzer-ID zurück.

Auf dieser Seite

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now