Declared IDs declared-ids
Funktionsweise von declared IDs, Einrichten von Verfahren, Codebeispielen und Variablen.
Declared ID Zielsetzung declared-id-targeting
Tauschen Sie Benutzer-IDs mit Audience Manager aus Geräten oder Browsern aus, die keine persistenten Speichermechanismen verwenden oder akzeptieren, z. B. von Drittanbietern cookies.
Zweck von Declared ID Targeting declared-id-targeting-purpose
Einige Browser und die meisten Mobilgeräte akzeptieren cookies nicht von Drittanbietern. 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 Ereignisaufruf übergeben können. Außerdem kann ein declared ID als universelle ID fungieren, die für denselben Benutzer über alle Lösungen in Experience Cloud gilt. In der folgenden Tabelle wird der ID-Targeting-/Matching-Prozess beschrieben:
setVisitorID
Adobe Experience Platform Identity-Dienst bereitgestellten Funktion ab und übergibt diese an Audience Manager .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 ordnet sie der Client- und Besucher-ID zu.
Hinweis: Die neueste Zuordnung wird verwendet, wenn Ihre ID mehr als einer Audience Manager-ID zugeordnet ist.
Zunächst müssen Sie den ID-Dienst Experience Cloud und DIL für die Seiten Ihrer Site konfigurieren, die Sie für die Datenerfassung verwenden möchten. Siehe DIL create and Declared ID Variables.
Opt-out-Aufrufe opt-out-calls
Der Prozess declared ID berücksichtigt die Site-Besucherpräferenzen, um das Targeting von Audience Manager durch Ihre Website abzuwählen. Wenn Audience Manager eine Opt-out-Anfrage erhält, enthält das von DCS zurückgegebene JSON den Fehlercode 171 mit der Meldung Encountered opt out tag
anstelle der Benutzer-ID Audience Manager.
- Audience Manager kann eine declared ID Opt-out-Funktion neben einer Audience Manager UUID in der URLübergeben.
- Das Opt-out declared ID wird pro Partner im Ordner Profile Cache Server (PCS) gespeichert. Mit declared IDs gibt es kein Opt-out auf Plattformebene. Außerdem lehnt Audience Manager den Benutzer von diesem bestimmten Bereich am Rand ab (der Opt-out erstreckt sich nicht über DCS -Regionen).
Weitere Informationen zum Abmelden von der Datenerfassung finden Sie unter Datenschutz .
Declared ID Opt-out-Beispiele opt-out-examples
Sie können mit den Schlüsselwertpaaren d_cid
und d_cid_ic
eine declared ID-Opt-out-Anfrage 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.
https://domain name/demoptout.jpg?d_cid=123%01987...
https://domain name/demoptout?d_cid_ic=456%01321...
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 (veraltet)
Diese Methoden funktionieren weiterhin, werden jedoch als veraltet betrachtet. Diese Informationen werden für veraltete Zwecke und als Referenz bereitgestellt. Die bisherigen Opt-outs umfassen:
d_uuid
erst dannhttps://domain/demoptout.jpg?d_uuid=AAM ID
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
-Paars zu einer AAM UUID gespeichert. Wenn noch keine vorhandene Zuordnung vorhanden ist, prüft der Audience Manager, ob die Anforderung eine AAM UUID im Cookie enthält, und verwendet diese, falls sie dies tut, zum Speichern der Opt-out-Funktion. Andernfalls generiert Audience Manager eine neue AAM-UUID und speichert die Opt-out-Option darunter.
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-UUID zugeordnet ist, wird die Opt-out-Funktion unter der AAM UUID gespeichert, die in der Anfrage ( d_uuid
) übergeben wird.
Variablen und Syntax für Declared IDs variables-and-syntax
In der folgenden Tabelle sind die Schlüssel-Wert-Paare aufgeführt, die Ihre Audience Manager-Datenanbieter-IDs und Benutzer-IDs oder Integrationscodes übergeben, falls verwendet. Hinweis: kursiv gibt einen Variablenplatzhalter an. Es wurden Leerzeichen hinzugefügt, die das Lesen erleichtern.
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.
d_cid =data provider ID %01user ID
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
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.Beispielereignisaufrufe sample-event-calls
Angesichts dieser Schlüssel-Wert-Paare und ihrer erforderlichen Syntax würden Sie Ereignisaufrufe durchführen, wie unten dargestellt.
https://domain name/event?d_cid=123%01987...
https://domain name/event?d_cid_ic=456%01321...
d_cid
und d_cid_ic
.https://domain name/event?d_cid=123%01987&d_cid_ic=456%01321...
Declared ID Variablen declared-id-variables
Beschreibt die Konfigurationsvariablen, die zum Übergeben von declared IDs durch DIL an Audience Manager. verwendet werden
DIL verwendet den Adobe Experience Platform Identity Service zu übergebenden Declared IDs dil-id-service-pass-declared-ids
Bei Verwendung mit dem Adobe Experience Platform Identity Service müssen Sie declared IDs nicht mehr mit den veralteten Variablen dpid
und dpuuid
übergeben. Stattdessen verlassen sich die aktuellen Versionen von DIL auf die visitorService
-Funktion, um die declared IDs aus der setCustomerIDs
-Funktion in der Adobe Experience Platform Identity Service zu erhalten. 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 Administratorberechtigungen, um dieses Dashboard anzuzeigen. Siehe Administration: Hauptdienste.
Veraltete Funktionen deprecated-functions
Mit 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 der Funktion visitorService
beruht, die im obigen Codebeispiel gezeigt wird. Diese Funktion erhält declared IDs von Adobe Experience Platform Identity Service. Wir verweisen jedoch hier auf diese Variablen für historische und veraltete Zwecke. Im folgenden Code finden Sie ein Beispiel dafür, wie Sie DIL.create
so konfigurieren, dass ein declared ID von Visitor ID Service abgerufen wird.
In der folgenden Tabelle werden die alten Variablen beschrieben, die vom declaredId
-Objekt verwendet werden:
dpid
dpuuid
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, erstellt Audience Manager eine neue Benutzer-ID und synchronisiert sie mit der Kombination DPID/DPUUID
. Sobald Audience Manager eine Benutzer-ID (die UUID
) abgleicht oder erstellt, wird diese ID in der JSON-Antwort an cookie in der Domäne des Kunden (Erstanbieter cookie) oder in einem anderen lokalen Speicher zurückgegeben.
Rufen Sie diese Funktion auf, wenn Sie DIL v6.1 oder früher verwenden. Diese Funktion wird jedoch nicht mehr für die neue Version unterstützt, die declared IDs von Adobe Experience Platform Identity Service erhält.
DIL.create({
partner : "partner name",
declaredId : {
dpuuid : dpuuid,
DPID : dpid
}
});
d_dpuuid
und d_dpid
bereitstellt.Übergeben von IDs nach DIL Instanziierungen
declaredID
-Kombination vornehmen, wird die neue Kombination nur für diesen Aufruf verwendet. Weitere reguläre Ereignisaufrufe verwenden die ursprüngliche DIL.create
declaredID
-Kombination.DIL.getDil('partner name').api.signals({...}).declaredId({
dpuuid : dpuuid
dpid : dpid
}).submit();
Beispiele für Anfragen/Antworten request-response-examples
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 (z. B. UUID
) zurück, die in ein Erstanbieter-Cookie in der Seitendomäne geschrieben wird.
myCallback({
...
"uuid":"abc123"
})
Keine Target- und Opt-out-Aufrufe do-not-target
Der Prozess declared ID berücksichtigt die Site-Besucherpräferenzen, um das Targeting von Audience Manager durch Ihre Website abzuwählen. Wenn Audience Manager eine Opt-out-Anfrage erhält, gibt DCS ein leeres JSON-Objekt anstelle der Audience Manager-Benutzer-ID zurück.