CID ersetzt DPID und DPUUID cid-replaces-dpid-and-dpuuid

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

DPID und DPUUID: Eine Überprüfung dpid-dpuuid-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 während Ereignisaufrufen, für eingehende Synchronisierungsereignisse und für ID-Aufrufe. Ohne sie wären Audience Manager und andere Dienste oder Funktionen nicht in der Lage, IDs abzugleichen und zu synchronisieren. Diese Variablen werden manchmal mit oder ohne das Präfix d_ wie unten dargestellt ausgedrückt. Beachten Sie, dass kursiv im Code einen Variablenplatzhalter angibt.

Variable
Syntax
Datenanbieter-ID (DPID)
  • d_dpid=data provider ID
  • dpid=data provider ID
Unique User-ID des Datenanbieters (DPUUID)
  • d_dpuuid=data provider unique user ID
  • dpuuid=data provider unique user ID

Diese Schlüssel-Wert-Paare funktionieren weiterhin, werden jedoch nicht mehr unterstützt. Sie sollten Ihren Code so aktualisieren, dass stattdessen CID oder CID_IC verwendet wird.

CID und CID_IC: Info cid-cidic-about

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 einzelnen 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 unten dargestellte Syntax. Beachten Sie, dass kursiv im Code einen Variablenplatzhalter angibt.

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 Erstellen einer Datenquelle .

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

NOTE
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 beim Arbeiten mit Datenquellen für mobile Identifikatoren verwenden. Verwenden Sie die folgenden Integrationscodes genau wie unten angegeben:
  • DSID_20914 für GAID, die Geräte darstellt, 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 enthält Beispiele nach Ereignistyp.

Ereignistyp
Beispiel
Ereignis-
  • Neue: .../event?d_cid=123%01987...
  • herabgestuft: .../event?d_dpid=123&d_dpuuid=987...
Eingehende Synchronisierung (IBS)
  • Neue: .../ibs:d_cid=123%01987...
  • herabgestuft: .../ibs:d_dpid=123&d_dpuuid=987
Audience Manager-UUID (ID) generieren
  • Neue: .../id?d_cid=123%01987...
  • herabgestuft: .../id?d_dpid=123&d_dpuuid=987

Jeder Aufruf kann auch mehrere d_cid - und d_cid_ic -Schlüsselwertpaare wie die folgenden enthalten:

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

Wichtige Aspekte für Entwicklungsteams dev-considerations

Element
Beschreibung
URL-Kodierung

Ihre Entwicklungsteams müssen 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 URL verschlüsseln, bevor sie in einer Zeichenfolge verketten kann. Dies liegt daran, dass das ASCII-Zeichen %01, das die beiden Variablen trennt, nicht in der URL-Kodierung erfasst werden darf.

Die URL-Codierung stellt sicher, dass Ihre Benutzer-IDs und Integrationscodes, die reservierte oder unsichere Zeichen wie, aber nicht beschränkt auf, + oder = enthalten, 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 beim Arbeiten mit Datenquellen für mobile Identifikatoren verwenden. Verwenden Sie die folgenden Integrationscodes genau wie unten angegeben:

  • DSID_20914 für GAID, die Geräte darstellt, 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.
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695