DocumentaçãoTargetGuia do desenvolvedor do Target

Inicializar SDKs

Última atualização: 5 de maio de 2025
  • Tópicos:
  • APIs/SDKs

Criado para:

  • Experiente
  • Desenvolvedor

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.

DICA
Clique nas imagens neste tópico para expandir para tela inteira.

Inicializar diagrama de SDKs

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.

OBSERVAÇÃO
Os números de etapa na ilustração a seguir correspondem às seções abaixo. Os números de etapa não estão em uma ordem específica e não refletem a ordem das etapas realizadas na interface do usuário Target ao criar a atividade.

Inicializar o diagrama de SDKs

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

Esta etapa ajuda a garantir que a biblioteca VisitorAPI.js seja carregada, configurada e inicializada corretamente.

Ver detalhes

Carregar diagrama do SDK da API de Visitante

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étodo Visitor.getInstance para inicializar usando as configurações necessárias.
  • Familiarize-se com os métodos disponíveis.

Retorne ao diagrama na parte superior desta página.

1.2: Definir ID do cliente

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.

Ver detalhes

Definir ID do Cliente

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

  • Sincronização de perfil em tempo real para mbox3rdPartyId

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

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.

Ver detalhes

Configurar solicitação automática de carregamento de página

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.

Retorne ao diagrama na parte superior desta página.

1.4: Configurar o tratamento de cintilação

Essa etapa ajuda a garantir que não haja cintilação da página ao fornecer experiências.

Ver detalhes

Configurar diagrama de manipulação de cintilação

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 definir bodyHiddenStyle e bodyHidingEnabled.

Retorne ao diagrama na parte superior desta página.

1.5: Configurar mapeamento de dados

Esta etapa ajuda a garantir que todos os dados que devem ser enviados para Target sejam definidos.

Ver detalhes

Diagrama de mapeamento de dados

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.

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

Retorne ao diagrama na parte superior desta página.

1.6: Promoção

Adicione itens promovidos e controle o posicionamento nos Target Recommendations designs.

Ver detalhes

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

Faça recomendações com base no conteúdo do carrinho do usuário.

Ver detalhes

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

  • Baseado em carrinho

Retorne ao diagrama na parte superior desta página.

1.8: Critérios baseados na popularidade

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.

Ver detalhes

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

  • Com base em popularidade

Retorne ao diagrama na parte superior desta página.

1.9: Critérios baseados em itens

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.

Ver detalhes

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

  • Baseado em item

Retorne ao diagrama na parte superior desta página.

1.10: Critérios com base no usuário

Faça recomendações com base no comportamento do usuário.

Ver detalhes

Critérios disponíveis

  • Recently Viewed Items
  • Recommended for You

Parâmetros de entidade necessários

  • entity.id

Leituras

  • Baseado em usuário

Retorne ao diagrama na parte superior desta página.

1.11: Critérios personalizados

Fazer recomendações com base em um arquivo personalizado que você carregou.

Ver detalhes

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

  • Critérios personalizados

Retorne ao diagrama na parte superior desta página.

1.12: Fornecer atributos usados nas regras de inclusão

Ver detalhes

Leituras

  • Usar regras de inclusão estática e dinâmica

Retorne ao diagrama na parte superior desta página.

1.13: Fornecer excludedIds

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.

Ver detalhes

Leituras

  • Posso excluir dinamicamente uma entidade?

Retorne ao diagrama na parte superior desta página.

1.14: Passar o parâmetro entity.event.detailsOnly=true

Use atributos de entidade para passar informações sobre o produto ou conteúdo para Target Recommendations.

Ver detalhes

Leituras

  • Atributos da entidade

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.

Ver detalhes

Diagrama de mapeamento de dados remoto

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

função targetPageParams

Ações

Use a função targetPageParams() para definir todos os dados necessários que devem ser enviados para Target.

Retorne ao diagrama na parte superior desta página.

1.16: Carregar at.js

Essa etapa garante que a biblioteca JavaScript at.js seja carregada e inicializada.

Ver detalhes

Carregar diagrama at.js do Adobe Target

Pré-requisitos

  • Baixe ou peça o arquivo da biblioteca JavaScript at.js 2.*x* à sua equipe de marketing digital.

Leituras

  • Como o Target funciona
  • Como a at.js funciona
  • Implementação do Target sem um gerenciador de tags

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.

recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3