Declared IDs declared-ids

Como o declared IDs funciona, configure procedimentos, exemplos de código e variáveis.

Declared ID Definição de meta declared-id-targeting

Troque e sincronize IDs de usuário com Audience Manager de dispositivos ou navegadores que não usam ou aceitam mecanismos de armazenamento persistentes, como cookies de terceiros.

Propósito do Direcionamento Declared ID declared-id-targeting-purpose

Alguns navegadores e a maioria dos dispositivos móveis não aceitam o cookies de terceiros. Isso dificulta a retenção de informações sobre visitantes do site ou a atribuição de IDs persistentes. Para resolver esse problema, Audience Manager usa DIL para permitir que você passe declared IDs em uma chamada de evento. Além disso, um declared ID pode agir como uma ID universal que se aplica ao mesmo usuário em todas as soluções no Experience Cloud. A tabela a seguir descreve o processo de correspondência/direcionamento de ID:

Para começar, você precisa configurar o serviço de ID do Experience Cloud e o DIL em todas as páginas do site que deseja usar para a coleta de dados. Consulte DIL create e Variáveis de ID declaradas.

Chamadas de recusa opt-out-calls

O processo declared ID respeita as preferências do visitante do site para recusar o direcionamento do Audience Manager por seu site. Quando Audience Manager recebe uma solicitação de recusa, a JSON retornada por DCS contém o código de erro 171, com a mensagem Encountered opt out tag, em vez da ID de usuário Audience Manager.

Consulte Privacidade de dados para obter mais informações sobre a não participação na coleta de dados.

Exemplos de recusa do Declared ID opt-out-examples

Você pode fazer uma solicitação de recusa de declared ID com os pares de valor-chave d_cid e d_cid_ic. Os parâmetros herdados como d_dpid e d_dpuuid ainda funcionam, mas são considerados obsoletos. Consulte CID substitui DPID e DPUUID. Nos exemplos, itálico indica um espaço reservado para variável.

Opções de não participação com CID e CID_IC

Para obter uma descrição e sintaxe, consulte Variáveis e sintaxe de URL para IDs declaradas.

Opções de não participação com DPID, DPUUID e UUID (obsoleto)

Esses métodos ainda funcionam, mas são considerados obsoletos. Essas informações são fornecidas para fins herdados e referência. As recusas herdadas incluem:

Variáveis e Sintaxe para Declared IDs variables-and-syntax

A tabela a seguir lista os pares de valores chave que passam na ID do provedor de dados do Audience Manager e nas IDs do usuário ou nos códigos de integração, se usados. Observe que itálico indica um espaço reservado para variável. Foram adicionados espaços para facilitar a leitura.

Em cada par de valor-chave:

Exemplo de chamadas de evento sample-event-calls

Dados esses pares de valores chave e sua sintaxe necessária, você faria chamadas de evento conforme mostrado abaixo.

Declared ID Variáveis declared-id-variables

Descreve as variáveis de configuração usadas para passar declared IDs através de DIL para Audience Manager.

DIL usa Adobe Experience Platform Identity Service para Passar Declared IDs dil-id-service-pass-declared-ids

Quando usado com o Adobe Experience Platform Identity Service, você não precisa mais transmitir declared IDs com as variáveis dpid e dpuuid obsoletas. Em vez disso, as versões atuais de DIL dependem da função visitorService para obter declared IDs da função setCustomerIDs em Adobe Experience Platform Identity Service. Para obter mais informações, consulte IDs do cliente e Estados de autenticação. Você chamaria visitorService em DIL.create como mostrado abaixo.

var vDil = DIL.create({
  partner:"partner name",
  visitorService:{
    namespace:"INSERT-MCORG-ID-HERE"
  }
});

No par de valor-chave namespace, MCORG é a sua ID da organização Experience Cloud. Se você não tiver essa ID, poderá encontrá-la na seção Administration do painel Experience Cloud. Você precisa de permissões de administrador para visualizar este painel. Consulte Administração: Serviços Principais.

Funções obsoletas deprecated-functions

Com as versões mais recentes do DIL (6.2+), você não precisa usar esses pares de valores chave para transmitir declared IDs. Isso ocorre porque DIL agora depende da função visitorService mostrada no exemplo de código acima. Esta função obtém declared IDs de Adobe Experience Platform Identity Service. No entanto, estamos fazendo referência a essas variáveis aqui para fins históricos e herdados. Consulte o código abaixo para obter um exemplo de como configurar o DIL.create para obter um declared ID do Visitor ID Service.
A tabela a seguir descreve as variáveis herdadas usadas pelo objeto declaredId:

DPID e DPUUID

Audience Manager compara e corresponde o DPID e DPUUID combinados a uma ID de usuário correspondente em nosso sistema. Se uma ID não existir, Audience Manager cria uma nova ID de usuário e a sincroniza com a combinação DPID/DPUUID. Quando Audience Manager corresponde ou cria uma ID de usuário (o UUID), ele retorna essa ID na resposta JSON ao cookie no domínio do cliente (cookie primário) ou outro armazenamento local.

Chame esta função quando estiver usando o DIL v6.1 ou anterior. No entanto, essa função foi substituída pela nova versão que obtém declared IDs do Adobe Experience Platform Identity Service.

DIL.create({
    partner : "partner name",
    declaredId : {
       dpuuid : dpuuid,
       DPID : dpid
    }
 });

Passar IDs Após DIL Instanciações

DIL.getDil('partner name').api.signals({...}).declaredId({
  dpuuid : dpuuid
  dpid : dpid
}).submit();

Exemplos de solicitação/resposta request-response-examples

A solicitação envia um provedor de dados e uma ID de usuário para Audience Manager:

https://my_domain.net/event?d_rtbd=json&d_cb=myCallback&key=val&d_dpuuid=1234&d_dpid=5678

A resposta retorna a ID de Audience Manager (por exemplo, UUID) que é gravada em um cookie próprio no domínio da página.

myCallback({
...
   "uuid":"abc123"
})

Não direcionar e recusar chamadas do-not-target

O processo declared ID respeita as preferências do visitante do site para recusar o direcionamento do Audience Manager por seu site. Quando Audience Manager recebe uma solicitação de recusa, DCS retorna um objeto JSON vazio em vez da ID de usuário Audience Manager.