Show Menu
TÓPICOS×

Atributos suportados para chamadas de API DCS

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 ajudar a formatar suas DCS solicitações e entender os parâmetros retornados por este sistema.

Prefixos de atributo

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 do Audience Manager .
h_
Dados do cabeçalho HTTP.
p_
Atributos privados definidos pelo cliente.
O DCS aceita 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 ou armazenados em nosso sistema. Por exemplo, digamos que você tenha uma característica definida como customers = p_age<25 e passe em 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 o Audience Manager recebe a solicitação e não é registrado.

d_ Atributos

Todos eles são opcionais, a menos que você deseje uma resposta do DCS. Se você deseja que DCS a resposta seja retornada, então d_rtbd=json é obrigató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 do provedor de dados ( DPID ) e IDs de usuário do provedor de dados ( DPUUID ) atribuídas pelo Audience Manager . Se você usar vários pares de DPIDs e DPUUIDs, separe cada par com o caractere não imprimível %01 . Por exemplo: DPID %01 DPUUUID .
d_cid substitui d_dpid e d_dpuuid , que estão obsoletos, mas ainda são compatíveis. 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 são compatíveis. Consulte CID substitui DPID e DPUUID .
d_coppa
Desative o uso de cookies de terceiros para cumprir as normas de proteção infantil. Esse parâmetro é definido dinamicamente pelo serviço da Adobe Experience Cloud ID e depende da configuração idSyncDisable3rdPartySyncing . See COPPA Support in the Experience Cloud ID Service .
d_cts=1
d_cts=2
Opcional. Ativado mediante solicitação do cliente. Entre em contato com seu consultor do Adobe Audience Manager ou com o Atendimento ao cliente.
Indica que características e segmentos devem ser retornados dentro da resposta JSON .
Uma amostra de resposta pode ser semelhante à abaixo:
{"stuff": [], "uuid": "07955261652886032950143702505894272138", "dcs_region": , "características": [420020, 5421506], "segmentos": [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 os dados de destino do 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.
Não recomendamos a criação de características que usam atributos reservados. A Adobe pode alterar atributos reservados a qualquer momento.
d_jsonv=1|0
Indica a versão JSON a ser usada na resposta. Normalmente, você deve definir para d_jsonv=1 . A configuração d_jsonv=0 desativa sincronizações de ID.
d_mid
Especifica a Experience Cloud ID definida e usada pelo serviço da Experience Cloud ID. For more information about the ECID, see Cookies and the Experience Cloud ID .
d_nsid
Nomear ID do espaço. Indica qual contêiner JavaScript é usado. Usada pelo DIL para sincronização de id.
d_ptfm
Permite que o Audience Manager distinga as solicitações móveis das solicitações de desktop. Os valores compatíveis incluem:
  • ios
  • androide
  • navegador
  • all
d_rs
Obsoleto. d_rs é um atributo reservado, usado na integração herdada entre o Adobe Analytics e o Audience Manager .
Não recomendamos a criação de características que usam atributos reservados. A Adobe pode alterar atributos reservados a qualquer momento.
d_rtbd=json
Obrigatório se você quiser 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. Consulte o exemplo abaixo. Sua resposta pode ser mais complexa.
{"stuff": [], "uuid": "2292011296801967861290439474954398990", "dcs_region": , "tid": "ss3OTqPiQp0=" }
d_sid
SID significa ID de pontuação. Essa é uma ID exclusiva para uma característica ou um segmento.
d_tdpid
Passa uma fonte de dados para avaliação de características. Somente as características dessa fonte de dados são avaliadas.
Por exemplo, digamos que você tenha:
  • Traço T1 com:
  • Regra de características: " key1 == val1 "
  • Fonte de dados ( DPID ): 1
  • Código de integração DPID: ic1
  • Traço T2 com:
  • Regra de características: " key2 == val2 "
  • Fonte de dados (DPID): 2
  • Código de integração DPID: ic2
Em uma chamada de amostra, yourcompany.demdex.net/event?key1=val1&key2=val2&d_tdpid=1 , apenas 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.
Mantendo as características descritas acima, considere a chamada de amostra:
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.