Effectuer des appels API DCS serveur à serveur making-server-to-server-dcs-api-calls
Les appels nécessitent le nom d’hôte du serveur DCS régional et l’ID utilisateur. Si vous ne disposez pas des ID d’utilisateur et de région requis, voir Obtenir les ID d’utilisateur et de région à partir d’une réponse DCS et/ou Experience Cloud. Une fois que vous disposez d’identifiants d’utilisateur et de région, vous pouvez effectuer des appels serveur à serveur vers le serveur de collecte de données. Reportez-vous à cette section pour consulter la syntaxe et des exemples.
Syntaxe d’appel et exemple call-syntax-example
Une requête de base serveur à serveur qui envoie des données à l’DCS utilise la syntaxe affichée ci-dessous.
"Host:domain_alias.demdex.net" "https://DCS_host_name.demdex.net/event?d_rtbd=json&d_jsonv=1&d_uuid=userID
Un exemple d’appel ressemble à l’exemple suivant.
"Host:foo.demdex.net" "https://usw2.demdex.net/event?d_rtbd=json&d_jsonv=1& d_uuid=123456789"`
Paramètres d’appel call-parameters
domain alias.demdex.net
Cette partie de l'appel contient :
- Alias de domaine attribué par Audience Manager (par exemple,
my_domain.demdex.net
). - Le domaine de destination, toujours
demdex.net
. Voir Signification des appels vers le domaine Demdex.
DCS host name.demdex.net
/event?
Cette partie de l’appel :
- Identifie l’appel comme un appel d’événement.
- Définit le début de la chaîne d’URL qui contient les données à envoyer au serveur de collecte de données.
d_uuid= Audience Manager user ID
Il s’agit de la clé d’ID utilisateur unique qui contient la valeur d’ID utilisateur Audience Manager dans une paire clé-valeur.
Utilisez d_uuid
si vous transmettez l’ID utilisateur Audience Manager.
d_mid=Experience Cloud user ID
Il s’agit de la clé d’ID utilisateur unique qui contient la valeur d’ID utilisateur Experience Cloud dans une paire clé-valeur. Voir aussi Obtenir l’ID utilisateur à partir du cookie du service d’ID.
Utilisez d_mid
si vous transmettez un identifiant Experience Cloud capturé à partir du service d’identification Experience Cloud .
d_dst=1
d_rtbd=json
d_cb=callback
Paramètres de réponse facultatifs.
Aucun de ces éléments n’est nécessaire pour envoyer des données au DCS. Cependant, si vous souhaitez que le DCS renvoie une réponse, vous devez inclure d_rtbd=json
dans votre requête.
Exemple de réponse sample-response
Voir Recevoir des données du serveur de collecte de données.