Declared IDs declared-ids

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

Declared ID Definição de meta declared-id-targeting

Trocar e sincronizar IDs de usuário com o Audience Manager de dispositivos ou navegadores que não usam ou aceitam mecanismos de armazenamento persistentes, como cookies.

Finalidade de Declared ID Direcionamento declared-id-targeting-purpose

Alguns navegadores e a maioria dos dispositivos móveis não aceitam serviços de cookies. 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 usos 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 na Experience Cloud. A tabela a seguir descreve o processo de correspondência/direcionamento de ID:

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

Chamadas de recusa opt-out-calls

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

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

Declared ID Exemplos de recusa opt-out-examples

Você pode criar um declared ID solicitações de recusa com a d_cid e d_cid_ic pares 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.

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.

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:

Variáveis e sintaxe de Declared IDs variables-and-syntax

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

Em cada par de valor-chave:

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.

Declared ID Variáveis declared-id-variables

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

DIL usa o Adobe Experience Platform Identity Service para aprovação Declared IDs dil-id-service-pass-declared-ids

Quando usado com o Serviço de identidade da Adobe Experience Platform, você não precisa mais transmitir declared IDs com o obsoleto dpid e dpuuid variáveis. Em vez disso, as versões atuais do DIL confie na visitorService função para obter o declared IDs do setCustomerIDs na caixa Adobe Experience Platform Identity Service. Para obter mais informações, consulte Estados de autenticação e IDs do cliente. Você chamaria visitorService in DIL.create conforme mostrado abaixo.

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

No namespace par de valor-chave, MCORG é seu Experience Cloud ID da 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 visualizar este painel. Consulte Administração: Serviços principais.

Funções obsoletas deprecated-functions

Com as versões mais recentes da DIL (6.2+), não é necessário usar esses pares de valores chave para transmitir declared IDs. É porque… DIL O agora depende do 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 declaredId objeto:

DPID e DPUUID

Audience Manager compara e corresponde a DPID e DPUUID para 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 o DPID/DPUUID combinação. Uma vez Audience Manager corresponde ou cria uma ID de usuário (a variável UUID) retorna essa ID na variável JSON resposta à cookie no domínio do cliente (primário) cookie) ou outro armazenamento local.

Chame esta 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
    }
 });

Enviar IDs depois de DIL Instancia

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 é gravado em um cookie próprio no domínio da página.

myCallback({
...
   "uuid":"abc123"
})

Não direcionar e recusar chamadas do-not-target

A variável declared ID o processo respeita as preferências do visitante do site para recusar o Audience Manager direcionamento pelo seu site. Quando Audience Manager recebe uma solicitação de recusa, a variável DCS retorna um vazio JSON em vez do Audience Manager ID de usuário.