Documentação Experience Platform Tutorial do SDK da web

Configurar o Audience Manager com o SDK da Web da plataforma

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

Tópicos:

Criado para:

Iniciante
Intermediário
Desenvolvedor

Saiba como configurar o Adobe Audience Manager usando o SDK da web da Adobe Experience Platform e validar a implementação usando um destino de cookie.

O Adobe Audience Manager é a solução da Adobe Experience Cloud que fornece tudo o que é necessário para coletar informações comercialmente relevantes sobre os visitantes do site, criar segmentos comercializáveis e veicular publicidade e conteúdo direcionados ao público certo.

SDK da Web e diagrama do Adobe Audience Manager

Objetivos de aprendizagem

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

Configurar um fluxo de dados para habilitar o Audience Manager
Ativar um destino de cookie no Audience Manager
Valide a implementação do Audience Manager confirmando a qualificação de público-alvo com o Adobe Experience Platform Debugger

Pré-requisitos

Para concluir esta lição, primeiro você deve:

Conclua as lições anteriores nas seções Configuração inicial e Configuração de tags deste tutorial.
Ter acesso ao Adobe Audience Manager e às permissões apropriadas para criar, ler e gravar características, segmentos e destinos. Para obter mais informações, reveja o Controle de Acesso Baseado em Função do Audience Manager.

Configurar o fluxo de dados

A implementação do Audience Manager usando o SDK da Web da Platform é diferente da implementação usando o encaminhamento pelo lado do servidor (SSF). O encaminhamento pelo lado do servidor passa dados de solicitação Adobe Analytics para o Audience Manager. Uma implementação do SDK da Web da Platform passa dados XDM enviados para o Edge Network da plataforma para o Audience Manager. O Audience Manager está ativado na sequência de dados:

Ir para a interface Coleção de Dados
Na navegação à esquerda, selecione Datastreams
Selecionar a sequência de dados Luma Web SDK: Development Environment criada anteriormente
Selecione Adicionar Serviço
Selecione Adobe Audience Manager como o Serviço
Confirme se os Destinos de cookies habilitados e os Destinos de URL habilitados estão selecionados
Selecione Salvar

Criar uma fonte de dados

Em seguida, crie um Data Source, uma ferramenta fundamental para organizar os dados no Audience Manager:

Ir para a interface Audience Manager
Selecione Dados do público-alvo na navegação superior
Selecione as Fontes de dados no menu suspenso
Selecione o botão Adicionar novo na parte superior da página de Fontes de dados
Dê um nome e uma descrição amigáveis à Source de dados. Para a configuração inicial, você pode nomear este Platform Web SDK tutorial.
Definir Tipo de ID como Cookie
Na seção Controles da Exportação de Dados, selecione Sem Restrição
Salvar o Data Source

Criar uma característica

Depois que a Source de dados for salva, configure uma característica. As características são uma combinação de um ou mais sinais no Audience Manager. Crie uma característica para visitantes de página inicial.

NOTE

Todos os dados XDM são enviados para o Audience Manager se estiverem ativados no fluxo de dados. No entanto, os dados podem levar 24 horas até estarem disponíveis no relatório Sinais não usados. Crie características explícitas para os dados XDM que você deseja usar imediatamente no Audience Manager, conforme descrito neste exercício.

Selecione Dados de Público > Características
Selecione Adicionar novo > Baseado em regras característica
Dê um nome e uma descrição amigáveis para sua característica, Luma homepage view
Selecione o Data Source criado na seção anterior.
Selecione uma Pasta na qual salvar sua característica no painel à direita. Talvez você queira criar uma pasta selecionando o ícone + ao lado de uma pasta pai existente. Você pode nomear esta nova pasta Platform Web SDK tutorial.
Expanda o sinal de interpolação Expressão de característica e selecione Construtor de expressão. Você deve fornecer um par de valores chave que signifique uma visita à página inicial.
Abra a página inicial do Luma (mapeada para a propriedade de marca ) e o Adobe Experience Platform Debugger e atualize a página.
Examine as Solicitações de rede e os detalhes do evento do SDK da Web da plataforma para encontrar a chave e o valor de nome para a página inicial.
Retorne ao Construtor de Expressões na Interface do Usuário do Audience Manager e insira a chave como web.webPageDetails.name e o valor de content:luma:us:en. Essa etapa garante que você acione uma característica sempre que carregar a página inicial.
Salve a característica.

