Configurar a extensão de tag do SDK da Web

Última atualização em 2023-12-04
  • Tópicos
  • Tags
    Exibir mais informações sobre este tópico
  • Criado para:
  • Developer
    User
    Admin
    Leader

A variável Web SDK A extensão de tag envia dados para a Adobe Experience Cloud a partir das propriedades da Web por meio da Rede de borda do Experience Platform.

A extensão permite transmitir dados para a Platform, sincronizar identidades, processar sinais de consentimento do cliente e coletar automaticamente dados de contexto.

Este documento explica como configurar a extensão de tag na interface do usuário de tags.

Instalar a extensão de tag do SDK da Web

A extensão de tag do SDK da Web precisa de uma propriedade para ser instalada. Se ainda não tiver feito isso, consulte a documentação em criação de uma propriedade de tag.

Após criar uma propriedade, abra a propriedade e selecione a variável Extensões na barra lateral esquerda.

Selecione o Catálogo guia. Na lista de extensões disponíveis, localize o Web SDK e selecione Instalar.

Imagem mostrando a interface do usuário de tags com a extensão SDK da Web selecionada

Depois de selecionar Instalar, você deve configurar a extensão de tag do SDK da Web e salvar a configuração.

OBSERVAÇÃO

A extensão de tag só é instalada depois de salvar a configuração. Consulte as próximas seções para saber como configurar a extensão de tag.

Definir configurações de instância

As opções de configuração na parte superior da página informam à Adobe Experience Platform para onde rotear os dados e quais configurações usar no servidor.

Imagem que mostra as configurações gerais da extensão de tag do SDK da Web na interface do usuário de tags

  • Nome: a extensão SDK da Web do Adobe Experience Platform oferece suporte a várias instâncias na página. O nome é usado para enviar dados para várias organizações com uma configuração de tag. O nome da instância é padronizado como alloy. No entanto, é possível alterar o nome da instância para qualquer nome de objeto JavaScript válido.
  • IMS organization ID: a ID da organização para a qual você deseja que os dados sejam enviados no Adobe. Na maioria das vezes, use o valor padrão preenchido automaticamente. Quando houver várias instâncias na página, preencha esse campo com o valor da segunda organização para a qual deseja enviar dados.
  • Domínio de borda: o domínio do qual a extensão envia e recebe dados. O Adobe recomenda usar um domínio próprio (CNAME) para essa extensão. O domínio padrão de terceiros funciona em ambientes de desenvolvimento, mas não é adequado para ambientes de produção. As instruções sobre como configurar um CNAME primário estão listadas aqui.

Definir configurações de sequência de dados

Essa seção permite selecionar os fluxos de dados que devem ser usados para cada um dos três ambientes disponíveis (produção, preparo e desenvolvimento).

Quando uma solicitação é enviada para a Rede de borda, uma ID de fluxo de dados é usada para fazer referência à configuração do lado do servidor. Você pode atualizar a configuração sem precisar fazer alterações de código no site.

Consulte o guia sobre sequências de dados para saber como configurar um fluxo de dados.

Você pode escolher um fluxo de dados nos menus suspensos disponíveis ou selecionar Inserir valores e insira uma ID de fluxo de dados personalizada para cada ambiente.

Imagem que mostra as configurações de sequência de dados da extensão de tag do SDK da Web na interface do usuário de tags

Definir configurações de privacidade

Esta seção permite configurar como o SDK da Web lida com sinais de consentimento do usuário do seu site. Especificamente, ela permite selecionar o nível padrão de consentimento assumido de um usuário se nenhuma outra preferência de consentimento explícito tiver sido fornecida.

O nível de consentimento padrão não é salvo no perfil do usuário.

Imagem mostrando as configurações de privacidade da extensão de tag do SDK da Web na interface do usuário de tags

Nível de consentimento padrão Descrição
Entrada Colete eventos que ocorrem antes de o usuário fornecer preferências de consentimento.
Saída Descartar eventos que ocorrem antes de o usuário fornecer preferências de consentimento.
Pending Enfileirar eventos que ocorrem antes de o usuário fornecer preferências de consentimento. Quando as preferências de consentimento são fornecidas, os eventos são coletados ou descartados, dependendo das preferências fornecidas.
Fornecido pelo elemento de dados O nível de consentimento padrão é determinado por um elemento de dados separado que você define. Ao usar essa opção, você deve especificar o elemento de dados usando o menu suspenso fornecido.
DICA

Uso Saída ou Pending se você precisar de consentimento explícito do usuário para suas operações comerciais.

Definir configurações de identidade

Esta seção permite definir o comportamento do SDK da Web quando se trata de lidar com a identificação do usuário.

Imagem que mostra as configurações de identidade da extensão de tag do SDK da Web na interface do usuário de tags

  • Migrar ECID da VisitorAPI: essa opção é ativada por padrão. Quando esse recurso está ativado, o SDK pode ler a variável AMCV e s_ecid cookies e defina o AMCV cookie usado por Visitor.js. Esse recurso é importante ao migrar para o SDK da Web, pois algumas páginas ainda podem estar usando Visitor.js. Essa opção permite que o SDK continue usando a mesma ECID para que os usuários não sejam identificados como dois usuários separados.
  • Usar cookies de terceiros: quando esta opção é ativada, o SDK da Web tenta armazenar um identificador do usuário em um cookie de terceiros. Se for bem-sucedido, o usuário será identificado como um único usuário durante a navegação em vários domínios, em vez de ser identificado como um usuário separado em cada domínio. Se essa opção estiver ativada, o SDK ainda poderá não ser capaz de armazenar o identificador do usuário em um cookie de terceiros se o navegador não for compatível com cookies de terceiros ou tiver sido configurado pelo usuário para não permitir cookies de terceiros. Nesse caso, o SDK armazena apenas o identificador no domínio próprio.

