DocumentaçãoExperience PlatformTutorial da Web

Adicionar o Identity Service da Adobe Experience Platform

Last update: Wed Nov 16 2022 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Beginner
  • Intermediate
  • Developer

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

O Identity Service da Adobe Experience Platform 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 as 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).

NOTE
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 de que você deve estar ciente ao usar este conteúdo:
  • O Platform launch (lado do cliente) agora está tags
  • Agora o lado do servidor do Platform launch event forwarding
  • As configurações de borda 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

Você já deveria ter concluído as lições na Configurar tags seção.

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

  1. Na navegação à esquerda, clique em Extensões

  2. Clique em Catálogo para acessar a página Catálogo de extensões

  3. Observe a variedade de extensões disponíveis no Catálogo

  4. No filtro na parte superior, digite "id" para filtrar o catálogo

  5. No cartão do Adobe Experience Platform Identity Service, clique em Instalar

    Instalar a extensão do Serviço de Identidade

  6. Observe que a sua ID da organização na Experience Cloud foi detectada automaticamente para você

  7. Deixe todas as configurações padrão e clique em Salvar na biblioteca e na criar

    Salvar a extensão

NOTE
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

  1. Abra o site Luma.

  2. Certifique-se de que o Debugger esteja mapeando a propriedade da tag para your Ambiente de desenvolvimento, conforme descrito no lição anterior.

  3. Na guia Resumo do Debugger, a seção de tags deve indicar que a extensão do Adobe Experience Platform Identity Service está implementada.

  4. Além disso, na guia Resumo, a seção Serviço de identidade deve ser preenchida com a mesma ID de organização mostrada na tela de configuração de extensão na interface da Coleta de dados:

    Verifique se a extensão Adobe Experience Platform Identity Service está implementada

  5. 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:
    Verifique se há uma solicitação para o Serviço de identidade com sua ID da organização

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

      Verifique o cookie AMCV_

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:

  1. Authentication State—para capturar se o visitante estiver ou não conectado
  2. 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

  1. Clique em Elementos de dados na navegação à esquerda

  2. Clique no botão Adicionar elemento de dados

    Clique em Adicionar elemento de dados

  3. Nomeie o elemento de dados Authentication State

  4. Para o Tipo de elemento de dados, selecione Código personalizado

  5. Clique no botão Abrir editor

    Abra o Editor para adicionar o Código personalizado do elemento de dados

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

  7. Clique em Salvar para salvar o código personalizado

    Salve o código personalizado

  8. Deixe todas as outras configurações em seus valores padrão

  9. Clique em Salvar na biblioteca para salvar o elemento de dados e retornar à página de elementos de dados. Não precisaremos fazer uma "Criação" até que todas as alterações sejam feitas e estejamos prontas para validação.

    Salve o elemento de dados

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

  1. Clique no botão Adicionar elemento de dados

    Adicionar um elemento de dados

  2. Nomeie o elemento de dados Email (Hashed)

  3. Para o Tipo de elemento de dados, selecione Variável JavaScript

  4. Como o nome da variável JavaScript, use o seguinte ponteiro para obter uma variável na camada de dados do site Luma: digitalData.user.0.profile.0.attributes.username

  5. Deixe todas as outras configurações em seus valores padrão

  6. Clique em Salvar na biblioteca para salvar o elemento de dados

    Salve o elemento de dados

Adicionar uma regra para enviar as IDs do cliente

O Adobe Experience Platform Identity Service 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

  1. Na navegação à esquerda, clique em Regras

  2. Clique em Adicionar regra para abrir o Construtor de regras

    Adicionar uma regra

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

  4. Em Eventos, clique em Adicionar

    Adicionar um evento

    1. Para o Tipo de evento, selecione Biblioteca carregada (Parte superior da página)
    2. Expanda o Opções avançadas e para o Pedido enter 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

    Salvar o evento

  5. Em Condições, clique em Adicionar

    Adicionar uma condição à regra

    1. Em Tipo de condição, selecione Comparação de valores

    2. Clique no ícone Elementos de dados para abrir o modal do Elemento de dados

      abrir o modal do elemento de dados

    3. No Modal do elemento de dados, clique em Estado de autenticação e, em seguida, clique em Selecionar

      definir o estado de autenticação

  6. Certifique-se de que Equals seja o operador

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

  8. Clique em Manter alterações

    Salvar a condição

  9. Em Ações, clique em Adicionar

    Adicionar uma nova ação

    1. Para o Extensão select Serviço de ID de Experience Cloud

    2. No Tipo de ação, selecione Definir IDs do cliente

    3. No Código de integração, digite crm_id

    4. No Valor, insira Abrir o seletor de Elemento de dados e selecione o Email (Hashed)

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

      Configurar a ação e salvar as alterações

  10. Clique no botão Salvar na biblioteca e criar para salvar a regra

    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

  1. Abra o site Luma.

  2. Certifique-se de que o Debugger esteja mapeando a propriedade da tag para your Ambiente de desenvolvimento, conforme descrito no lição anterior

    Seu ambiente de desenvolvimento de tags mostrado no Debugger

  3. Clique no link LOGON no canto superior direito do site Luma

    Clique em Logon na navegação superior

  4. Digite test@adobe.com como nome de usuário

  5. Digite test como senha

  6. Clique no botão LOGON

    Digite as credenciais e clique em logon

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

  1. Verifique se a guia com o site Luma está em foco

  2. No Debugger, acesse a guia Adobe Experience Platform Identity Service

  3. Expanda a ID da organização

  4. Clique na célula com o valor Customer ID - crm_id

  5. No modal, observe o valor da ID do cliente e que o estado AUTHENTICATED foi refletido:

    Confirmar a ID do cliente no Debugger

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

    email com hash no código de origem

Dicas adicionais de validação

As tags também têm recursos avançados de registro no console. Para ativá-los, acesse Ferramentas no Debugger e ative o Registro do console de tags alternar.

Alternar no registro do console das 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:

Guia Registros do Debugger

Próximo: "Adicionar o Adobe Target" >

recommendation-more-help
45774420-d03e-4a6b-94b5-cd639ae825b2