Perguntas frequentes

Este guia fornece respostas a perguntas frequentes sobre o Adobe Experience Platform Web SDK.

O que é o Adobe Experience Platform Web SDK?

O Adobe Experience Platform Web SDK é uma biblioteca JavaScript no lado do cliente que permite aos clientes da Adobe Experience Cloud interagir com os vários serviços na Experience Cloud.

Ele envia dados de forma independente de solução (XDM) para a Rede de borda da Adobe Experience Platform, que mapeia os dados para formatos e destinos específicos da solução e os envia em tempo real.

Mais informações
apresentação do Adobe Summit

Em que o Adobe Experience Platform Web SDK difere das soluções anteriores?

Antes do Adobe Experience Platform SDK

Atualmente, é necessário implantar diferentes bibliotecas JavaScript com base em cada solução individual.

  • Cada solução tem sua própria biblioteca, esquema e domínio do JavaScript.
  • Nenhuma dessas bibliotecas foi criada para funcionar entre si.
  • Casos de uso entre soluções e Adobe Experience Platform exigem que essas bibliotecas diferentes sejam interdependentes, causando atrito na implantação.

Embora as tags na Platform facilitem o máximo possível a implantação e o gerenciamento dessas bibliotecas, ainda há problemas com:

  • Tamanho da biblioteca (excesso de código de Adobe em uma página)
  • Desempenho (os sites demoram muito para carregar)
  • Várias chamadas para um único caso de uso
  • Aguardar o retorno de ECID antes das chamadas de personalização (causa atraso)
  • Coleta de dados fraturada (o que é uma evar?)
  • Confusão de esquema entre soluções (A4T)
  • Muitas outras coisas menos ótimas

Além disso, atualmente não há nenhuma biblioteca JavaScript que envie dados diretamente para a Adobe Experience Platform.

Com o Adobe Experience Platform Web SDK

O novo SDK da Web envia dados das seguintes soluções para um único destino (Adobe Experience Platform Edge Network) e resolve os casos de uso mais comuns da solução mencionada acima.

  • Adobe Analytics
  • Adobe Audience Manager
  • Adobe Target
  • ID de visitante
  • Adobe Experience Platform

Outras soluções seguirão no final deste ano.

O SDK da Web da Adobe Experience Platform também pode enviar dados diretamente para a Adobe Experience Platform. Esses dados estão no XDM e são mapeados para o esquema da solução do lado do servidor.

Qual é o valor desse novo SDK da Web?

Desempenho: O SDK da Web é menor do que o uso de todas as bibliotecas de Adobe atuais e fornece carregamentos de página significativamente mais rápidos.

Simplicidade: A combinação de XDM, SDK da Web, tags, rede de borda, soluções da Adobe Experience Cloud e Adobe Experience Platform cria uma história de coleta de dados fácil de entender e simples de seguir.

  • XDM: O esquema independente de solução usado para enviar dados para o Adobe. Não há mais tags para evars ou mboxes.
  • Adobe Experience Platform Web SDK: Facilita o envio e o recebimento de dados para a Rede de borda da Adobe Experience Platform.
  • Tags: Simplifica a implantação e a configuração do SDK da Web (e de qualquer outra tag JavaScript) em um site.
  • Rede de borda: Direcione facilmente os dados para a Adobe Experience Platform e as soluções no formato necessário.
  • Soluções Adobe Experience Platform e Adobe: Ative a proposta de valor.

Controle: Como todos os dados estão usando um único fluxo conectado de dados, você pode acompanhar e controlar logicamente como os dados se parecem a cada milissegundo de sua jornada, de e para aplicativos.

Moderno e pronto para o futuro: O SDK da Web e sua conexão com a rede de borda permitiram que o Adobe modernizasse significativamente a maneira como o Adobe lida com a coleta de dados, personalização, consentimento e o futuro dos cookies de terceiros. (Ele permite um domínio próprio, gerenciado pelo Adobe.)

Tempo de implantação: O Adobe trabalhou muito (e continuará) para facilitar ao máximo a implantação do SDK da Web por meio de tags e o mapeamento de dados do lado do cliente para o XDM. Depois que esse trabalho for concluído, todas as outras soluções Adobe e serviços da Adobe Experience Platform poderão ser ativados ou desativados no lado do servidor. Por exemplo, se estiver usando isso para Adobe Analytics e quiser ativar o Target ou Experience Platform, basta virar um botão de alternância na configuração do Datastream e ativar esses casos de uso.

O que é Alloy?