Criar um segmento

As próximas etapas são para criar um segmento e atribuir sua característica recém-definida a este segmento.

Selecione Dados de público na navegação superior e selecione Segmentos
Selecione Adicionar novo na parte superior esquerda da página para abrir o construtor de segmentos
Dê um nome e uma descrição amigáveis para o seu segmento, como Platform Web SDK - Homepage visitors
Selecione uma Pasta onde seu segmento é salvo no painel à direita. Talvez você queira criar uma pasta selecionando o ícone + ao lado de uma pasta pai existente. Você pode nomear esta nova pasta Platform Web SDK tutorial.
Adicione um código de integração, que, nesse caso, é um conjunto aleatório de números.
Na seção Data Source, selecione Audience Manager e a fonte de dados criada anteriormente
Expanda a seção Características e procure a característica que você criou
Selecione Adicionar Característica.
Selecione Salvar na parte inferior da página

Criar um destino

Em seguida, crie um Destino baseado em cookies usando o Construtor de Destinos. O Construtor de destinos permite criar e gerenciar cookies, URL e destinos de servidor para servidor.

Abra o Construtor de Destinos selecionando Destinos no menu Dados de Público na navegação superior
Selecionar Criar Destino
Digite um nome e uma descrição, Platform Web SDK tutorial
Como a Categoria, selecione Personalizado
Como o Tipo, selecione Cookie
Abra a seção Configuração para inserir os detalhes sobre seu destino de cookie
Dê um nome amigável ao seu cookie, platform_web_sdk_tutorial
Como o Domínio de Cookie, adicione o domínio do site onde você está planejando a integração, para a entrada do tutorial no domínio Luma, luma.enablementadobe.com
Como a opção Dados do Publish para, selecione Somente os domínios selecionados
Selecione seu domínio se ainda não tiver sido adicionado
Como o Formato dos Dados, selecione Chave Única e dê uma chave ao seu cookie. Para este tutorial, use segment como valor de chave.
Finalmente, selecione Salvar para salvar os detalhes da configuração de destino.
Na seção Mapeamentos de Segmentos, use o recurso Pesquisar e Adicionar Segmentos para pesquisar o Platform Web SDK - Homepage visitors criado anteriormente e selecione Adicionar.
Depois de adicionar o segmento, uma janela pop-up é aberta, onde você deve fornecer um valor esperado para o cookie. Para este exercício, insira o valor "hpvisitor".
Selecione Salvar
Selecionar Concluído

O período de mapeamento de segmento requer algumas horas para ser ativado. Depois de concluído, você pode atualizar a interface do Audience Manager e ver se a lista Segmentos mapeados foi atualizada.

Validar o segmento

Algumas horas após a criação inicial do segmento, você pode validar se ele está funcionando corretamente.

Primeiro, confirme se você pode se qualificar para o segmento

Abra a página inicial do site de demonstração Luma com ela mapeada para a propriedade de marca para se qualificar para o segmento recém-criado.
Abra a guia Ferramentas do desenvolvedor > Rede do navegador
Filtrar para a solicitação do SDK da Web da Platform usando interact como filtro de texto
Selecione uma chamada e abra a guia Visualizar para exibir os detalhes da resposta
Expanda a carga para exibir os detalhes do cookie esperado, conforme configurado anteriormente no Audience Manager. Neste exemplo, você verá o nome de cookie esperado platform_web_sdk_tutorial.
Abra a guia Aplicativo e abra Cookies no menu Armazenamento.
Selecione o domínio https://luma.enablementadobe.com e confirme se seu cookie foi escrito corretamente na lista

Finalmente, você deve abrir o segmento na interface do Audience Manager e garantir que as Populações de segmentos tenham aumentado:

Audience Manager Adobe Experience Platform Adicionar Característica

Agora que concluiu esta lição, você deve ser capaz de ver como o SDK da Web da Platform transmite dados para o Audience Manager e pode definir um cookie próprio específico de segmento com um destino de cookie.

NOTE

Obrigado por investir seu tempo aprendendo sobre o Adobe Experience Platform Web SDK. Se você tiver dúvidas, quiser compartilhar comentários gerais ou tiver sugestões sobre conteúdo futuro, compartilhe-as nesta postagem de Discussão da Comunidade Experience League

recommendation-more-help