Attributs pris en charge pour DCS API Appels 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 à la variable Data Collection Servers (DCS). Ces informations peuvent vous aider à formater votre DCS demande et comprend les paramètres renvoyés par ce système.

Préfixes d’attributs 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 de clé
Réservé à
c_
Attributs définis par le client.
d_
Audience Manager attributs.
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 une p_ préfixe. 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 qu’une caractéristique soit définie comme customers = p_age<25 et vous passez 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 abandonnée après la suppression de la variable Audience Manager reçoit la demande et n’est pas consigné.

d_ Attributs d-attributes

Toutes ces options sont facultatives, sauf si vous souhaitez obtenir une réponse de la DCS. Si vous souhaitez que la variable DCS pour renvoyer une réponse, puis d_rtbd=json est obligatoire.

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

Contient une ou plusieurs paires d’identifiants de fournisseur de données ( DPID) et les identifiants utilisateur des fournisseurs de données ( DPUUID) affectée par Audience Manager. Si vous utilisez plusieurs paires DPIDs et DPUUIDs, 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
Désactivez l’utilisation de cookies tiers pour se conformer aux réglementations de protection de l’enfant. Ce paramètre est défini dynamiquement par le service Adobe Experience Platform Identity Adobe et dépend de la variable idSyncDisable3rdPartySyncing configuration. 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 variable JSON réponse.

  • 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
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 d’URL dans la variable 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 variable JSON version à utiliser dans la réponse. Normalement, vous devez définir cette valeur sur d_jsonv=1. Paramètre d_jsonv=0 désactive les synchronisations des identifiants.
d_mid
Indique l’ID d’Experience Cloud défini et utilisé par le Experience Cloud Service d’ID. Pour plus d’informations sur l’ECID, voir Cookies et service Identity Experience Cloud.
d_nsid
Nommez ID d’espace. Indique le conteneur JavaScript 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’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 JSON réponse de la DCS.

  • Si vous l’omettez, la variable DCS renvoie un pixel dans l’en-tête.
  • Si vous incluez ce paramètre, la variable DCS renvoie une 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.

Par exemple, supposons que vous ayez :

  • Caractéristique T1 par :
  • Règle de caractéristique : " key1 == val1"
  • Source de données ( DPID) : 1
  • Code d’intégration DPID : ic1
  • Caractéristique T2 par :
  • 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 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, 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
Identifiant utilisateur unique. Identifie un visiteur lorsque cette valeur n’est pas disponible dans un cookie.

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.

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