Alloy é o nome de código do SDK da Web do Adobe Experience Platform. Ele é usado no código-fonte e no nome do arquivo do SDK, embora o SDK da Web do Adobe Experience Platform seja o nome oficial.

Os clientes precisam comprar o Adobe Experience Platform para usar o Web SDK?

Não. Qualquer cliente da Adobe Digital Experience pode usar o SDK da Web da Adobe Experience Platform gratuitamente. Clientes que desejam usar o Web SDK O precisará configurar as permissões certas para criar esquemas, conjuntos de dados, namespaces de identidade e fluxos de dados na interface da Coleção de dados ou na interface do Experience Platform.

Para obter mais informações sobre como configurar essas permissões, consulte nossa documentação em gerenciamento de permissões de coleta de dados.

Quem deve usar o SDK da Web?

O Adobe Experience Platform Web SDK foi desenvolvido para as seguintes pessoas:

  • Usuários do Adobe Experience Platform

    • Se você precisar enviar dados diretamente de um dispositivo para o Adobe Experience Platform, essa é a maneira oficialmente recomendada.
    • A Adobe está ciente de que o uso do conector do Adobe Analytics é mais rápido se o cliente já tiver o Adobe Analytics, mas essa não é a estratégia de longo prazo para a coleta de dados.

  • Clientes de soluções da Adobe Experience Cloud

    • Os novos clientes do Adobe Analytics, Adobe Audience Manager e Adobe Target devem começar com o novo SDK da Web e não usar bibliotecas herdadas.
    • Os clientes existentes que desejam obter a implementação mais otimizada possível devem usar o novo SDK da Web.

Como faço para obter acesso para começar a usar o Adobe Experience Platform Web SDK?

O SDK da Web está disponível no momento para o público em geral e pode ser usado para enviar dados para produtos da Adobe Experience Cloud. A capacidade de enviar dados para soluções de terceiros será disponibilizada em breve. O SDK não é cobrado e é hospedado pelo Adobe gratuitamente. Se necessário, você pode baixá-lo e hospedá-lo em seus próprios servidores sem custo algum. O SDK da Web da Platform requer acesso às configurações de sequência de dados e ao construtor de esquema XDM da Adobe Experience Platform para que os servidores Adobe manipulem corretamente os dados de entrada provenientes do SDK. Se quiser obter acesso, entre em contato com a equipe de conta do Adobe para iniciar o processo de solicitação.

Quais casos de uso são aceitos atualmente pelo SDK da Web?

O SDK da Web está evoluindo rapidamente. Mais casos de uso estão sendo trabalhados. Você pode encontrar o lista de casos de uso atualmente permitidos aqui.

Os clientes atuais precisam remarcar seus sites?

Depende. O Adobe Experience Platform Web SDK pode ser implantado em dois estilos diferentes. Um futuro documento de migração fornecerá detalhes adicionais.

  • Apenas outra tag: Se o site já estiver marcado para soluções e você não puder remarcar, mas quiser enviar dados para a Rede de borda da Adobe Experience Platform para casos de uso de Experience Platform ou para os recursos de encaminhamento de eventos futuros (veja abaixo), você poderá adicionar o alloy.js para o site, onde funciona como "apenas outra tag".

  • A única tag: Se quiser usar o SDK da Web para uma solução Experience Cloud, você deverá usá-lo para all das soluções dessa página. Por exemplo, se seu site já estiver marcado para o Adobe Analytics e você quiser usá-lo para o Target, será necessário usá-lo para ambos, bem como para qualquer outro no futuro.

Em outras palavras, se você decidir usar o SDK da Web da Adobe Experience Platform para casos de uso que não sejam de solução, poderá marcar o site com alloy.js e siga em frente como se fosse uma nova solução. Se quiser usá-lo para Adobe Analytics, Target ou Audience Manager ou para casos de uso de aplicativos, talvez seja necessário remover qualquer um dos códigos herdados na página.

Posso migrar os ECIDs quando começar a usar o Alloy para que os visitantes do meu site não comecem a aparecer como novos visitantes?

Sim, o SDK da Web da Adobe Experience Platform fornece um recurso de migração de identidade. Siga as instruções para migração de ID no Documentação de identidade do SDK da Web da Platform para obter mais detalhes.

Qual é a diferença entre o SDK da Web e as tags?

  • Tags no Experience Platform gerencie o código do dispositivo. Use-os para implantar o código com mais facilidade. Eles são livres e poderosos.

  • Adobe Experience Platform Web SDK é o nome oficial do novo código que seria implantado por tags para casos de uso de Adobe. É também livre e poderosa.

  • alloy.js é o nome do arquivo do código do SDK da Web da Adobe Experience Platform.

