Attributs pris en charge pour les appels DCS API supported-attributes-for-dcs-api-calls
Répertorie et décrit la syntaxe et les attributs pris en charge (ou paires clé-valeur) que vous pouvez transmettre à 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’attributs attribute-prefixes
DCS repose sur des préfixes spécifiques ajoutés aux clés des paires clé-valeur pour classer le type de données que vous transmettez.
c_
d_
h_
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 ni enregistrées dans notre système. Par exemple, supposons que vous ayez une caractéristique définie comme customers = p_age<25
et que vous transmettiez p_age=23
dans un appel d’événement. Dans ces conditions, l’utilisateur qui répond aux critères de qualification en fonction de l’âge est admissible pour la caractéristique, mais la paire clé-valeur est supprimée après que Audience Manager a reçu la demande et n’a pas été enregistrée.
d_ Attributs d-attributes
Toutes ces options sont facultatives, sauf si vous souhaitez obtenir une réponse de la part de DCS. Si vous souhaitez que DCS renvoie une réponse, d_rtbd=json
est requis.
d_caller
d_cb
d_cid
Contient une ou plusieurs paires d’identifiants de fournisseur de données ( DPID
) et d’identifiants d’utilisateur de fournisseur de données ( DPUUID
) attribués par Audience Manager. Si vous utilisez plusieurs paires DPID
s et DPUUID
, séparez chaque paire par le caractère non imprimable %01
. 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 identifiant 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
idSyncDisable3rdPartySyncing
. Voir Prise en charge de la loi COPPA dans le service Adobe Experience Platform Identity.d_cts=1
d_cts=2
Facultatif. Activé à la demande du client. Contactez votre conseiller 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
.
-
d_cts=1
renvoie ID de segment hérités pour les segments. -
d_cts=2
renvoie les identifiants de segment des segments.
Voici un exemple de réponse :
{ "stuff": [], "uuid": "07955261652886032950143702505894272138", "dcs_region": 7, "traits": [420020, 5421506], "segments": [984263, 985264], "tid": "ss3OTqPiQp0=" }
d_dpid
d_cid
et d_cid_ic
.d_dpuuid
d_cid
et d_cid_ic
.d_dst=1
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
JSON
à utiliser dans la réponse. Normalement, vous devez définir cette valeur sur d_jsonv=1
. Le paramètre d_jsonv=0
désactive les synchronisations des identifiants.d_mid
d_nsid
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 une réponse JSON
du DCS.
- Si vous omettez cela, le DCS renvoie un pixel dans l’en-tête.
- Si vous incluez ceci, 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 score ID. 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 ayez :
- Caractéristique T1 avec :
- Règle de caractéristique : "
key1 == val1
" - Source de données ( DPID) : 1
- Code d’intégration DPID : ic1
- Caractéristique 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 :
Pour yourcompany.demdex.net/event?key1=val1&key2=val2&d_tdpid_ic=ic2
, seule la caractéristique T2 est renvoyée.
d_uuid
h_ Attributs
Ces en-têtes contiennent des informations telles que des requêtes de données et de réponses dans un appel HTTP.
h_host
host name .demdex.net
. Voir Signification des appels vers le domaine Demdex.h_user-agent
User-Agent
.h_accept-language
Accept-Language
.h_referer
Referer
.h_referrer
Referrer
.h_date
Date
.