Documentação Experience Platform Tutorial da Web

Adicionar o Serviço de identidade da Adobe Experience Platform

Última atualização: 5 de junho de 2025

Tópicos:

Criado para:

Iniciante
Intermediário
Desenvolvedor

Esta lição guiará você pelas etapas necessárias para implementar a extensão Serviço de identidade da Adobe Experience Platform e enviar as IDs do cliente.

O Adobe Experience Platform Identity Service define uma ID de visitante comum em todas as soluções da Adobe para potencializar recursos da Experience Cloud como o compartilhamento de público-alvo entre soluções. Você também pode enviar suas próprias IDs do cliente para o Serviço para ativar o direcionamento entre dispositivos e integrações com os sistemas de CRM (relacionamento com o cliente).

OBSERVAÇÃO

O Adobe Experience Platform Launch está sendo integrado à Adobe Experience Platform como um conjunto de tecnologias de coleção de dados. Várias alterações de terminologia foram implementadas na interface do que você deve estar ciente ao usar esse conteúdo:

O Platform Launch (lado do cliente) agora é tags
O Platform Launch Server Side agora é event forwarding
As configurações do Edge agora são datastreams

Objetivos de aprendizagem

No final desta lição, você poderá:

Adicionar a extensão Serviço de Identidade
Criar um elemento de dados para coletar as IDs do cliente
Crie uma regra que use a ação “Definir IDs do cliente” para enviar as IDs do cliente para a Adobe
Use o recurso de solicitação de regra para sequenciar regras que são acionadas no mesmo evento

Pré-requisitos

É necessário que você tenha completado as lições na seção Configurar tags.

Adicionar a extensão Serviço de identidade

Como esta é a primeira extensão que você está adicionando, esta é uma rápida visão geral das extensões. As extensões são um dos recursos principais das tags. Uma extensão é uma integração criada pela Adobe, por um parceiro da Adobe ou por qualquer cliente da Adobe que adiciona opções novas e infinitas para as tags que você pode implantar em seu site. Se você pensar nas tags como um sistema operacional, as extensões são os aplicativos que você instala para que as tags possam fazer o que é necessário.

Para adicionar a extensão Serviço de identidade

Na navegação à esquerda, clique em Extensões
Clique em Catálogo para ir para a página Catálogo de extensões
Observe a variedade de extensões disponíveis no Catálogo
No filtro na parte superior, digite "id" para filtrar o catálogo
No cartão do Adobe Experience Platform Identity Service, clique em Instalar
Observe que a sua ID da organização na Experience Cloud foi detectada automaticamente para você
Deixe todas as configurações padrão e clique em Salvar na Biblioteca e na Build

OBSERVAÇÃO

Cada versão da extensão do Serviço de identidade vem com uma versão específica do VisitorAPI.js anotada na descrição da extensão. Atualize a versão VisitorAPI.js atualizando a extensão do Serviço de identidade.

Validar a extensão

A extensão do Serviço de identidade é uma das poucas extensões de tag que fazem uma solicitação sem precisar usar uma ação de regra. A extensão faz uma solicitação automaticamente para o Serviço de identidade no primeiro carregamento de página da primeira visita a um site. Uma vez que a ID for solicitada, ela será armazenada em um cookie primário com "AMCV_".

Para validar a extensão do Serviço de Identidade

