Envoyer des données au serveur de collecte de données send-data-to-the-dcs
Commencez ici pour plus d’informations sur la manière d’effectuer des appels /event au DCS . Cette section contient des informations sur la syntaxe de l’appel, les paramètres, la mise en forme et un exemple de requête.
Syntaxe de l'appel dcs-call-syntax
Une chaîne de URL de base qui envoie des données à l’DCS utilise la syntaxe présentée ci-dessous.
https://domain_alias.demdex.net/event?key1=val1&key2=val2&d_dst=1&d_rtbd=json&d_cb=callback
POST . La syntaxe de l’appel est décrite dans Méthodes de l’API DCS.Paramètres d’appel dcs-call-parameters
Le tableau suivant définit les composants de base d’un appel DCS simple.
domain alias.demdex.netCette 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.
/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 DCS.
keyIdentifiant unique dans la paire clé-valeur.
Ces paires clé-valeur utilisent un préfixe spécifique pour identifier le type de données que vous envoyez au DCS. Pour plus d’informations, voir des attributs pris en charge pour les appels API DCS.
valValeur de variable appartenant à un ensemble défini par une clé dans la paire clé-valeur.
Lorsque vous utilisez des valeurs :
- Placez les données de chaîne entre guillemets doubles (par exemple,
age="41 to 55"). - Vous pouvez transmettre plusieurs clés sur une seule valeur (par exemple,
key=val1,val2,val3).
Voir Formatage des paires clé-valeur dans les appels DCS.
d_dst=1d_rtbd=jsond_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 d’appel dcs-sample-call
Cet exemple montre la société fictive Acme, Inc. envoyant des données au DCS via un appel HTTP. Notez que cet appel inclut les paramètres facultatifs d_dst=1, d_rtbd=json et d_cb=callback. Elles indiquent que Acme souhaitez recevoir une réponse JSON de la DCS avec une fonction d’appel. N'oubliez pas que ce n'est qu'un exemple. Ne coupez pas et ne collez pas ce code.
https://acme_aam_domain.demdex.net/event?videoTypeID=2&data=moarData&d_dst=1&d_rtbd=json&d_cb=acme_callback
Étapes suivantes dcs-next-steps
Maintenant que vous connaissez l’envoi de données au DCS, il est temps d’examiner comment récupérer les données et analyser ces informations. Voir Recevoir des données du serveur de collecte de données.