TÓPICOS×
IDs declaradas
Como as IDs declaradas funcionam, configurar procedimentos, exemplos de código e variáveis.
Definição de direcionamento ID declarada
Troque e sincronize IDs de usuários com o Audience Manager de dispositivos ou navegadores que não usam ou aceitam mecanismos de armazenamento persistentes, como cookies de terceiros.
Objetivo da segmentação declarada da 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 os visitantes do site ou a atribuição de IDs persistentes. Para resolver esse problema, o Audience Manager usa DIL para permitir que você passe declared IDs em uma chamada de evento. Além disso, uma 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 definição de metas/correspondência de ID:
Processo | Descrição |
---|---|
Chamada de evento | Para funcionar, você precisa do
DIL
e do código do serviço da
Experience Cloud ID
na página.
O DIL
obtém IDs
declaradas
da
setVisitorID
função fornecida pelo serviço da
Experience Cloud ID
e as transmite para o
Audience Manager
.
|
ID 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 visitante.
Observação: O mapeamento mais recente é usado se sua ID mapear para mais de uma ID do 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 do cliente ou aplicativo.
|
Chamadas de evento subsequentes | Chamadas de evento adicionais leem a ID do Audience Manager do domínio do cliente e enviam-na para o Audience Manager.
|
Chamadas de cancelamento
O declared ID processo atende às preferências do visitante do site para excluir a definição de metas do Audience Manager por seu site. Quando o Audience Manager recebe uma solicitação de recusa, a solicitação JSON retornada pelo DCS contém o código de erro 171, com a mensagem "Encontrada tag de recusa", em vez da ID de usuário do Audience Manager.
- O Audience Manager pode enviar uma declared ID opção de não participação ao lado de um Audience Manager UUID no URL.
- A declared ID opção de não participação é armazenada no [Profile Cache Server (PCS) por parceiro. Não há cancelamento de nível de plataforma usando declared IDs. Além disso, o Audience Manager recusa o usuário daquela região específica na borda (a opção de não participação não atravessa DCS regiões).
Consulte Privacidade
de
dados para obter mais informações sobre como recusar a coleta de dados.
Exemplos de cancelamento de ID declarada
É possível fazer solicitações de declared ID recusa com os pares de valor-chave
d_cid
e valor-
d_cid_ic
chave. Os parâmetros herdados como
d_dpid
e
d_dpuuid
ainda funcionam, mas são considerados obsoletos. Consulte
CID substitui DPID e DPUUID
. In the examples,
italics
indicates a variable placeholder.
Opções com CID e CID_IC
Para obter uma descrição e sintaxe, consulte Variáveis e sintaxe
URL para IDs
declaradas.
Opção de não participação usando | 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
d_cid
e
d_cid_ic
valores chave.
| https://
domain name
/demoptout?d_cid=123%01987&d_cid_ic=456%01321...
|
Opções 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 opções de não participação herdadas incluem:
Recusar (Obsoleto) | Amostra de código |
---|---|
d_uuid
only
| https://
domain
/demoptout.jpg?d_uuid=AAM ID
|
Opção de não participação no nível do parceiro
| https://demoptout.jpg?d_dpuuid= user ID&d_dpid= data provider ID
Uma opção de não participação em nível de parceiro é armazenada para o mapeamento mais recente desse par
dpid
+
dpuuid
para um UUID do AAM. Se não houver mapeamento existente anteriormente, o Audience Manager verificará se a solicitação contém um UUID do AAM no cookie e, se houver, o usará para armazenar a opção de não participação. Caso contrário, o Audience Manager gera um novo UUID do AAM e armazena a opção de não participação sob ele.
|
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 do AAM, a opção de não participação será armazenada no UUID do AAM passado na solicitação (
d_uuid
).
|
Variáveis e sintaxe para IDs declaradas
A tabela a seguir lista os pares de valores chave que passam pela ID do provedor de Audience Manager dados e IDs de usuário ou códigos de integração, se usados. Note,
italics
indicates a variable placeholder. 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 não imprimível ASCII %01 separa os valores.
Variável | Descrição |
---|---|
d_cid =
data provider ID
%01
user ID
| Contém uma ID de provedor de dados e uma ID de usuário exclusiva associada em um único par de valores chave.
d_cid
substitui
d_dpid
e
d_dpuuid
, que são considerados obsoletos, mas ainda são suportados. Consulte
CID substitui DPID e DPUUID
.
|
d_cid_ic =
integration code
%01
user 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
.
|
Chamadas de Evento de Exemplo
Considerando esses pares de valores chave e sua sintaxe necessária, você faria chamadas de evento, como mostrado abaixo.
A 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
d_cid
e
d_cid_ic
valores chave.
| https://
domain name
/event?d_cid=123%01987&d_cid_ic=456%01321...
|
Variáveis de ID declaradas
Descreve as variáveis de configuração usadas para passar as IDs declaradas DIL para Audience Manager.
A DIL usa o serviço da Experience Cloud ID para passar as IDs declaradas
Quando usado com o serviço
da
Experience Cloud ID, não é mais necessário passar declared IDs com as variáveis obsoletas
dpid
e
dpuuid
. Em vez disso, as versões atuais de DIL dependem da
visitorService
função para obter o declared IDs da
setCustomerIDs
função no Experience Cloud ID Service. For more information, see
Customer IDs and Authentication States
. Você faria uma chamada
visitorService
como mostrado
DIL.create
abaixo.
var vDil = DIL.create({ partner:"partner name", visitorService:{ namespace:"INSERT-MCORG-ID-HERE" } });
No par de
namespace
chave-valor,
MCORG
está a ID da Experience Cloud organização. Se você não tiver essa ID, poderá encontrá-la na Administration seção do Experience Cloud painel. Você precisa de permissões de administrador para exibir este painel. See
Administration: Core Services
.
Funções obsoletas
Com as versões mais recentes de DIL (6.2+), você não precisa usar esses pares de valor chave para passar declared IDs. Isso ocorre porque DIL agora depende da
visitorService
função mostrada na amostra de código acima. Esta função é declared IDs da Experience Cloud ID 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
declaredId
objeto:
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.
|
DPID e DPUUID
O Audience Manager compara e corresponde à ID de usuário combinada
DPID
e
DPUUID
a correspondente no sistema. Se uma ID não existir, o Audience Manager criará uma nova ID de usuário e a sincronizará com a
DPID/DPUUID
combinação. Quando o Audience Manager corresponde ou cria uma ID de usuário (a), ela retorna essa ID na
UUID
JSON resposta ao cookie no domínio do cliente (cookie primário) ou em outro armazenamento local.
Chame essa função quando estiver usando DIL v6.1 ou anterior. No entanto, essa função foi descontinuada em favor da nova versão obtida declared IDs do Experience Cloud ID Service.
DIL.create({ partner : "partner name", declaredId : { dpuuid : dpuuid, DPID : dpid } });
Observe que é necessário desenvolver programaticamente o código que fornece os valores de ID para as chaves
d_dpuuid
e
d_dpid
.
Enviar IDs após as instâncias DIL
Se você fizer uma API chamada com uma
declaredID
combinação diferente, a nova combinação será usada apenas para essa chamada. Outras chamadas regulares de evento usarão a
DIL.create
declaredID
combinação 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 uma ID de usuário para o 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 declared ID processo atende às preferências do visitante do site para excluir a definição de metas do Audience Manager por seu site. Quando o Audience Manager recebe uma solicitação de recusa, o DCS JSON retorna um objeto vazio em vez da ID de usuário do Audience Manager.