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 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 clave-valor que contienen un ID de proveedor de datos y un ID de usuario. Estos pares clave-valor vinculan los ID de proveedor con los ID de usuario. Envían datos durante llamadas de evento, para eventos de sincronización entrantes y para llamadas de ID. Sin ellos, Audience Manager, y otros servicios o características, no tendrían una forma de coincidir y sincronizar los ID. Estas variables a veces se expresan con o sin el d_ como se muestra a continuación. Tenga en cuenta que, en el código, cursiva indica un marcador de posición variable.

Variable Sintaxis

ID del proveedor de datos (DPID)

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

ID único de usuario 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 están en desuso. Debe actualizar el 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 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 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 utilizar en lugar del ID de fuente de datos asignado por 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 las fuentes de datos compartidas, a la 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 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 entrante (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 varias 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

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

  • user ID (dpuuid)
  • integration code

Nota: Debe codificar mediante URL el ID de usuario y el código de integración antes 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 la dirección 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, entre otros, + o =, se transmitan correctamente a nuestros servidores.

Utilice el Tabla de codificación ASCII como referencia.

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

Puede utilizar códigos de integración para sus propias fuentes de datos y para las fuentes de datos compartidas, a la 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 dispositivos que ejecutan el sistema operativo iOS.

En esta página