Preciso usar tags para implantar o SDK da Web?

Não. Você pode baixar o alloy.js arquive você mesmo.

No entanto:

  • O SDK da Web do Adobe Experience Platform requer algo chamado ID de sequência de dados para que a rede de borda possa identificar o fluxo e determinar o que fazer com os dados. Essa ID é criada no Experience Platform. Isso não significa que você precisa usar a interface do para criar propriedades ou implantar o código JavaScript, mas sim usar tags para criar uma ID de configuração.

  • As tags não são apenas a melhor tag disponível e o gerenciador de SDK, facilitando a implantação alloy.js e mapear dados para esquemas XDM. Se decidir não usar tags, será necessário gerenciar a implantação alloy.js, eventos e mapeamento de dados no XDM antes de enviá-los. Este é um muito processo mais difícil do que usar tags.

  • É recomendável usar tags para implantar alloy.js, mesmo que seja a única tag para a qual você a usa.

O que é encaminhamento de eventos?

Se você usa nossos SDKs e envia XDM para a Rede de borda, esse novo encaminhamento de eventos de recursos permite instalar novas extensões do lado do servidor e mapear esses dados para qualquer coisa, e enviá-la para qualquer lugar, de nossa rede de borda. Pense nisso como "coleta de dados como um serviço". Ele estará disponível por um custo e será fornecido como parte do Adobe Experience Platform.

O que é um CNAME ou domínio próprio e por que ele é importante?

Mais informações sobre um CNAME estão disponíveis em Documentação do Adobe

O SDK da Web da Adobe Experience Platform usa cookies? Em caso afirmativo, quais cookies ele usa?

Sim, atualmente o SDK da Web usa entre um e sete cookies, dependendo da implementação. Abaixo está uma lista dos cookies que você pode ver com o SDK da Web e a maneira como eles são usados:

Nome maxAge Idade amigável Descrição
kndct_orgid_identity 34128000 395 dias O cookie de identidade armazena a ECID, bem como outras informações relacionadas à ECID.
kndctr_orgid_consent_check 7200 2 horas Este cookie armazena a preferência de consentimento do usuário para o site.
kndctr_orgid_consent 15552000 180 dias Este cookie baseado em sessão sinaliza ao servidor para procurar as preferências de consentimento no lado do servidor.
kndctr_orgid_cluster 1800 30 minutos Este cookie armazena a região da Rede de borda que está atendendo as solicitações do usuário atual. A região é usada no caminho do URL para que a Rede de borda possa rotear a solicitação para a região correta. Esse cookie tem uma duração de 30 minutos, para que, se um usuário se conectar com um endereço IP diferente, a solicitação possa ser roteada para a região mais próxima.
mbox 63072000 2 anos Este cookie é exibido quando a configuração de migração do Target é definida como verdadeira. Isso permitirá que o Target cookie da mbox a ser definido pelo SDK da Web.
mboxEdgeCluster 1800 30 minutos Este cookie é exibido quando a configuração de migração do Target é definida como verdadeira. Esse cookie permite que o SDK da Web comunique o cluster de borda correto com a at.js para que os perfis do Target possam permanecer em sincronia enquanto os usuários navegam em um site.
AMCV_###@AdobeOrg 34128000 395 dias Esse cookie só aparece quando a migração de ID no SDK da Web da Adobe Experience Platform está ativada. Este cookie ajuda na transição para o SDK da Web enquanto algumas partes do site ainda usam visitor.js. Consulte a Documentação idMigrationEnabled para ler mais sobre esta configuração.

Ao usar o SDK da Web, a Rede de borda define um ou mais dos cookies acima. A Rede de borda define todos os cookies com a variável secure e sameSite="none" atributos.

Se você tiver seções seguras e não seguras em seu site, isso pode interferir na identificação do usuário. Quando um usuário navega de uma seção segura do site para uma seção não segura, a Rede de borda gera uma nova ECID com a solicitação.

Quais navegadores são compatíveis com o SDK da Web da Adobe Experience Platform?

O SDK da Web da Adobe Experience Platform foi projetado para funcionar de maneira ideal nas versões mais recentes do Google Chrome, Safari, Firefox, Internet Explorer 11 e Microsoft Edge Chromium. Você pode ter problemas ao usar determinados recursos em versões mais antigas dos navegadores.

Onde posso obter mais informações sobre o Adobe Experience Platform Web SDK?

Nesta página