Atributos com Suporte para DCS Chamadas API supported-attributes-for-dcs-api-calls

Lista e descreve a sintaxe e os atributos suportados (ou pares de valores chave) que você pode passar para o Data Collection Servers (DCS). Essas informações podem ajudá-lo a formatar suas solicitações do DCS e compreender os parâmetros retornados por esse sistema.

Prefixos de atributo attribute-prefixes

O DCS depende de prefixos específicos adicionados às chaves em pares de valores chave para classificar o tipo de dados que você está transmitindo.

Prefixo da chave
Reservado para
c_
Atributos definidos pelo cliente
d_
atributos de Audience Manager.
h_
Dados do cabeçalho HTTP.
p_

Atributos privados definidos pelo cliente.

O DCS aceita os seus próprios dados privados quando a chave tem um prefixo p_. Os dados privados são usados para avaliação de características, mas não serão registrados nem armazenados em nosso sistema. Por exemplo, digamos que você tenha uma característica definida como customers = p_age<25 e passe p_age=23 em uma chamada de evento. Dadas essas condições, o usuário que atende aos critérios de qualificação com base na idade se qualifica para a característica, mas o par de valor-chave é descartado depois que Audience Manager recebe a solicitação e não é registrado.

d_ Atributos d-attributes

Tudo isso é opcional, a menos que você queira uma resposta de DCS. Se você quiser que DCS retorne uma resposta, d_rtbd=json será necessário.

Atributo
Descrição
d_caller
Usado para identificar o chamador que está fazendo a chamada para a API DCS.
d_cb
Especifica uma função JavaScript que você deseja executar usando a resposta DCS como parâmetro de função da função de retorno de chamada.
d_cid

Contém um ou mais pares de IDs de provedor de dados ( DPID) e IDs de usuário de provedor de dados ( DPUUID) atribuídos por Audience Manager. Se você usar vários pares de DPID e DPUUID, separe cada par com o caractere não imprimível %01. Por exemplo: DPID%01DPUUUID.

d_cid substitui d_dpid e d_dpuuid, que estão obsoletos, mas ainda têm suporte. Consulte CID substitui DPID e DPUUID.

d_cid_ic

Contém um código de integração e uma ID de usuário exclusiva associada em um único par de valor-chave.

d_cid_ic substitui d_dpid e d_dpuuid, que estão obsoletos, mas ainda têm suporte. Consulte CID substitui DPID e DPUUID.

d_coppa
Desative o uso de cookies de terceiros para estar em conformidade com as regulamentações de proteção para crianças. Este parâmetro é definido dinamicamente pelo Adobe Adobe Experience Platform Identity Service e depende da configuração idSyncDisable3rdPartySyncing. Consulte o Suporte para COPPA no Adobe Experience Platform Identity Service.

d_cts=1

d_cts=2

Opcional. Ativado mediante solicitação do cliente. Entre em contato com seu consultor da Adobe Audience Manager ou com o Atendimento ao cliente.

Indica que características e segmentos devem ser retornados dentro da resposta JSON.

Uma resposta de amostra pode ser semelhante à abaixo:

{     "stuff": [],     "uuid": "07955261652886032950143702505894272138",     "dcs_region": 7,     "traits": [420020, 5421506],     "segments": [984263, 985264],     "tid": "ss3OTqPiQp0=" }

d_dpid
Obsoleto. Consulte d_cid e d_cid_ic.
d_dpuuid
Obsoleto. Consulte d_cid e d_cid_ic.
d_dst=1
Retorna dados de destino de URL na resposta JSON.
d_dst_filter

d_dst_filter é um atributo reservado, usado na integração entre o Adobe Analytics e o Audience Manager.

Recomendamos não criar características que usem atributos reservados. O Adobe pode alterar os atributos reservados a qualquer momento.

d_jsonv=1|0
Indica a versão JSON a ser usada na resposta. Normalmente, você deve definir isso como d_jsonv=1. A configuração d_jsonv=0 desabilita sincronizações de ID.
d_mid
Especifica a ID de Experience Cloud definida e usada pelo serviço de ID de Experience Cloud . Para obter mais informações sobre a ECID, consulte Cookies e o Serviço de Identidade Experience Cloud.
d_nsid
ID de espaço de nome. Indica qual contêiner JavaScript é usado. Usado por DIL para sincronização de ID.
d_ptfm

Permite que o Audience Manager diferencie solicitações móveis de solicitações de desktop. Os valores compatíveis incluem:

  • ios
  • android
  • browser
  • all
d_rs

Obsoleto. d_rs é um atributo reservado, usado na integração herdada entre Adobe Analytics e Audience Manager.

Recomendamos não criar características que usem atributos reservados. O Adobe pode alterar os atributos reservados a qualquer momento.

d_rtbd=json

Necessário se você deseja uma resposta JSON do DCS.

  • Se você omitir isso, o DCS retornará um pixel no cabeçalho.
  • Se você incluir isso, o DCS retornará um objeto JSON no corpo da resposta. Veja o exemplo abaixo. Sua resposta pode ser mais complexa.

{     "stuff": [],     "uuid": "22920112968019678612904394744954398990",     "dcs_region": 7,     "tid": "ss3OTqPiQp0=" }

d_sid
SID significa ID de pontuação. É uma ID exclusiva para uma característica ou um segmento.
d_tdpid

Passa uma fonte de dados para a avaliação de características. Somente as características dessa fonte de dados são avaliadas.

Por exemplo, digamos que você tenha:

  • Característica T1 com:
  • Regra de característica: " key1 == val1"
  • Source de Dados ( DPID): 1
  • Código de integração DPID: ic1
  • Característica T2 com:
  • Regra de característica: " key2 == val2"
  • Data Source (DPID): 2
  • Código de integração DPID: ic2

Em uma chamada de exemplo, yourcompany.demdex.net/event?key1=val1&key2=val2&d_tdpid=1, somente a característica T1 é retornada.

d_tdpid_ic

A finalidade é idêntica ao parâmetro d_tdpid descrito acima. No entanto, nesse caso, a fonte de dados é transmitida usando o código de integração.

Ao manter as características descritas acima, considere a chamada de exemplo:

Para yourcompany.demdex.net/event?key1=val1&key2=val2&d_tdpid_ic=ic2, somente a característica T2 é retornada.

d_uuid
ID exclusiva do usuário. Identifica um visitante quando esse valor não está disponível em um cookie.

h_ Atributos

Esses cabeçalhos contêm informações como solicitações de dados e respostas em uma chamada HTTP.

Atributo
Descrição
h_host
Isso é definido como o nome do host da coleta de dados específica do cliente. Aparece como host name .demdex.net. Consulte Compreensão das chamadas para o domínio Demdex.
h_user-agent
Defina para o valor do cabeçalho User-Agent.
h_accept-language
Defina para o valor do cabeçalho Accept-Language.
h_referer
Defina para o valor do cabeçalho Referer.
h_referrer
Defina para o valor do cabeçalho Referrer.
h_date
Defina para o valor do cabeçalho Date.
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695