Abra o site Luma.
Certifique-se de que o Depurador está mapeando a propriedade da tag para o seu ambiente de desenvolvimento, conforme descrito na lição anterior.
Na guia Resumo do Debugger, a seção de tags deve indicar que a extensão Adobe Experience Platform Identity Service está implementada.
Além disso, na guia Resumo, a seção Serviço de identidade deve se preenchida com a mesma ID de organização mostrada na tela de configuração de extensões na interface da Coleção de dados:
A solicitação inicial para recuperar a ID do visitante pode aparecer na guia Serviço de identidade do Debugger. Contudo, ela já pode ter sido solicitada, portanto, não se preocupe se você não vê-la:
Depois da solicitação inicial para buscar a ID do visitante, a ID é armazenada em um cookie cujo nome começa com AMCV_. Você pode confirmar que o cookie foi configurado ao fazer o procedimento a seguir:
1. Abra as Ferramentas do desenvolvedor do seu navegador.
2. Acesse a guia Application.
3. Expanda Cookies no lado esquerdo.
4. Clique no domínio https://luma.enablementadobe.com
5. Procure o cookie AMCV_ no lado direito. Você pode ver vários desde que carregou o site Luma usando a propriedade de tag codificada, bem como mapeada para a sua.

Pronto! Você adicionou sua primeira extensão! Para obter mais detalhes sobre as opções de configuração do Serviço de identidade, consulte a documentação.

Enviar IDs do cliente

Em seguida, você enviará uma ID do cliente ao Serviço de identidade. Isso permite que você integre seu CRM à Experience Cloud e rastreie os visitantes em todos os dispositivos.

Na lição anterior, Adicionar elementos de dados, regras e bibliotecas, você criou um elemento de dados e o usou em uma regra. Agora, você usará as mesmas técnicas para enviar uma ID do cliente quando o visitante é autenticado.

Criar elementos de dados para IDs do cliente

Comece criando dois elementos de dados:

Authentication State—para capturar se o visitante estiver ou não conectado
Email (Hashed)—para capturar a versão com hash do endereço de email (usado como ID do cliente) da camada de dados

Para criar o elemento de dados para o Estado de autenticação

Clique em Elementos de dados na navegação à esquerda
Clique no botão Adicionar elemento de dados
Nomeie o elemento de dados Authentication State
Para o Tipo de elemento de dados, selecione Código personalizado
Clique no botão Abrir Editor
Na janela Editar código, use o seguinte código para retornar valores de "conectado" ou "desconectado" com base em um atributo na camada de dados do site Luma:
if (digitalData.user[0].profile[0].attributes.loggedIn) return "logged in" else return "logged out"
Clique em Salvar para salvar o código personalizado
Deixe todas as outras configurações em seus valores padrão
Clique em Salvar na Biblioteca para salvar o elemento de dados e retornar à página de elementos de dados. Não precisaremos fazer um "Build" até que todas as alterações sejam feitas e que estejamos prontos para validar.

Ao conhecer o estado de autenticação do usuário, você sabe quando uma ID do cliente deve existir na página para ser enviada ao Serviço de identidade. A próxima etapa é criar um elemento de dados para a própria ID do cliente. No site de demonstração Luma, você usará a versão com hash do endereço de email do visitante.

Para adicionar o elemento de dados do email com hash

Clique no botão Adicionar elemento de dados
Nomeie o elemento de dados Email (Hashed)
Para o Tipo de Elemento de Dados, selecione Variável JavaScript
Como o nome da variável do JavaScript, use o seguinte ponteiro para obter uma variável na camada de dados do site Luma: digitalData.user.0.profile.0.attributes.username
Deixe todas as outras configurações em seus valores padrão
Clique em Salvar na biblioteca para salvar o elemento de dados

Adicionar uma regra para enviar as IDs do cliente

O Serviço de identidade da Adobe Experience Platform transmite as IDs do cliente em regras usando uma ação chamada "Definir IDs do cliente". Agora você criará uma regra para acionar essa ação quando o visitante for autenticado.

Para criar uma regra para enviar as IDs do cliente

Na navegação à esquerda, clique em Regras
Clique em Adicionar regra para abrir o Construtor de regras
Atribua um nome à regra All Pages - Library Loaded - Authenticated - 10

