Inicializar SDKs
Siga as etapas do diagrama Inicializar SDK para garantir que todas as tarefas necessárias para carregar a biblioteca at.js de JavaScript Adobe Target sejam executadas na sequência correta.
Inicializar diagrama de SDKs diagram
Para aplicativos de várias páginas, esse fluxo ocorre sempre que a página é recarregada ou o visitante navega para uma nova página no site.
{width="600" modal="regular"}
Clique nos links a seguir para navegar até as seções desejadas:
- 1.1: Carregar SDK da API do visitante
- 1.2: Definir ID do cliente
- 1.3: Configurar solicitação automática de carregamento de página
- 1.4: Configurar o tratamento de cintilação
- 1.5: Configurar mapeamento de dados
- 1.6: Promoção
- 1.7: Critérios baseados no carrinho
- 1.8: Critérios baseados na popularidade
- 1.9: Critérios baseados em itens
- 1.10: Critérios com base no usuário
- 1.11: Critérios personalizados
- 1.12: Fornecer atributos usados nas regras de inclusão
- 1.13: Fornecer excludedIds
- 1.14: Transmitir o parâmetro entity.event.detailsOnly=true
- 1.15: Configurar mapeamento de dados remotos
- 1.16: Carregar at.js
1.1: Carregar SDK da API do visitante load
Esta etapa ajuda a garantir que a biblioteca VisitorAPI.js
seja carregada, configurada e inicializada corretamente.
{width="400" modal="regular"}
Pré-requisitos
- Para usar a ID de visitante/API Service, sua empresa deve estar habilitada para o Adobe Experience Cloud e ter um Organization ID. Para obter mais informações, consulte Requisitos de Experience Cloud: ID da Organização no guia Ajuda do Serviço de Identidade.
- Você precisa do arquivo
VisitorAPI.js
. Você já deve ter este arquivo se tiver o Adobe Analytics implementado. Este arquivo também pode ser adicionado por meio da Adobe Experience Platform extensão de tags ou pode ser baixado do Gerenciador de Códigos Adobe Analytics.
Configurar e consultar VisitorAPI.js
Para obter mais informações, consulte Implementar o Serviço Experience Cloud para Target.
Leituras
- visão geral do Experience Cloud Identity Service
- Sobre o Serviço de ID
- Cookies e o Serviço de Identidade Experience Cloud
- Como o Serviço de Identidade do Experience Cloud solicita e define IDs
- Entendendo a sincronização de ID e as taxas de correspondência
Ações
- Incorpore o arquivo
VisitorAPI.js
às suas páginas da Web. - Leia sobre as configurações disponíveis para o Serviço de ID/API do Visitante.
- Depois que o arquivo
VisitorAPI.js
for carregado, use o métodoVisitor.getInstance
para inicializar usando as configurações necessárias. - Familiarize-se com os métodos disponíveis.
1.2: Definir ID do cliente set
Essa etapa ajuda a garantir que as IDs conhecidas dos seus visitantes (CRM ID, ID de usuário e assim por diante) sejam vinculadas à ID anônima do Adobe para personalização entre dispositivos.
{width="400" modal="regular"}
Pré-requisitos
- A ID conhecida dos visitantes deve estar disponível na camada de dados.
Definir ID do Cliente
Para obter mais informações, consulte setCustomerIDs.
Leituras
Ações
- Use
visitor.setCustomerIDs
para definir a ID conhecida do visitante.
Retorne ao diagrama na parte superior desta página.
1.3: Configurar solicitação automática de carregamento de página automatic
Essa etapa permite que a at.js busque todas as experiências que devem ser renderizadas na página ao carregar o arquivo da biblioteca JavaScript at.js.
{width="400" modal="regular"}
Pré-requisitos
- Nem todos os dados na camada de dados devem ser enviados para Target. Consulte sua equipe de negócios (equipe de marketing digital) para determinar quais dados são valiosos para experimentação, otimização e personalização. Somente estes dados devem ser enviados para Target.
- Certifique-se de não enviar dados de Informações de Identificação Pessoal (PII) para Target.
Configurar solicitação automática de carregamento de página
Para obter mais informações, consulte targetGlobalSettings().
Leituras
Saiba mais sobre a configuração pageLoadEnabled
em targetGlobalSettings().
Ações
- Modifique o objeto
window.targetGlobalSettings
para habilitar solicitações automáticas de carregamento de página.
1.4: Configurar o tratamento de cintilação flicker
Essa etapa ajuda a garantir que não haja cintilação da página ao fornecer experiências.
{width="400" modal="regular"}
Pré-requisitos
- Discussões com a equipe responsável pelo desempenho da página da Web sobre os prós e contras do controle da cintilação usando o método padrão usado pela at.js. Pesquise por padrões de design que permitam usar a solução personalizada de manipulação de cintilação, como a animação de carregador. Se não encontrar um padrão, você poderá solicitar um novo padrão.
Configurar tratamento de cintilação
Para obter mais informações, consulte targetGlobalSettings().
A configuração de bodyHidingEnabled
como true
oculta o corpo inteiro da página enquanto a solicitação de carregamento de página está em andamento. Se você não tiver habilitado a solicitação automática de carregamento de página por qualquer motivo (dados não prontos posteriormente, por exemplo), é melhor definir essa configuração como false
.
Se você desabilitou o bodyHidingEnabled
porque não deseja acionar a APLR e deseja acionar a solicitação de página mais tarde, ou não precisa do tratamento de cintilação, você deve implementar seu próprio tratamento de cintilação. Você pode lidar com a cintilação de duas maneiras: ocultando as seções em teste ou mostrando um ladrão nas seções em teste.
Leituras
- Como a at.js gerencia a cintilação
- Saiba mais sobre os objetos bodyHiddenStyle e bodyHidingEnabled em targetGlobalSettings().
Ações
- Modifique o objeto
window.targetGlobalSettings
para definirbodyHiddenStyle
ebodyHidingEnabled
.
1.5: Configurar mapeamento de dados data-mapping
Esta etapa ajuda a garantir que todos os dados que devem ser enviados para Target sejam definidos.
{width="400" modal="regular"}
Pré-requisitos
-
A camada de dados deve estar pronta com todos os dados que devem ser enviados para Target.
-
Recommendations: enriqueça o perfil.
- Envie
entity.id
para capturar dados de critérios e itens visualizados recentemente com base em critérios baseados no último produto visualizado. - Envie
entity.id
para capturar dados para critérios de popularidade com base na categoria favorita. - Passe o atributo de perfil se os critérios personalizados se basearem nele ou se forem usados na filtragem da regra de inclusão em qualquer critério.
- Envie
-
Recommendations: assimilar dados do produto.
- Outros parâmetros de entidade (reservados e personalizados) podem ser passados para assimilar ou atualizar o catálogo de produtos em Recommendations.
- O catálogo de produtos também pode ser atualizado usando feeds de entidade com a interface ou a API Target.
Mapear dados paraTarget
Para obter mais informações, consulte targetPageParams().
Leituras
- targetPageParams()
- Planejar e implementar o Recommendations
- Configurar o catálogo do Recommendations
Ações
- Use a função
targetPageParams()
para definir todos os dados necessários que devem ser enviados para Target.
1.6: Promoção promotion
Adicione itens promovidos e controle o posicionamento nos Target Recommendations designs.
Opções disponíveis
- Promover por IDs
- Promover por coleção
- Promover por atributo
Parâmetros de entidade necessários
- O atributo de item na promoção deve ser passado ao usar a opção "promover por atributo".
Retorne ao diagrama na parte superior desta página.
1.7: Critérios baseados no carrinho cart
Faça recomendações com base no conteúdo do carrinho do usuário.
Critérios disponíveis
- People Who Viewed These, Viewed Those
- People Who Viewed These, Bought Those
- People Who Bought These, Bought Those
Parâmetros de entidade necessários
- cartIds
Leituras
Retorne ao diagrama na parte superior desta página.
1.8: Critérios baseados na popularidade popularity
Faça recomendações com base na popularidade geral de um item em todo o site ou na popularidade de itens na categoria, marca, gênero e assim por diante favoritas ou mais visualizadas de um usuário.
Critérios disponíveis
- Most Viewed Across the Site
- Most Viewed by Category
- Most Viewed by Item Attribute
- Top Sellers Across the Site
- Top Sellers by Category
- Top Sellers by Item Attribute
- Top by Analytics Metric
Parâmetros de entidade necessários
entity.categoryId
ou o atributo de item para popularidade com base no critério do item atual ou no atributo de item.- Nada deve ser passado para Mais visualizados/Principais vendidos no site.
Leituras
1.9: Critérios baseados em itens item
Fazer recomendações com base na localização de itens semelhantes a um item que o usuário está visualizando ou que foi visualizado recentemente.
Critérios disponíveis
- People Who Viewed This, Viewed That
- People Who Viewed This, Bought That
- People Who Bought This, Bought That
- Items with Similar Attributes
Parâmetros de entidade necessários
entity.id
ou qualquer atributo de perfil usado como uma chave
Leituras
Retorne ao diagrama na parte superior desta página.
1.10: Critérios com base no usuário user
Faça recomendações com base no comportamento do usuário.
Critérios disponíveis
- Recently Viewed Items
- Recommended for You
Parâmetros de entidade necessários
entity.id
Leituras
Retorne ao diagrama na parte superior desta página.
1.11: Critérios personalizados custom
Fazer recomendações com base em um arquivo personalizado que você carregou.
Critérios disponíveis
- Custom algorithm
Parâmetros de entidade necessários
entity.id
ou o atributo usado como uma chave para o algoritmo personalizado
Leituras
1.12: Fornecer atributos usados nas regras de inclusão inclusion
Retorne ao diagrama na parte superior desta página.
1.13: Fornecer excludedIds exclude
Transmita IDs de entidade para entidades que você deseja excluir de suas recomendações. Por exemplo, você pode desejar excluir itens que já estão no carrinho de compras.
Retorne ao diagrama na parte superior desta página.
1.14: Passar o parâmetro entity.event.detailsOnly=true
true
Use atributos de entidade para passar informações sobre o produto ou conteúdo para Target Recommendations.
Leituras
Retorne ao diagrama na parte superior desta página.
1.15: Configurar mapeamento de dados remotos (remoto)
Esta etapa garante que todos os dados que devem ser enviados para Target sejam definidos.
{width="400" modal="regular"}
Pré-requisitos
- A camada de dados deve estar pronta com todos os dados que devem ser enviados para Target.
Configurar provedores de dados
Para obter mais informações, consulte Provedores de dados.
Leituras
Ações
Use a função targetPageParams()
para definir todos os dados necessários que devem ser enviados para Target.
1.16: Carregar at.js web
Essa etapa garante que a biblioteca JavaScript at.js seja carregada e inicializada.
{width="400" modal="regular"}
Pré-requisitos
- Baixe ou peça o arquivo da biblioteca JavaScript
at.js 2.*x*
à sua equipe de marketing digital.
Leituras
Ações
Incorpore o arquivo at.js em todas as páginas da Web em que experimentação, otimização, personalização e coleta de dados devem ocorrer.
Retorne ao diagrama na parte superior desta página.
Vá para a Etapa 2: Configurar a coleta de dados.