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:

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

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.

Beispiel-Ereignis-Aufrufe

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

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:

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

Übergeben von IDs nach DIL-Instanziierungen

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.