Enviar dados para o DCS send-data-to-the-dcs
Comece aqui para obter informações sobre como fazer chamadas /event
para o DCS. Esta seção inclui informações sobre sintaxe de chamada, parâmetros, formatação e um exemplo de solicitação.
Sintaxe de chamada dcs-call-syntax
Uma cadeia de caracteres básica URL
que envia dados para DCS usa a sintaxe mostrada abaixo.
https://domain_alias.demdex.net/event?key1=val1&key2=val2&d_dst=1&d_rtbd=json&d_cb=callback
POST
. A sintaxe de chamada é descrita em Métodos da API DCS.Parâmetros de chamada dcs-call-parameters
A tabela a seguir define os componentes básicos de uma chamada DCS simples.
domain alias.demdex.net
Esta parte da chamada contém:
- Seu alias de domínio atribuído por Audience Manager (por exemplo,
my_domain.demdex.net
). - O domínio de destino, que é sempre
demdex.net
. Consulte Compreendendo as chamadas para o domínio Demdex.
/event?
Esta parte da chamada:
- Identifica a chamada como uma chamada de evento.
- Define o início da cadeia de caracteres da URL que contém os dados que você deseja enviar para o DCS.
key
Um identificador exclusivo no par de valor-chave.
Esses pares de valores chave usam um prefixo específico para identificar o tipo de dados que você está enviando ao DCS. Para obter mais informações, consulte Atributos com Suporte para Chamadas de API DCS.
val
Um valor de variável que pertence a um conjunto definido por uma chave no par de valores chave.
Ao trabalhar com valores:
- Coloque os dados da cadeia de caracteres entre aspas duplas (por exemplo,
age="41 to 55"
). - Você pode passar várias chaves em um único valor (por exemplo,
key
=val1,val2,val3
).
Consulte Formatação de Pares de Valores-Chave em Chamadas DCS.
d_dst=1
d_rtbd=json
d_cb=callback
Parâmetros de resposta opcionais.
Nenhum deles é necessário para enviar dados ao DCS. No entanto, se você quiser que o DCS retorne uma resposta, você deve incluir d_rtbd=json
em sua solicitação.
Consulte Pares de Valor-Chave.
Exemplo de chamada dcs-sample-call
Este exemplo mostra a empresa fictícia Acme, Inc. enviando dados para DCS através de uma chamada HTTP. Observe que esta chamada inclui os parâmetros opcionais d_dst=1
, d_rtbd=json
e d_cb=callback
. Isso indica que Acme deseja receber uma resposta JSON de DCS com uma função de retorno de chamada. Lembrem-se, isso é apenas um exemplo. Não recorte e cole esse código.
https://acme_aam_domain.demdex.net/event?videoTypeID=2&data=moarData&d_dst=1&d_rtbd=json&d_cb=acme_callback
Próximas etapas dcs-next-steps
Agora que você está familiarizado com o envio de dados para o DCS, é hora de examinar como obter dados dele e analisar essas informações. Consulte Receber dados do DCS.