Envoi de données au DCS send-data-to-the-dcs
Pour plus d’informations sur les appels /event à DCS, commencez ici . Cette section contient des informations sur la syntaxe des appels, les paramètres, le formatage et un exemple de requête.
Syntaxe des appels dcs-call-syntax
Une chaîne URL de base qui envoie des données à DCS utilise la syntaxe illustré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 d’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 :
- Votre alias de domaine attribué par Audience Manager (par exemple,
my_domain.demdex.net). - Domaine de destination, qui est toujours
demdex.net. Voir Signification des appels vers le domaine Demdex.
/event?Cette partie de l’appel :
- Identifie l’appel en tant qu’appel d’événement.
- Définit le début de la chaîne d’URL qui contient les données que vous souhaitez 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 Attributs pris en charge pour les appels de l’API DCS.
valUne valeur de variable qui appartient à un jeu 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).
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 présente la société fictive Acme, Inc. envoyant des données à DCS via un appel HTTP. Notez que cet appel comprend les paramètres facultatifs d_dst=1, d_rtbd=json et d_cb=callback. Elles indiquent que Acme souhaite recevoir une réponse JSON de DCS avec une fonction de rappel. Rappelez-vous, 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 êtes familiarisé avec l’envoi de données à DCS, il est temps d’examiner comment récupérer des données et d’analyser ces informations. Voir Réception de données du DCS.