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.
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.
Depois de selecionar Instalar, você deve configurar a extensão de tag do SDK da Web e salvar a configuraçã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.
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.
alloy
. No entanto, é possível alterar o nome da instância para qualquer nome de objeto JavaScript válido.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.
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.
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. |
Uso Saída ou Pending se você precisar de consentimento explícito do usuário para suas operações comerciais.
Esta seção permite definir o comportamento do SDK da Web quando se trata de lidar com a identificação do usuário.
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.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.
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.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.
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.
Ao usar o trecho pré-ocultação, o Adobe recomenda usar o mesmo CSS regra como a usada pelo estilo pré-ocultação.
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.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:
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.
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.
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.