CID sustituye DPID y DPUUID cid-replaces-dpid-and-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 dpid-dpuuid-review

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 cid-cidic-about

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.

NOTE
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 dev-considerations

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.
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695