Show Menu
TÓPICOS×

Declared IDs

Como declared IDs trabalhar, configurar procedimentos, exemplos de código e variáveis.

Declared ID Direcionamento

Troque e sincronize IDs de usuários com Audience Manager de dispositivos ou navegadores que não usam ou aceitam mecanismos de armazenamento persistentes, como de terceiros cookies.

Finalidade da Declared ID definição de metas

Alguns navegadores e a maioria dos dispositivos móveis não aceitam cookiesnavegadores 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 o 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 de identificação do Adobe Experience Platform na página. O DIL obtém IDs declaradas da setVisitorID função fornecida pelo Serviço de identificação do Adobe Experience Platform e as transmite para o Audience Manager .
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, é necessário configurar o serviço de Experience Cloud ID e DIL entre as páginas do site que deseja usar para a coleta de dados. Consulte Criar e declarar variáveis de ID da DIL.

Chamadas de cancelamento

O declared ID processo atende às preferências de visitante do site para recusar a Audience Manager definição de metas por seu site. When Audience Manager receives an opt-out request, the JSON returned by the DCS contains the error code 171, with the message Encountered opt out tag , instead of the Audience Manager user ID.
  • Audience Manager pode passar por uma declared ID opção de não participação ao lado de uma Audience Manager opção UUID no URL.
  • A declared ID opção de não participação é armazenada no Perfil Cache Server (PCS) em uma base por parceiro. Não há cancelamento de nível de plataforma usando declared IDs. Além disso, Audience Manager rejeita 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.

Declared ID Exemplos de opção de não participação

You can make a declared ID opt-out requests with the d_cid and d_cid_ic key-value pairs. 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-out 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 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, DPUUIDe 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 verifica se a solicitação contém um UUID do AAM no cookie e, se houver, o usa 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.
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 Declared IDs

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

Declared ID Variáveis

Descreve as variáveis de configuração usadas para passar declared IDs para DIL Audience Manager.

DIL usa a opção Adobe Experience Platform Identity Service para passar Declared IDs

Quando usado com o Serviço de identidade do Adobe Experience Platform, não é mais necessário passar declared IDs com as variáveis dpid e dpuuid desaprovadas. Em vez disso, as versões atuais de DIL dependem da visitorService função para obter o declared IDs da setCustomerIDs função no Adobe Experience Platform Identity 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 visualização deste 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 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 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

Audience Manager compara e corresponde à ID combinada DPID e DPUUID a correspondente do usuário em nosso sistema. Se uma ID não existir, Audience Manager criará uma nova ID de usuário e a sincronizará com a DPID/DPUUID combinação. Uma vez que Audience Manager corresponde ou cria uma ID de usuário (a), ela retorna essa ID na UUID resposta ao JSON domínio do cliente (primário cookie cookie) ou 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 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 .

Enviar IDs após DIL Instanciações

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 combinação original 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 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 Público alvo e Chamadas de Recusa

O declared ID processo atende às preferências de visitante do site para recusar a Audience Manager definição de metas por seu site. Quando Audience Manager recebe uma solicitação de não participação, a DCS retorna um objeto vazio em vez da ID de JSON Audience Manager usuário.