Documentação Audience Manager Guia do usuário do Audience Manager

Declared IDs

Última atualização: 5 de maio de 2025

Tópicos:

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

Declared ID Definição de meta

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

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:

Processo	Descrição
Chamada de evento	Para funcionar, você precisa do código DIL e do Adobe Experience Platform Identity Servicena página. O DIL obtém IDs declaradas da função `setVisitorID` fornecida pelo Adobe Experience Platform Identity Service e transmite-as para o Audience Manager .
Identificação de Correspondência	O Audience Manager tenta corresponder a ID do cliente e do visitante com uma ID correspondente em nosso sistema. Se não existir uma ID correspondente, o Audience Manager cria uma nova ID e a associa à ID do cliente e do visitante. Observação: o mapeamento mais recente é usado se a ID mapear para mais de uma Audience Manager ID.
ID de Retorno	O Audience Manager grava sua ID sincronizada em um cookie primário (ou outro espaço de armazenamento endereçável) no domínio ou aplicativo cliente.
Chamadas de evento subsequentes	Chamadas de evento adicionais leem a Audience Manager ID do domínio do cliente e a enviam para a Audience Manager.

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 Criação de DIL e Variáveis de ID Declaradas.

Chamadas de recusa

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.

Audience Manager pode enviar uma opção de recusa de declared ID junto com um Audience Manager UUID no URL.
A opção de não participação do declared ID é armazenada no Profile Cache Server (PCS) com base no parceiro. Não há recusa em nível de plataforma usando declared IDs. Além disso, Audience Manager recusa o usuário nessa região específica na borda (a opção de não participação não passa de DCS regiões).

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

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.

Recusa de uso	Amostra de código
Uma ID de provedor de dados e ID de usuário.	`https://domain name/demoptout.jpg?d_cid=123%01987...`
Um código de integração e ID de usuário.	`https://domain name/demoptout?d_cid_ic=456%01321...`
Vários pares de valor-chave `d_cid` e `d_cid_ic` .	`https://domain name/demoptout?d_cid=123%01987&d_cid_ic=456%01321...`

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:

Opção de não participação (obsoleto) Amostra de código

Somente d_uuid https://domain/demoptout.jpg?d_uuid=AAM ID

Recusa em nível de parceiro

Opção de não participação (obsoleto)	Amostra de código
Somente `d_uuid`	`https://domain/demoptout.jpg?d_uuid=AAM ID`
Recusa em nível de parceiro	`https://demoptout.jpg?d_dpuuid= user ID&d_dpid= data provider ID` Uma recusa em nível de parceiro é armazenada para o mapeamento mais recente deste par `dpid` + `dpuuid` para um UUID do AAM. Se não houver mapeamento existente, o Audience Manager verificará se a solicitação contém uma UUID do AAM no cookie e, em caso afirmativo, usará essa ID para armazenar a recusa. Caso contrário, o Audience Manager gerará uma nova UUID do AAM e armazenará a opção de não participação nela.
`d_dpuuid` + `d_dpid` e `d_uuid` explícito	`https://domain/demoptout.jpg?d_uuid= user ID&d_dpuuid= data provider's user ID&d_dpid=data provider ID` `d_uuid` sempre tem prioridade. Se a combinação `dpid` + `dpuuid` for mapeada para outra UUID do AAM, a recusa será armazenada na UUID do AAM transmitida na solicitação ( `d_uuid` ).

https://demoptout.jpg?d_dpuuid= user ID&d_dpid= data provider ID

Uma recusa em nível de parceiro é armazenada para o mapeamento mais recente deste par dpid + dpuuid para um UUID do AAM. Se não houver mapeamento existente, o Audience Manager verificará se a solicitação contém uma UUID do AAM no cookie e, em caso afirmativo, usará essa ID para armazenar a recusa. Caso contrário, o Audience Manager gerará uma nova UUID do AAM e armazenará a opção de não participação nela.

d_dpuuid + d_dpid e d_uuid explícito

https://domain/demoptout.jpg?d_uuid= user ID&d_dpuuid= data provider's user ID&d_dpid=data provider ID

d_uuid sempre tem prioridade. Se a combinação dpid + dpuuid for mapeada para outra UUID do AAM, a recusa será armazenada na UUID do AAM transmitida na solicitação ( d_uuid ).

Variáveis e Sintaxe para Declared IDs

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:

O símbolo = separa a chave de seus valores relacionados.
O ASCII caractere %01 não imprimível separa os valores.

Variável	Descrição
`d_cid =data provider ID %01user ID`	Contém uma ID de provedor de dados e uma ID de usuário exclusiva associada em um único par de valor-chave. `d_cid` substitui `d_dpid` e `d_dpuuid` , que são considerados obsoletos, mas ainda têm suporte. Consulte CID substitui DPID e DPUUID.
`d_cid_ic =integration code %01user ID`	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.

Exemplo de chamadas de evento

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

Chamada de evento inclui	Amostra de código
Uma ID de provedor de dados e ID de usuário.	`https://domain name/event?d_cid=123%01987...`
Um código de integração e ID de usuário.	`https://domain name/event?d_cid_ic=456%01321...`
Vários pares de valor-chave `d_cid` e `d_cid_ic` .	`https://domain name/event?d_cid=123%01987&d_cid_ic=456%01321...`

Declared ID Variáveis

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

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 Introdução aos serviços da Experience Cloud.

Funções obsoletas

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:

Nome

Tipo

Descrição

dpid

String

ID do parceiro de dados atribuída pela Audience Manager.

dpuuid

Sequência de caracteres

A ID única do provedor de dados para o usuário.

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
    }
 });

NOTE

Você precisa desenvolver programaticamente o código que fornece os valores de ID para as chaves d_dpuuid e d_dpid.

Passar IDs Após DIL Instanciações

NOTE

Se você fizer uma chamada API com uma combinação declaredID diferente, a nova combinação será usada somente para essa chamada. Mais chamadas de evento regulares usarão a combinação original DIL.create declaredID.

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

Exemplos de solicitação/resposta

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 Audience Manager ID (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

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.

recommendation-more-help