Adicionar o Serviço de identidade da Adobe Experience Platform
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 de Adobe para potencializar recursos de 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).
- 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
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:-
Abra as Ferramentas do desenvolvedor do seu navegador.
-
Acesse a guia
Application
. -
Expanda
Cookies
no lado esquerdo. -
Clique no domínio
https://luma.enablementadobe.com
-
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 conectadoEmail (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:
code language-javascript 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
note tip 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
- Para o Tipo de Evento, selecione Biblioteca Carregada (Início da Página)
- 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 de50
- Clique no botão Manter alterações para retornar ao Construtor de regras
-
Em Condições, clique em Adicionar
-
Para o Tipo de Condição, selecione Comparação de Valores
-
Clique no para abrir o modal do Elemento de dados
-
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
-
Para a Extensão, selecione o Serviço de ID de Experience Cloud
-
No Tipo de ação, selecione Definir IDs do cliente
-
Para o Código de integração, digite
crm_id
-
Para o Valor, insira Abrir o seletor de Elemento de Dados e selecione o
Email (Hashed)
-
Para o Estado de autenticação, selecione Autenticado
-
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@adobe.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.
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:
Próximo: "Adicionar o Adobe Target" >