TIP
Essa convenção de nomenclatura indica que você está acionando essa regra na parte superior de todas as páginas quando o usuário é autenticado e terá uma ordem de "10". Usar uma convenção de nomenclatura como essa (em vez de nomeá-la para as soluções acionadas nas ações) permitirá minimizar o número geral de regras necessárias para sua implementação.
Em Eventos, clique em Adicionar
1. Para o Tipo de Evento, selecione Biblioteca Carregada (Início da Página)
2. Expanda a seção Opções Avançadas e, para o Pedido, digite 10. A ordem controla a sequência de regras acionadas pelo mesmo evento. Regras com uma ordem menor serão acionadas antes de regras com uma ordem maior. Nesse caso, é necessário definir a ID do cliente antes de acionar a solicitação do Target, o que você fará na próxima lição com uma regra com ordem de 50
3. Clique no botão Manter alterações para retornar ao Construtor de regras
Em Condições, clique em Adicionar
1. Para o Tipo de Condição, selecione Comparação de Valores
2. Clique no para abrir o modal do Elemento de dados
3. No Modal do elemento de dados, clique em Estado de autenticação e em Selecionar
Certifique-se de que Equals seja o operador
Digite "conectado" no campo de texto; isso faz com que a regra seja acionada sempre que o elemento de dados “Estado de autenticação” tiver um valor “conectado”
Clique em Manter alterações
Em Ações, clique em Adicionar
1. Para a Extensão, selecione o Serviço da Experience Cloud ID
2. No Tipo de ação, selecione Definir IDs do cliente
3. Para o Código de integração, digite crm_id
4. Para o Valor, insira Abrir o seletor de Elemento de Dados e selecione o Email (Hashed)
5. Para o Estado de autenticação, selecione Autenticado
6. Clique no botão Manter alterações para salvar a ação e retornar ao Construtor de regras
Clique no botão Salvar na Biblioteca e na Build para salvar a regra

Agora você criou uma regra que enviará a ID do cliente como uma variável crm_id quando o visitante for autenticado. Como você especificou a Ordem como 10 esta regra será acionada antes da regra All Pages - Library Loaded ser criada na lição Adicionar elementos de dados, regras e bibliotecas que usa o valor padrão da Ordem de 50.

Validar as IDs do cliente

Para validar seu trabalho, você fará logon no site Luma para confirmar o comportamento da nova regra.

Para acessar o site Luma

Abra o site Luma.
Certifique-se de que o Depurador está mapeando a propriedade da tag para o seu ambiente de desenvolvimento, conforme descrito na lição anterior
Clique no link LOGON no canto superior direito do site Luma
Digite test@test.com como nome de usuário
Digite test como senha
Clique no botão LOGON
Retorne à Página inicial

Agora, confirme se a ID do cliente foi enviada para o Serviço usando a extensão Debugger.

Para validar se o serviço de identidade está transmitindo a ID do cliente

Verifique se a guia com o site Luma está em foco
No Debugger, acesse a guia Serviço de identidade da Adobe Experience Platform
Expanda a ID da organização
Clique na célula com o valor Customer ID - crm_id
No modal, observe o valor da ID do cliente e que o estado AUTHENTICATED foi refletido:
Observe que pode confirmar o valor de email com hash exibindo o código de origem da página do Luma e observando a propriedade de nome de usuário. A propriedade deve corresponder ao valor que você vê no Debugger:

Dicas adicionais de validação

As tags também têm recursos avançados de registro no console. Para ativá-las, vá para a guia Ferramentas no Debugger e ative a opção Logon do Console de tags.

Alternar no log de console das marcas

Isso ativa o logon do console, tanto no console do navegador quanto na guia Logs do Debugger. Você deve ver o registro de todas as regras criadas até agora! Observe que as novas entradas de log são adicionadas à parte superior da lista; portanto, a regra "Todas as páginas - Biblioteca carregada - 10" deve ser acionada antes da regra “Todas as páginas - Biblioteca carregada” e aparecer abaixo dele no registro do console do Debugger:

Guia Registros do Debugger

Próximo: "Adicionar o Adobe Target" >

recommendation-more-help