Show Menu
TEMAS×

Atributos admitidos para llamadas de API de DCS

Enumera y describe la sintaxis y los atributos admitidos (o pares de 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 atributos

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 clave Reservado para
c_
Atributos definidos por el cliente.
d_
Atributos de Audience Manager .
h_
Datos del 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 registrarán ni almacenarán en nuestro sistema. Por ejemplo: supongamos que tiene una característica definida como clientes = p_age<25 y que pasa p_age=23 en una llamada de evento. Dadas estas condiciones, el usuario que cumple los criterios de cualificación basados en la edad cumple los requisitos para la característica, pero el par clave-valor se pierde después de que Audience Manager recibe la solicitud y no se registra.

d_ Atributos

Todas estas opciones son opcionales, a menos que desee una respuesta del DCS. Si desea que el DCS usuario devuelva una respuesta, entonces d_rtbd=json es necesario.
Atributo Descripción
d_caller
Se utiliza para identificar al llamador que realiza la llamada a la API de DCS .
d_cb
Especifica una función de JavaScript que se desea ejecutar utilizando la respuesta DCS como parámetro de función de la función de llamada de retorno.
d_cid
Contiene uno o varios pares de ID de proveedores de datos ( DPID ) e ID de usuarios de proveedores de datos ( DPUUID ) asignados por Audience Manager . Si utiliza varios pares de DPID y DPUUID, separe cada par con el carácter no imprimible %01 . Por ejemplo: DPID %01 DPUUID .
d_cid reemplaza a d_dpid y d_dpuuid , que están en desuso pero siguen siendo compatibles. Consulte CID sustituye DPID y DPUUID .
d_cid_ic
Contiene un código de integración y un ID de usuario único asociado en un solo par clave-valor.
d_cid_ic reemplaza a d_dpid y d_dpuuid , que están en desuso pero siguen siendo compatibles. Consulte CID sustituye DPID y DPUUID .
d_coppa
Deshabilite 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 ID de Adobe Experience Cloud y depende de la configuración idSyncDisable3rdPartySyncing . See COPPA Support in the Experience Cloud ID Service .
d_cts=1
d_cts=2
Opcional. Habilitado 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 las características y los segmentos deben devolverse dentro de la respuesta JSON .
  • d_cts=1 devuelve ID de segmentos heredados para los segmentos.
  • d_cts=2 devuelve ID de segmento para los segmentos.
Una respuesta de muestra podría tener el aspecto siguiente:
{ "material": [], "uuid": "07955261652886032950143702505894272138", "dcs_region": 7 , "características": [420020, 5421506], "segmentos": [984263, 985264], "tid": "ss3OTqPiQp0=" }
d_dpid
Obsoleta. Consulte d_cid y d_cid_ic .
d_dpuuid
Obsoleta. Consulte d_cid y d_cid_ic .
d_dst=1
Devuelve los datos de destino de la dirección URL en la respuesta JSON .
d_dst_filter
d_dst_filter es un atributo reservado que se utiliza en la integración entre Adobe Analytics y Audience Manager.
Se recomienda no crear características que utilicen atributos reservados. Adobe puede cambiar los atributos reservados en cualquier momento.
d_jsonv=1|0
Indica la versión JSON que se va a usar en la respuesta. Normalmente, debe configurarlo en d_jsonv=1 . Al establecer d_jsonv=0 se deshabilitan las sincronizaciones de ID.
d_mid
Especifica el ID de Experience Cloud definido y utilizado por el servicio de ID de Experience Cloud . For more information about the ECID, see Cookies and the Experience Cloud ID .
d_nsid
Nombre del ID del espacio. Indica qué contenedor JavaScript se utiliza. Utilizado por DIL para la sincronización de ID.
d_ptfm
Permite a 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 que se utiliza en la integración heredada entre Adobe Analytics y Audience Manager .
Se recomienda no crear características que utilicen atributos reservados. Adobe puede cambiar los atributos reservados en cualquier momento.
d_rtbd=json
Necesario si desea una respuesta JSON del DCS .
  • Si omite esto, el DCS devuelve 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.
{ "material": [], "uuid": "22920112968019678612904394744954398990", "dcs_region": 7 "tid": "ss3OTqPiQp0=" }
d_sid
SID significa ID de puntuación. Se trata de una ID única para una característica o un segmento.
d_tdpid
Pasa un origen de datos para la evaluación de características. Solo se evalúan las características de esta fuente de datos.
Por ejemplo, supongamos que tiene:
  • Característica T1 con:
  • Regla de características: " key1 == val1 "
  • Fuente de datos ( DPID ): 1
  • Código de integración DPID: ic1
  • Característica T2 con:
  • Regla de características: " key2 == val2 "
  • Fuente de datos (DPID): 2
  • Código de integración DPID: ic2
En una llamada de muestra, yourcompany.demdex.net/event?key1=val1&key2=val2&d_tdpid=1 , solo se devuelve la característica 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 las características descritas anteriormente, considere la llamada de muestra:
Para yourcompany.demdex.net/event?key1=val1&key2=val2&d_tdpid_ic=ic2 , solo se devuelve la característica T2.
d_uuid
ID de usuario único. Identifica a un visitante cuando este valor no está disponible desde una cookie.