Attributs pris en charge pour les appels de DCS API supported-attributes-for-dcs-api-calls

Répertorie et décrit la syntaxe et les attributs pris en charge (ou les paires clé-valeur) que vous pouvez transmettre au Data Collection Servers (DCS). Ces informations peuvent vous aider à formater vos requêtes DCS et à comprendre les paramètres renvoyés par ce système.

Préfixes d’attribut attribute-prefixes

Le DCS repose sur des préfixes spécifiques ajoutés aux clés dans les paires clé-valeur pour classer le type de données que vous transmettez.

Préfixe Clé
Réservé Pour
c_
Attributs définis par le client.
d_
les attributs Audience Manager.
h_
Données d’en-tête HTTP.
p_

Attributs privés définis par le client.

Le serveur de collecte de données accepte vos propres données privées lorsque la clé comporte un préfixe p_. Les données privées sont utilisées pour l'évaluation des caractéristiques, mais elles ne seront pas consignées ni stockées dans notre système. Supposons, par exemple, que vous ayez une caractéristique définie comme customers = p_age<25 et que vous transmettiez des p_age=23 dans un appel d’événement. Compte tenu de ces conditions, l’utilisateur qui répond aux critères de qualification basés sur l’âge est qualifié pour la caractéristique, mais la paire clé-valeur est abandonnée après réception de la demande par Audience Manager et n’est pas consignée.

d_ Attributs d-attributes

Tous ces éléments sont facultatifs, à moins que vous ne souhaitiez une réponse du DCS. Si vous souhaitez que le DCS renvoie une réponse, d_rtbd=json est obligatoire.

Attribut
Description
d_caller
Utilisé pour identifier l’appelant qui effectue l’appel à l’API DCS.
d_cb
Spécifie une fonction JavaScript que vous souhaitez exécuter à l’aide de la réponse DCS en tant que paramètre de fonction de la fonction de rappel.
d_cid

Contient une ou plusieurs paires d’ID de fournisseur de données ( DPID) et d’ID d’utilisateur de fournisseur de données ( DPUUID) attribuées par Audience Manager. Si vous utilisez plusieurs paires de DPID et de DPUUID, séparez chaque paire par le %01 de caractères non imprimables. Par exemple : DPID%01DPUUUID.

d_cid remplace d_dpid et d_dpuuid, qui sont obsolètes mais toujours pris en charge. Voir CID remplace DPID et DPUUID.

d_cid_ic

Contient un code d’intégration et un ID utilisateur unique associé dans une seule paire clé-valeur.

d_cid_ic remplace d_dpid et d_dpuuid, qui sont obsolètes mais toujours pris en charge. Voir CID remplace DPID et DPUUID.

d_coppa
Désactivez l’utilisation des cookies tiers afin de respecter les réglementations relatives à la protection des enfants. Ce paramètre est défini de manière dynamique par le service d’identités d’Adobe Adobe Experience Platform et dépend de la configuration idSyncDisable3rdPartySyncing. Voir Prise charge de la loi COPPA dans le service d’identités Adobe Experience Platform.

d_cts=1

d_cts=2

Facultatif. Activé à la demande du client. Contactez votre consultant Adobe Audience Manager ou l’assistance clientèle.

Indique que les caractéristiques et les segments doivent être renvoyés dans la réponse JSON.

Un exemple de réponse peut ressembler à celui ci-dessous :

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

d_dpid
Obsolète. Voir d_cid et d_cid_ic.
d_dpuuid
Obsolète. Voir d_cid et d_cid_ic.
d_dst=1
Renvoie les données de destination de l’URL dans la réponse JSON.
d_dst_filter

d_dst_filter est un attribut réservé, utilisé dans l’intégration entre Adobe Analytics et Audience Manager.

Nous vous déconseillons de créer des caractéristiques qui utilisent des attributs réservés. Adobe peut modifier les attributs réservés à tout moment.

d_jsonv=1|0
Indique la version JSON à utiliser dans la réponse. Normalement, vous devez définir ce paramètre sur d_jsonv=1. La définition de d_jsonv=0 désactive les synchronisations des identifiants.
d_mid
Spécifie l'Experience Cloud ID défini et utilisé par le service Experience Cloud ID. Pour plus d’informations sur l’ECID, voir Cookies et service d’identités Experience Cloud.
d_nsid
Identifiant de l’espace de noms. Indique quel conteneur JavaScript est utilisé. Utilisé par DIL pour la synchronisation des identifiants.
d_ptfm

Permet à Audience Manager de distinguer les requêtes mobiles des requêtes de bureau. Les valeurs acceptables sont :

  • ios
  • android
  • browser
  • all
d_rs

Obsolète. d_rs est un attribut réservé, utilisé dans l’ancienne intégration entre Adobe Analytics et Audience Manager.

Nous vous déconseillons de créer des caractéristiques qui utilisent des attributs réservés. Adobe peut modifier les attributs réservés à tout moment.

d_rtbd=json

Obligatoire si vous souhaitez une réponse JSON du DCS.

  • Si vous l’omettez, le DCS renvoie un pixel dans l’en-tête.
  • Si vous l’incluez, le DCS renvoie un objet JSON dans le corps de la réponse. Voir l’exemple ci-dessous. Votre réponse pourrait être plus complexe.

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

d_sid
SID signifie identifiant de score. Il s’agit d’un identifiant unique pour une caractéristique ou un segment.
d_tdpid

Transmet une source de données pour l’évaluation des caractéristiques. Seules les caractéristiques de cette source de données sont évaluées.

Supposons, par exemple, que vous ayez :

  • Trait T1 avec :
  • Règle de caractéristique : « key1 == val1 »
  • Source de données ( DPID) : 1
  • Code d'intégration DPID : ic1
  • Trait T2 avec :
  • Règle de caractéristique : « key2 == val2 »
  • Source de données (DPID) : 2
  • Code d'intégration DPID : ic2

Dans un exemple d’appel, yourcompany.demdex.net/event?key1=val1&key2=val2&d_tdpid=1, seule la caractéristique T1 est renvoyée.

d_tdpid_ic

L'objectif est identique au paramètre d_tdpid décrit ci-dessus. Cependant, dans ce cas, la source de données est transmise à l’aide du code d’intégration.

En conservant les caractéristiques décrites ci-dessus, considérez l’exemple d’appel :

Par yourcompany.demdex.net/event?key1=val1&key2=val2&d_tdpid_ic=ic2, seul le caractère T2 est renvoyé.

d_uuid
ID utilisateur unique. Identifie un visiteur ou une visiteuse lorsque cette valeur n’est pas disponible à partir d’un cookie.

h_ Attributes

Ces en-têtes contiennent des informations telles que des demandes de données et de réponses dans un appel HTTP.

Attribut
Description
h_host
Il est défini sur le nom d’hôte de collecte de données spécifique du client. Il apparaît comme host name .demdex.net. Voir Signification des appels vers le domaine Demdex.
h_user-agent
Définissez sur la valeur de l’en-tête User-Agent.
h_accept-language
Définissez sur la valeur de l’en-tête Accept-Language.
h_referer
Définissez sur la valeur de l’en-tête Referer.
h_referrer
Définissez sur la valeur de l’en-tête Referrer.
h_date
Définissez sur la valeur de l’en-tête Date.
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695