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.
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 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.
d_caller
d_cb
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
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
.
-
d_cts=1
renvoie identifiants de segment hérités pour les segments. -
d_cts=2
renvoie les identifiants des segments.
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
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 ce paramètre sur d_jsonv=1
. La définition de d_jsonv=0
désactive les synchronisations des identifiants.d_mid
d_nsid
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
h_ Attributes
Ces en-têtes contiennent des informations telles que des demandes 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
.