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:

Processo
Descrição
Chamada de evento
Para funcionar, você precisa do código DIL e do serviço de identidade da Adobe Experience Platformna página. O DIL obtém IDs declaradas da função setVisitorID fornecida pelo Serviço de Identidade do Adobe Experience Platform 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 uma ID correspondente não existir, o Audience Manager criará uma nova ID e a associará à ID do cliente e do visitante.

Observação: o mapeamento mais recente é usado se a ID mapear para mais de uma ID de Audience Manager.

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 ID de Audience Manager do domínio do cliente e a enviam para o 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 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.

  • 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 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.

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

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 uma UUID AAM. Se não houver mapeamento existente, o Audience Manager verificará se a solicitação contém uma UUID AAM no cookie e, em caso positivo, usará essa UUID para armazenar a recusa. Caso contrário, o Audience Manager gera um novo UUID AAM e armazena a opção de não participação nele.

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 AAM, a recusa será armazenada na UUID AAM transmitida na solicitação ( d_uuid ).

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:

  • 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 sample-event-calls

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 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:

Nome
Tipo
Descrição
dpid
String
ID do parceiro de dados atribuída pelo 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 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.

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695