Funktionsweise von declared IDs, Einrichten von Prozeduren, Codebeispielen und Variablen.
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.
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 |
Ü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.
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.
Weitere Informationen zum Ausschluss von der Datenerfassung finden Sie unter Datenschutz.
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.
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. |
|
Einen Integrations-Code und eine Benutzer-ID. |
|
Mehrere Schlüssel-Wert-Paare |
|
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 |
---|---|
|
|
Ausschluss auf Partnerebene |
Ein Ausschluss auf Partnerebene wird für die letzte Zuordnung dieses |
|
|
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:
=
-Symbol trennt den Schlüssel von den zugehörigen Werten.%01
trennt die Werte.Variable | Beschreibung |
---|---|
|
Enthält eine Datenanbieter-ID und eine zugehörige eindeutige Benutzer-ID in einem Schlüssel/Wert-Paar. |
|
Enthält einen Integrationscode und eine zugehörige eindeutige Benutzer-ID in einem einzelnen Schlüssel/Wert-Paar. |
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. |
|
Einen Integrations-Code und eine Benutzer-ID. |
|
Mehrere Schlüssel-Wert-Paare |
|
Beschreibt die Konfigurationsvariablen, mit denen declared IDs durch DIL an Audience Manager. übergeben wird
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.
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. |
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
}
});
Sie müssen programmatisch den Code entwickeln, der die ID-Werte für die Schlüssel d_dpuuid
und d_dpid
bereitstellt.
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();
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"
})
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.