CID sustituye DPID y DPUUID

Actualice el código para utilizarlo d_cid o d_cid_ic en lugar de d_dpid y d_dpuuid. Las variables DPID y DPUUID seguirán funcionando, pero debe considerarlas obsoletas. Esto incluye las variantes DPID y DPUUID sin el d_ prefix.

DPID y DPUUID: Una revisión

El DPID y el DPUUID son pares de clave-valor que contienen un ID de proveedor de datos y un ID de usuario. Estos pares de clave-valor vinculan los ID de proveedor a los ID de usuario. Envían datos durante llamadas de evento, para eventos de sincronización de entrada y para llamadas de ID. Sin ellos, ni Audience Managercon otros servicios o características, no habría una forma de hacer coincidir y sincronizar los ID. Estas variables se expresan a veces con o sin el d_ prefijo como se muestra a continuación. Note, in the code, italics indicates a variable placeholder.

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 de clave-valor siguen funcionando, pero están obsoletos. Debe actualizar el código para utilizar CID o CID_IC.

CID y CID_IC: Acerca de

Los pares de clave-valor CID y CID_IC reemplazan 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 del usuario en un solo 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. Note, in the code, italics indicates a variable placeholder.

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 utilizar en lugar del ID de fuente de datos, asignado por el Audience Manager. Consulte Creación de una fuente de datos si necesita configurar un código de integración.

Consulte también Variables de URL y Sintaxis de IDdeclarados.

Nota

Puede utilizar códigos de integración para sus propias fuentes de datos y para las fuentes de datoscompartidas globales, a las que tiene acceso. Por ejemplo, puede utilizar códigos de integración al trabajar con orígenes 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 d_cid y d_cid_ic pares de valor clave 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

Los 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: La dirección URL debe codificar el 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 de URL.

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

Utilice la tabla de codificación ASCII como referencia.

Uso de códigos de integración para orígenes de datos compartidos globales

Puede utilizar códigos de integración para sus propias fuentes de datos y para las fuentes de datos globales compartidas a las que tiene acceso. Por ejemplo, puede utilizar códigos de integración al trabajar con orígenes 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