CID sustituye DPID y DPUUID cid-replaces-dpid-and-dpuuid

Actualice el código para que use 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 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 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 ú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 utilizan 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 identificador alternativo que puede usar en lugar del ID de Data Source, asignado por el Audience Manager . Consulte Crear un Source de datos si necesita configurar un código de integración.

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

NOTE
Puede usar códigos de integración para sus propias fuentes de datos y para las 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 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
  • Nuevo: .../event?d_cid=123%01987...
  • Obsoleto: .../event?d_dpid=123&d_dpuuid=987...
Sincronización entrante (IBS)
  • Nuevo: .../ibs:d_cid=123%01987...
  • Obsoleto: .../ibs:d_dpid=123&d_dpuuid=987
Generar UUID de Audience Manager (ID)
  • Nuevo: .../id?d_cid=123%01987...
  • Obsoleto: .../id?d_dpid=123&d_dpuuid=987

Cada llamada también puede incluir varios pares de valor clave d_cid y d_cid_ic de esta manera:

...?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 deben aplicar la codificación de URL a las siguientes variables en el par clave-valor de CID:

  • user ID (dpuuid)
  • integration code

Nota: debe codificar mediante URL el identificador 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 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.

Use la tabla de codificación ASCII como referencia.

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

Puede usar códigos de integración para sus propios orígenes de datos y para los orígenes de datos compartidos globales, a los 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 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