Definir configurações de personalização

Esta seção permite configurar como você deseja ocultar determinadas partes de uma página enquanto o conteúdo personalizado é carregado. Isso garante que seus visitantes vejam apenas a página personalizada.

Imagem que mostra as configurações de personalização da extensão de tag do SDK da Web na interface do usuário de tags

  • Migração do Target da at.js para o SDK da Web: use esta opção para ativar Web SDK para ler e gravar o legado mbox e mboxEdgeCluster cookies usados pela at.js 1.x ou 2.x bibliotecas. Isso ajuda a manter o perfil do visitante ao mover de uma página que usa o SDK da Web para uma página que usa at.js 1.x ou 2.x bibliotecas e vice-versa.

Estilo pré-ocultação

O editor de estilo pré-ocultação permite definir regras CSS personalizadas para ocultar seções específicas de uma página. Quando a página é carregada, o SDK da Web usa esse estilo para ocultar as seções que precisam ser personalizadas, recupera a personalização e desoculta as seções de página personalizadas. Dessa forma, seus visitantes visualizam as páginas já personalizadas, sem ver o processo de recuperação da personalização.

Pré-ocultação de trecho

O trecho pré-ocultação é útil quando a biblioteca do SDK da Web é carregada de forma assíncrona. Nessa situação, para evitar oscilação, recomendamos ocultar o conteúdo antes que a biblioteca do SDK da Web seja carregada.

Para usar o trecho pré-ocultação, copie-o e cole-o dentro do <head> elemento da sua página.

IMPORTANTE

Ao usar o trecho pré-ocultação, o Adobe recomenda usar o mesmo CSS regra como a usada pelo estilo pré-ocultação.

Definir configurações da coleção de dados

Imagem que mostra as configurações da coleção de dados da extensão de tag do SDK da Web na interface do usuário de tags

  • Função de retorno de chamada: a função de retorno de chamada fornecida na extensão também é chamada de onBeforeEventSend função na biblioteca. Essa função permite modificar eventos globalmente antes que sejam enviados para a Rede de borda. Informações mais detalhadas sobre como usar esta função podem ser encontradas aqui.
  • Ativar a coleta de dados de cliques: o SDK da Web pode coletar automaticamente informações de cliques em links para você. Por padrão, esse recurso está ativado, mas pode ser desativado usando essa opção. Os links também são rotulados como links de download se contiverem uma das expressões de download listadas no Baixar qualificador de link caixa de texto. O Adobe fornece alguns qualificadores padrão de link de download. Você pode editá-los de acordo com suas necessidades.
  • Dados de contexto coletados automaticamente: por padrão, o SDK da Web coleta determinados dados de contexto relacionados ao dispositivo, Web, ambiente e contexto de local. Se quiser ver uma lista dos Adobe de informações coletados, você pode encontrá-la aqui. Se não quiser que esses dados sejam coletados ou se quiser apenas determinadas categorias de dados, selecione Informações de contexto específicas e selecione os dados que deseja coletar.

Configurar substituições de sequência de dados

As substituições de sequência de dados permitem definir configurações adicionais para suas sequências de dados, que são transmitidas para a rede de borda por meio do SDK da Web.

Isso ajuda a acionar comportamentos de sequência de dados diferentes dos tradicionais sem criar uma nova sequência de dados ou modificar as configurações existentes.

Criar uma substituição de configuração da sequência de dados é um processo de duas etapas:

  1. Primeiro, você deve definir as substituições de configuração da sequência na página de configuração da sequência de dados.
  2. Em seguida, você deve enviar as substituições para a Rede de borda por meio de um comando do SDK da Web ou usando a extensão de tag do SDK da Web.

Ver a sequência de dados documentação de substituições de configuração para obter instruções detalhadas sobre como substituir configurações de sequência de dados.

Como alternativa à transmissão de sobreposições por meio de um comando do SDK da Web, você pode configurar as sobreposições na tela de extensão de tag mostrada abaixo.

IMPORTANTE

As substituições de fluxo de dados devem ser configuradas com base no ambiente. Os ambientes de desenvolvimento, armazenamento temporário e produção têm substituições separadas. Você pode copiar as configurações entre elas usando as opções dedicadas mostradas na tela abaixo.

Imagem que mostra as sobreposições de configuração da sequência de dados na página de extensão de tag do SDK da Web.

Definir configurações avançadas

Use o Caminho base da borda se precisar alterar o caminho base usado para interagir com a rede de borda. Isso não deve exigir atualização, mas no caso de você participar de um beta ou alfa, o Adobe pode solicitar que você altere esse campo.

Imagem que mostra as configurações avançadas na página de extensão de tag do SDK da Web.

Nesta página