Show Menu
SUJETS×

Attributs pris en charge pour les API appels

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

Préfixes d’attributs

Le module DCS repose sur des préfixes spécifiques ajoutés aux clés dans des paires clé-valeur pour classer le type de données que vous transmettez.
Préfixe de clé Réservé pour
c_
Attributs définis par le client.
d_
Attributs d’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 p_ préfixe. Les données privées sont utilisées pour l'évaluation des caractéristiques, mais elles ne seront ni enregistrées ni stockées dans notre système. Par exemple, supposons que vous ayez une caractéristique définie comme customers = p_age<25 et que vous la transmettiez p_age=23 dans un appel de événement. Compte tenu de ces conditions, l’utilisateur qui satisfait aux critères de qualification par âge est admissible pour la caractéristique, mais la paire clé-valeur est supprimée après que l’ Audience Manager a reçu la demande et n’a pas été enregistrée.

d_ Attributs

Toutes ces options sont facultatives, sauf si vous souhaitez obtenir une réponse de la part de la DCS. Si vous souhaitez que le DCS renvoie une réponse, d_rtbd=json il est nécessaire.
Attribut Description
d_caller
Utilisé pour identifier l’appelant qui effectue l’appel à l’API DCS .
d_cb
Spécifie une fonction JavaScript à 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 s et DPUUID s, séparez chaque paire par le caractère non imprimable %01 . Par exemple: DPID %01 DPUUUID .
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ésactiver l’utilisation de cookies tiers afin de se conformer aux règles de protection de l’enfance. Ce paramètre est défini dynamiquement par le service d’identité de l’Adobe Experience Platform Adobe et dépend de la idSyncDisable3rdPartySyncing configuration. Reportez-vous à la section Prise en charge COPPA dans Adobe Experience Platform Identity Service .
d_cts=1
d_cts=2
Facultatif. Activé sur demande du client. Contactez votre conseiller en Adobe Audience Manager ou le service à la clientèle.
Indique que les caractéristiques et les segments doivent être renvoyés dans la JSON réponse.
  • d_cts=1 renvoie des ID de segment hérités pour les segments.
  • d_cts=2 renvoie des ID de segment pour les segments.
Un exemple de réponse peut se présenter comme suit :
{     "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 JSON réponse.
d_dst_filter
d_dst_filter est un attribut réservé, utilisé dans l’intégration entre Adobe Analytics et l’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 JSON version à utiliser dans la réponse. Normalement, vous devez définir cette valeur sur d_jsonv=1 . La définition d_jsonv=0 désactive la synchronisation des identifiants.
d_mid
Indique l’ID d’Experience Cloud défini et utilisé par le service d’ID d’ Experience Cloud . Pour plus d’informations sur l’ECID, voir Cookies et Service d’identité Experience Cloud.
d_nsid
Nommer l’ID d’espace. Indique quel conteneur JavaScript est utilisé. Utilisé par DIL à pour la synchronisation des identifiants.
d_ptfm
Permet à l’Audience Manager de distinguer les demandes mobiles des demandes de bureau. Les valeurs acceptables sont :
  • ios
  • android
  • browser
  • all
d_rs
Obsolète. d_rs est un attribut réservé, utilisé dans l’intégration héritée 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 obtenir une JSON réponse du serveur de collecte de données .
  • Si vous l’omettez, le serveur de collecte de données renvoie un pixel dans l’en-tête.
  • Si vous incluez ceci, le serveur de collecte de données renvoie un JSON objet dans le corps de la réponse. Consultez l’exemple ci-dessous. Votre réponse pourrait être plus complexe.
{     "stuff": [],     "uuid": "22920112968019678612904394744954398990",     "dcs_region": 7,     "tid": "ss3OTqPiQp0=" }
d_sid
SID correspond à l’ID 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.
Par exemple, supposons que vous possédiez :
  • Caractéristique T1 avec :
  • Règle de caractéristiques : " key1 == val1 "
  • Source de données ( DPID ) : 1
  • Code d'intégration DPID : ic1
  • Caractéristique T2 avec :
  • Règle de caractéristiques : " 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 d_tdpid paramètre 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, tenez compte de l’appel d’exemple :
En effet, yourcompany.demdex.net/event?key1=val1&key2=val2&d_tdpid_ic=ic2 seul le trait T2 est renvoyé.
d_uuid
ID utilisateur unique. Identifie un visiteur lorsque cette valeur n’est pas disponible à partir d’un cookie.