CID ersetzt DPID und DPUUID

Aktualisieren Sie Ihren Code, um d_cid oder d_cid_ic anstelle von d_dpid und d_dpuuid zu verwenden. Die Variablen DPID und DPUUID funktionieren weiterhin, sollten jedoch als veraltet betrachtet werden. Dazu gehören DPID- und DPUUID-Varianten ohne das d_ prefix.

DPID und DPUUID: Ein Review

Die DPID und die DPUUID sind Schlüssel/Wert-Paare, die eine Datenanbieter-ID und eine Benutzer-ID enthalten. Diese Schlüssel/Wert-Paare verknüpfen Anbieter-IDs mit Benutzer-IDs. Sie senden Daten bei Ereignis-Aufrufen, bei eingehenden Synchronisierungs-Ereignissen und bei ID-Aufrufen ein. Ohne sie wären Audience Manager und andere Dienste oder Funktionen nicht in der Lage, IDs zuzuordnen und zu synchronisieren. Diese Variablen werden manchmal mit oder ohne das Präfix d_ wie unten dargestellt ausgedrückt. Beachten Sie, dass italics im Code einen variablen Platzhalter angibt.

Variable	Syntax
Datenanbieter-ID (DPID)	`d_dpid=data provider ID` `dpid=data provider ID`
Eindeutige Datenanbieter-Benutzer-ID (DPUUID)	`d_dpuuid=data provider unique user ID` `dpuuid=data provider unique user ID`

Diese Schlüssel-Wert-Paare funktionieren weiterhin, sind jedoch veraltet. Sie sollten Ihren Code aktualisieren, um stattdessen CID oder CID_IC zu verwenden.

CID und CID_IC: Über

Die Schlüssel-Wert-Paare CID und CID_IC ersetzen DPID und DPUUID. Sie bieten dieselben Funktionen wie DPID und DPUUID, sind jedoch effizienter, da sie die Datenanbieter-ID (oder den Integrationscode) und die Benutzer-ID in einem Schlüssel-Wert-Paar enthalten. 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 und d_cid_ic verwenden Sie die folgende Syntax. Beachten Sie, dass italics im Code einen variablen Platzhalter angibt.

Variable Syntax

Variable	Syntax
Kunden-ID (CID)	`d_cid=data provider ID%01user ID`
Kunden-ID-Integrationscode (CID_IC)	`d_cid_ic=integration code%01user ID` Ein -Integrationscode ist eine alternative ID, die Sie anstelle der Datenquelle-ID verwenden können, die von Audience Manager zugewiesen wird. Informationen zum Konfigurieren eines Integrationscodes finden Sie unter Datenquelle erstellen.

Kunden-ID (CID)

d_cid=data provider ID%01user ID

Kunden-ID-Integrationscode (CID_IC)

d_cid_ic=integration code%01user ID

Ein -Integrationscode ist eine alternative ID, die Sie anstelle der Datenquelle-ID verwenden können, die von Audience Manager zugewiesen wird. Informationen zum Konfigurieren eines Integrationscodes finden Sie unter Datenquelle erstellen.

Siehe auch URL-Variablen und -Syntax für deklarierte IDs.

HINWEIS

Sie können Integrationscodes für Ihre eigenen Datenquellen und für globale freigegebene Datenquellen verwenden, auf die Sie Zugriff haben. Sie können beispielsweise Integrationscodes bei der Arbeit mit Datenquellen für mobile Identifikatoren verwenden. Verwenden Sie die folgenden Integrationscodes genau wie unten angegeben:

DSID_20914 für GAID, die Geräte darstellen, auf denen das Android-Betriebssystem ausgeführt wird.
DSID_20915 für IDFA, die Geräte darstellen, auf denen das iOS-Betriebssystem ausgeführt wird.

Beispiele

Die folgende Tabelle zeigt Beispiele nach Ereignistyp.

Ereignistyp	Beispiel
Ereignis-	Neue: `.../event?d_cid=123%01987...` herabgestuft: `.../event?d_dpid=123&d_dpuuid=987...`
Inbound Synchronization (IBS)	Neue: `.../ibs:d_cid=123%01987...` herabgestuft: `.../ibs:d_dpid=123&d_dpuuid=987`
UUID (ID) des Audience Managers generieren	Neue: `.../id?d_cid=123%01987...` herabgestuft: `.../id?d_dpid=123&d_dpuuid=987`

Jeder Aufruf kann auch mehrere Schlüsselwertpaare wie folgende enthalten:d_cid d_cid_ic

...?d_cid=123%01456&d_cid=123%01789&d_cid_ic=543%01333...

Wichtige Überlegungen für Entwicklungsteams

Element	Beschreibung
URL-Kodierung	Ihre Entwicklungsteams müssen die URL-Kodierung auf die folgenden Variablen im CID-Schlüssel/Wert-Paar anwenden: `user ID` `(dpuuid)` `integration code` Hinweis: Sie müssen die Benutzer-ID und den Integrationscode vor der Verkettung in eine Zeichenfolge URL kodieren. Das liegt daran, dass das ASCII-Zeichen %01, das die beiden Variablen trennt, nicht in der URL-Kodierung erfasst werden darf. Die URL-Kodierung stellt sicher, dass Ihre Benutzer-IDs und Integrationscodes, die reservierte oder unsichere Zeichen wie + oder = enthalten, aber nicht darauf beschränkt sind, korrekt an unsere Server übertragen werden. Referenzieren Sie die ASCII-Kodierungstabelle .
Verwenden von Integrationscodes für globale freigegebene Datenquellen	Sie können Integrationscodes für Ihre eigenen Datenquellen und für globale freigegebene Datenquellen verwenden, auf die Sie Zugriff haben. Sie können beispielsweise Integrationscodes bei der Arbeit mit Datenquellen für mobile Identifikatoren verwenden. Verwenden Sie die folgenden Integrationscodes genau wie unten angegeben: DSID_20914 für GAID, die Geräte darstellen, auf denen das Android-Betriebssystem ausgeführt wird. DSID_20915 für IDFA, die Geräte darstellen, auf denen das iOS-Betriebssystem ausgeführt wird.

Element

Beschreibung

URL-Kodierung

Ihre Entwicklungsteams müssen die URL-Kodierung auf die folgenden Variablen im CID-Schlüssel/Wert-Paar anwenden:

user ID (dpuuid)
integration code

Hinweis: Sie müssen die Benutzer-ID und den Integrationscode vor der Verkettung in eine Zeichenfolge URL kodieren. Das liegt daran, dass das ASCII-Zeichen %01, das die beiden Variablen trennt, nicht in der URL-Kodierung erfasst werden darf.

Die URL-Kodierung stellt sicher, dass Ihre Benutzer-IDs und Integrationscodes, die reservierte oder unsichere Zeichen wie + oder = enthalten, aber nicht darauf beschränkt sind, korrekt an unsere Server übertragen werden.

Referenzieren Sie die ASCII-Kodierungstabelle .

Verwenden von Integrationscodes für globale freigegebene Datenquellen

DSID_20914 für GAID, die Geräte darstellen, auf denen das Android-Betriebssystem ausgeführt wird.
DSID_20915 für IDFA, die Geräte darstellen, auf denen das iOS-Betriebssystem ausgeführt wird.