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_callerd_cbd_cidContient 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_icContient 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_coppaidSyncDisable3rdPartySyncing. 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=1renvoie identifiants de segment hérités pour les segments. -
d_cts=2renvoie 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_dpidd_cid et d_cid_ic.d_dpuuidd_cid et d_cid_ic.d_dst=1JSON.d_dst_filterd_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|0JSON à 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_midd_nsidd_ptfmPermet à Audience Manager de distinguer les requêtes mobiles des requêtes de bureau. Les valeurs acceptables sont :
iosandroidbrowserall
d_rsObsolè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=jsonObligatoire 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
JSONdans 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_sidSID signifie identifiant de score. Il s’agit d’un identifiant unique pour une caractéristique ou un segment.d_tdpidTransmet 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_icL'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_uuidh_ Attributes
Ces en-têtes contiennent des informations telles que des demandes de données et de réponses dans un appel HTTP.
h_hosthost name .demdex.net. Voir Signification des appels vers le domaine Demdex.h_user-agentUser-Agent.h_accept-languageAccept-Language.h_refererReferer.h_referrerReferrer.h_dateDate.