Atributos admitidos para DCS API llamadas

Última actualización: 20 de julio de 2024

Enumera y describe la sintaxis y los atributos admitidos (o pares clave-valor) que puede pasar a Data Collection Servers (DCS). Esta información puede ayudarle a dar formato a sus DCS solicitudes y a comprender los parámetros devueltos por este sistema.

Prefijos de atributo

El DCS se basa en prefijos específicos agregados a las claves en pares clave-valor para clasificar el tipo de datos que está pasando.

Prefijo de claveReservado para
c_Atributos definidos por el cliente.
d_atributos del Audience Manager .
h_Datos de encabezado HTTP.
p_

Atributos privados definidos por el cliente.

El DCS acepta sus propios datos privados cuando la clave tiene un prefijo p_. Los datos privados se utilizan para la evaluación de características, pero no se registran ni almacenan en nuestro sistema. Por ejemplo, supongamos que tiene un rasgo definido como customers = p_age<25 y pasa p_age=23 en una llamada de evento. Dadas estas condiciones, el usuario que cumple los criterios de clasificación por edad cumple los requisitos para el rasgo, pero el par clave-valor se abandona después de que Audience Manager reciba la solicitud y no se registre.

Atributos de d_

Todos son opcionales, a menos que desee una respuesta de DCS. Si desea que DCS devuelva una respuesta, se requiere d_rtbd=json.

AtributoDescripción
d_callerSe usa para identificar al llamador que realiza la llamada a la API DCS.
d_cbEspecifica una función de JavaScript que desea ejecutar con la respuesta DCS como parámetro de función de la función de devolución de llamada.
d_cid

Contiene uno o más pares de identificadores de proveedor de datos ( DPID) e identificadores de usuario de proveedor de datos ( DPUUID) asignados por Audience Manager. Si usa varios pares de DPID y DPUUID, separe cada par con el carácter no imprimible %01. Por ejemplo: DPID%01DPUUUID.

d_cid reemplaza a d_dpid y a d_dpuuid, que están en desuso pero siguen siendo compatibles. Consulte CID reemplaza DPID y DPUUID.

d_cid_ic

Contiene un código de integración y un ID de usuario único asociado en un único par clave-valor.

d_cid_ic reemplaza a d_dpid y a d_dpuuid, que están en desuso pero siguen siendo compatibles. Consulte CID reemplaza DPID y DPUUID.

d_coppaDeshabilite el uso de cookies de terceros para cumplir con las regulaciones de protección infantil. Este parámetro lo establece dinámicamente el servicio de identidad de Adobe Experience Platform de Adobe y depende de la configuración de idSyncDisable3rdPartySyncing. Consulte Compatibilidad con COPPA en el servicio de identidad de Adobe Experience Platform.

d_cts=1

d_cts=2

Opcional. Activado a petición del cliente. Póngase en contacto con su asesor de Adobe Audience Manager o con el Servicio de atención al cliente.

Indica que los rasgos y segmentos deben devolverse dentro de la respuesta JSON.

Una respuesta de ejemplo podría parecerse a la de abajo:

{     "stuff": [],     "uuid": "07955261652886032950143702505894272138",     "dcs_region": 7,     "traits": [420020, 5421506],     "segments": [984263, 985264],     "tid": "ss3OTqPiQp0=" }

d_dpidObsoleta. Ver d_cid y d_cid_ic.
d_dpuuidObsoleta. Ver d_cid y d_cid_ic.
d_dst=1Devuelve datos de destino de URL en la respuesta JSON.
d_dst_filter

d_dst_filter es un atributo reservado, utilizado en la integración entre Adobe Analytics y Audience Manager.

Se recomienda no crear rasgos que utilicen atributos reservados. El Adobe puede cambiar los atributos reservados en cualquier momento.

d_jsonv=1|0Indica la versión de JSON que se va a usar en la respuesta. Normalmente, debe establecer esto en d_jsonv=1. La configuración d_jsonv=0 deshabilita la sincronización de ID.
d_midEspecifica el identificador de Experience Cloud establecido y utilizado por el servicio de identificador Experience Cloud. Para obtener más información sobre el ECID, consulte cookies y el servicio de identidad del Experience Cloud.
d_nsidIdentificador de espacio de nombre. Indica qué contenedor de JavaScript se utiliza. Utilizado por el DIL para la sincronización de ID.
d_ptfm

Permite al Audience Manager distinguir las solicitudes móviles de las solicitudes de escritorio. Los valores admitidos son:

  • ios
  • android
  • browser
  • all
d_rs

Obsoleta. d_rs es un atributo reservado, usado en la integración heredada entre Adobe Analytics y Audience Manager.

Se recomienda no crear rasgos que utilicen atributos reservados. El Adobe puede cambiar los atributos reservados en cualquier momento.

d_rtbd=json

Requerido si desea una respuesta de JSON del DCS .

  • Si omite esto, el DCS de devolverá un píxel en el encabezado.
  • Si incluye esto, el DCS devuelve un objeto JSON en el cuerpo de la respuesta. Consulte el ejemplo siguiente. Su respuesta podría ser más compleja.

{     "stuff": [],     "uuid": "22920112968019678612904394744954398990",     "dcs_region": 7,     "tid": "ss3OTqPiQp0=" }

d_sidSID significa ID de puntuación. Se trata de un ID único para un rasgo o un segmento.
d_tdpid

Pasa una fuente de datos para la evaluación de características. Solo se evalúan los rasgos de esta fuente de datos.

Por ejemplo, supongamos que tiene:

  • Rasgo T1 con:
  • Regla de rasgos: " key1 == val1"
  • Source de datos ( DPID): 1
  • Código de integración DPID: ic1
  • Rasgo T2 con:
  • Regla de rasgos: " key2 == val2"
  • Data Source (DPID): 2
  • Código de integración DPID: ic2

En una llamada de ejemplo, yourcompany.demdex.net/event?key1=val1&key2=val2&d_tdpid=1, solo se devuelve el rasgo T1.

d_tdpid_ic

El propósito es idéntico al parámetro d_tdpid descrito anteriormente. Sin embargo, en este caso, la fuente de datos se pasa mediante el código de integración.

Para mantener los rasgos descritos anteriormente, considere la llamada de muestra:

Para yourcompany.demdex.net/event?key1=val1&key2=val2&d_tdpid_ic=ic2, solo se devuelve el rasgo T2.

d_uuidID de usuario único. Identifica a un visitante cuando este valor no está disponible en una cookie.