CID sustituye DPID y DPUUID

Actualice el código para que utilice d_cid o d_cid_ic en lugar de d_dpid y d_dpuuid. Las variables DPID y DPUUID seguirán funcionando, pero debe considerarse que están en desuso. Esto incluye variantes de DPID y DPUUID sin d_ prefix.

DPID y DPUUID: Una revisión

El DPID y el DPUUID son pares clave-valor que contienen un ID de proveedor de datos y un ID de usuario. Estos pares clave-valor vinculan los ID de proveedor a los ID de usuario. Envían datos durante las llamadas de evento, para eventos de sincronización entrantes y para llamadas de ID. Sin ellos, Audience Manager y otros servicios o funciones no tendrían una forma de hacer coincidir y sincronizar los ID. Estas variables a veces se expresan con o sin el prefijo d_ como se muestra a continuación. Tenga en cuenta que en el código, cursiva indica un marcador de posición de variable.

Variable Sintaxis

ID del proveedor de datos (DPID)

  • d_dpid=data provider ID
  • dpid=data provider ID

ID de usuario único del proveedor de datos (DPUUID)

  • d_dpuuid=data provider unique user ID
  • dpuuid=data provider unique user ID

Estos pares clave-valor siguen funcionando, pero ya no se utilizan. Debe actualizar su código para que utilice CID o CID_IC en su lugar.

CID y CID_IC: Acerca de

Los pares clave-valor CID y CID_IC reemplazan a DPID y DPUUID. Proporcionan las mismas funciones que el DPID y el DPUUID, pero son más eficientes porque incluyen el ID del proveedor de datos (o código de integración) y el ID de usuario en un único par de clave-valor. En cada par clave-valor:

  • El símbolo = separa la clave de sus valores relacionados.
  • El carácter ASCII no imprimible %01 separa los valores.

d_cid y d_cid_ic utilice la sintaxis que se muestra a continuación. Tenga en cuenta que en el código, cursiva indica un marcador de posición de variable.

Variable Sintaxis

ID de cliente (CID)

d_cid=data provider ID%01user ID

Código de integración de ID de cliente (CID_IC)

d_cid_ic=integration code%01user ID

Un código de integración es un ID alternativo que puede usar en lugar del ID de fuente de datos, asignado por el Audience Manager. Consulte Crear una fuente de datos si necesita configurar un código de integración.

Consulte también Variables de URL y Sintaxis para ID declarados.

NOTA

Puede utilizar códigos de integración para sus propias fuentes de datos y para fuentes de datos compartidas globales a las que tiene acceso. Por ejemplo, puede utilizar códigos de integración al trabajar con fuentes de datos de identificadores móviles. Utilice los siguientes códigos de integración, exactamente como se especifica a continuación:

  • DSID_20914 para GAID, que representa los dispositivos que ejecutan el sistema operativo Android.
  • DSID_20915 para IDFA, que representa los dispositivos que ejecutan el sistema operativo iOS.

Ejemplos

En la tabla siguiente se proporcionan ejemplos por tipo de evento.

Tipo de evento Ejemplo

Evento

  • Nueva API denominada: .../event?d_cid=123%01987...
  • obsoleto: .../event?d_dpid=123&d_dpuuid=987...

Sincronización de entrada (IBS)

  • Nueva API denominada: .../ibs:d_cid=123%01987...
  • obsoleto: .../ibs:d_dpid=123&d_dpuuid=987

Generar UUID de Audience Manager (ID)

  • Nueva API denominada: .../id?d_cid=123%01987...
  • obsoleto: .../id?d_dpid=123&d_dpuuid=987

Cada llamada también puede incluir varios pares de clave-valor d_cid y d_cid_ic como este:

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

Consideraciones importantes para los equipos de desarrollo

Elemento

Descripción

Codificación de URL

Sus equipos de desarrollo deben aplicar codificación de URL a las siguientes variables en el par clave-valor CID:

  • user ID (dpuuid)
  • integration code

Nota: Debe codificar la dirección URL del ID de usuario y el código de integración antes de concatenarlos en una cadena. Esto se debe a que el carácter ASCII %01 que separa las dos variables no debe capturarse en la codificación URL.

La codificación URL garantiza que los ID de usuario y los códigos de integración que contienen caracteres reservados o no seguros, como + o =, se transmitan correctamente a nuestros servidores.

Utilice la tabla de codificación ASCII para referencia.

Uso de códigos de integración para fuentes de datos compartidas globales

Puede utilizar códigos de integración para sus propias fuentes de datos y para fuentes de datos compartidas globales, a las que tiene acceso. Por ejemplo, puede utilizar códigos de integración al trabajar con fuentes de datos de identificadores móviles. Utilice los siguientes códigos de integración, exactamente como se especifica a continuación:

  • DSID_20914 para GAID, que representa los dispositivos que ejecutan el sistema operativo Android.
  • DSID_20915 para IDFA, que representa los dispositivos que ejecutan el sistema operativo iOS.

En esta página