Como declared IDs funciona, configurar procedimentos, exemplos de código e variáveis.
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.
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 em Experience Cloud. A tabela a seguir descreve o processo de definição de metas/correspondência de ID:
Processo | Descrição |
---|---|
Chamada de evento | Para funcionar, você precisa de DIL e do código do Adobe Experience Platform Identity Service na página. O DIL obtém IDs declaradas da |
ID de 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 sua ID mapear para mais de uma ID de Audience Manager. |
ID de retorno | A Audience Manager grava sua ID sincronizada em um cookie primário (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 de Audience Manager do domínio do cliente e enviam-na para a Audience Manager. |
Para começar, você precisa configurar o Experience Cloud serviço de ID e DIL nas páginas do site que deseja usar para a coleta de dados. Consulte DIL create e Variáveis de ID declaradas.
O processo declared ID atende às preferências de visitante do site para excluir Audience Manager a definição de metas por seu site. Quando Audience Manager recebe uma solicitação de recusa, JSON retornada pelo DCS contém o código de erro 171, com a mensagem Encountered opt out tag
, em vez da Audience Manager ID de usuário.
Consulte Privacidade de dados para obter mais informações sobre como recusar a coleta de dados.
Você pode fazer solicitações declared ID de não participação com os pares d_cid
e d_cid_ic
de valor chave. 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.
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. |
|
Um código de integração e ID de usuário. |
|
Vários pares de |
|
Esses métodos ainda funcionam, mas são considerados obsoletos. Essas informações são fornecidas para fins herdados e referência. As opções de não participação herdadas incluem:
Recusar (Obsoleto) | Amostra de código |
---|---|
|
|
Opção de não participação no nível do parceiro |
Uma opção de não participação em nível de parceiro é armazenada para o mapeamento mais recente desse par |
|
|
A tabela a seguir lista os pares de valores chave que passam pela ID do provedor de dados Audience Manager e IDs de usuário ou códigos de integração, se usados. Observação: italics indica um espaço reservado variável. Os espaços foram adicionados para facilitar a leitura.
Em cada par de valor chave:
=
separa a chave dos valores relacionados.%01
separa os valores.Variável | Descrição |
---|---|
|
Contém uma ID de provedor de dados e uma ID de usuário exclusiva associada em um único par de valores chave. |
|
Contém um código de integração e uma ID de usuário exclusiva associada em um único par de valor chave. |
Considerando esses pares de valor chave e sua sintaxe necessária, você faria chamadas de evento, como mostrado abaixo.
A chamada do evento inclui | Amostra de código |
---|---|
Uma ID de provedor de dados e ID de usuário. |
|
Um código de integração e ID de usuário. |
|
Vários pares de |
|
Descreve as variáveis de configuração usadas para passar declared IDs por DIL para Audience Manager.
Quando usado com o Adobe Experience Platform Identity Service, você não precisa mais passar declared IDs pelas 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
, conforme mostrado abaixo.
var vDil = DIL.create({
partner:"partner name",
visitorService:{
namespace:"INSERT-MCORG-ID-HERE"
}
});
No par de namespace
valor-chave, MCORG
é a sua Experience Cloud ID de empresa. 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 visualização deste painel. Consulte Administração: Principais serviços.
Com as versões mais recentes de DIL (6.2+), você não precisa usar esses pares de valor chave para passar em 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 de Adobe Experience Platform Identity Service. Entretanto, estamos referenciando 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 exclusiva do provedor de dados para o usuário. |
Audience Manager compara e corresponde à ID combinada DPID
e DPUUID
à 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 uma ID de usuário (a UUID
), ela retorna essa ID na resposta JSON para cookie no domínio do cliente (a4/> primário) ou outro armazenamento local.cookie
Chame essa função quando estiver usando DIL v6.1 ou anterior. No entanto, essa função foi substituída em favor da nova versão que obtém declared IDs do Adobe Experience Platform Identity Service.
DIL.create({
partner : "partner name",
declaredId : {
dpuuid : dpuuid,
DPID : dpid
}
});
É necessário desenvolver programaticamente o código que fornece os valores de ID para as chaves d_dpuuid
e d_dpid
.
Se você fizer uma chamada API com uma combinação declaredID
diferente, a nova combinação será usada apenas para essa chamada. Outras chamadas regulares de evento usarão a combinação DIL.create
declaredID
original.
DIL.getDil('partner name').api.signals({...}).declaredId({
dpuuid : dpuuid
dpid : dpid
}).submit();
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 do Audience Manager (por exemplo, UUID
) que é gravada em um cookie primário no domínio da página.
myCallback({
...
"uuid":"abc123"
})
O processo declared ID atende às preferências de visitante do site para excluir Audience Manager a definição de metas por seu site. Quando Audience Manager recebe uma solicitação de recusa, o DCS retorna um objeto JSON vazio em vez da ID de usuário Audience Manager.