Declared IDs

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

Declared ID Definição de meta

Troque e sincronize as 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.

Finalidade da segmentação Declared ID

Alguns navegadores e a maioria dos dispositivos móveis não aceitam 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 direcionamento/correspondência da ID:

Processo Descrição
Chamada de evento

Para funcionar, você precisa do DIL e do código do Adobe Experience Platform Identity Service na página. O DIL obtém IDs declaradas da setVisitorID função fornecida pelo serviço de identidade da Adobe Experience Platform e as transmite para o Audience Manager .

ID da correspondência

O Audience Manager tenta corresponder a ID do cliente e do visitante a 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 do mapear para mais de uma ID de Audience Manager.

ID de retorno

O Audience Manager grava sua ID sincronizada em um cookie próprio (ou outro espaço de armazenamento endereçável) no domínio ou aplicativo do cliente.

Chamadas de evento subsequentes

Chamadas de evento adicionais leem a ID do Audience Manager do domínio do cliente e enviem-na para o Audience Manager.

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

Chamadas de cancelamento

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

  • Audience Manager O pode transmitir uma declared ID recusa ao lado de um Audience Manager UUID no URL.
  • A opção de não participação 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 dessa região específica na borda (a recusa não cruza DCS regiões).

Consulte Privacidade de dados para obter mais informações sobre a recusa da coleta de dados.

Declared ID Exemplos de rejeição

Você pode fazer solicitações de recusa declared ID com os pares de valores 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.

Opt-Outs 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 valores-chave d_cid e d_cid_ic .

https://domain name/demoptout?d_cid=123%01987&d_cid_ic=456%01321...

Opt-Outs With DPID, DPUUID e UUID (Obsoleto)

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

Recusar (Obsoleto) Amostra de código

d_uuid only

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

Opt out de 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 desse par dpid + dpuuid para um UUID AAM. Se não houver mapeamento existente anteriormente, o Audience Manager verificará se a solicitação contém um UUID AAM no cookie e, se sim, usará esse para armazenar a recusa. Caso contrário, o Audience Manager gera um novo UUID de AAM e armazena a opção de não participação.

d_dpuuid + d_dpid e explícito d_uuid

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

d_uuid sempre tem precedência. Se a combinação dpid + dpuuid mapear para outro UUID AAM, a recusa será armazenada no UUID AAM transmitido na solicitação ( d_uuid ).

Variáveis e sintaxe para Declared IDs

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

Em cada par de valor-chave:

  • O símbolo = separa a chave de seus valores relacionados.
  • O caractere ASCII não imprimível %01 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 são compatíveis. 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 são obsoletos, mas ainda são compatíveis. Consulte CID substitui DPID e DPUUID .

Exemplos de chamadas de evento

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

Inclusão da chamada de evento 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 valores-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 por DIL para Audience Manager.

DIL O usa o Adobe Experience Platform Identity Service para enviar Declared IDs

Quando usado com o Adobe Experience Platform Identity Service, não é mais necessário 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 no 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 conforme mostrado abaixo.

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

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

Funções obsoletas

Com as versões mais recentes de DIL (6.2+), não é necessário usar esses pares de valores chave para transmitir declared IDs. Isso ocorre porque DIL agora depende da função visitorService mostrada na amostra de código acima. Essa função obtém declared IDs do 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 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 combinado DPID e DPUUID a uma ID de usuário correspondente em nosso sistema. Se uma ID não existir, Audience Manager criará uma nova ID de usuário e a sincronizará com a combinação DPID/DPUUID. Quando Audience Manager corresponde ou cria um ID de usuário (o UUID), ele retorna esse ID na resposta JSON para o cookie no domínio do cliente (primeiro cookie) ou em outro armazenamento local.

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

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

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

Transmitir IDs após DIL Instanciações

OBSERVAÇÃO

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

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 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 do Audience Manager (por exemplo, UUID) que é gravada em um cookie primário 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 Audience Manager direcionamento por seu site. Quando Audience Manager recebe uma solicitação de recusa, o DCS retorna um objeto JSON vazio em vez da Audience Manager ID de usuário.

Nesta página