Perguntas frequentes

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

O que é o SDK da Web da Adobe Experience Platform?

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

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

Mais
informaçõesApresentação do Adobe Summit

Como o SDK da Web da Adobe Experience Platform difere das soluções anteriores?

Antes do SDK do Adobe Experience Platform

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 trabalhar entre si.
  • Casos de uso entre soluções e Adobe Experience Platform exigem que essas bibliotecas diferentes sejam interdependentes, causando atrito de implantação.

Embora as tags na Platform facilitem ao máximo 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 da ECID antes das chamadas de personalização (causa atraso)
  • Coleta de dados fragmentada (o que é uma evar?)
  • Confusão de esquema entre soluções (A4T)
  • Muitas outras coisas menos ótimas

Além disso, atualmente não há biblioteca de 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.

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

Outras soluções serão seguidas ainda este 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 schema de soluções 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, Experience Edge, 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 schema independente da solução usado para enviar dados ao Adobe. Não há mais marcação para evars ou mboxes.
  • Adobe Experience Platform Web SDK: facilita o envio e o recebimento de dados para a Adobe Experience Platform Edge Network.
  • Tags: simplifica a implantação e a configuração do SDK da Web (e de quaisquer outras tags do JavaScript) em um site.
  • Experience Edge: roteie 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 fluxo único e conectado de dados, você pode, logicamente, seguir e controlar a aparência dos dados em 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 da Experience Cloud permitiram que o Adobe modernizasse significativamente como o Adobe lida com a coleta de dados, a personalização, o consentimento e o futuro de cookies de terceiros. (Ela ativa um domínio próprio, gerenciado pelo Adobe.)

Tempo até o valor: o Adobe trabalhou bastante (e continuará) para facilitar ao máximo a implantação do SDK da Web por meio de tags e do mapeamento de dados do lado do cliente para o XDM. Depois que esse trabalho for feito, todas as outras soluções Adobe e serviços Adobe Experience Platform poderão ser ativados ou desativados no lado do servidor. Por exemplo, se estiver usando essa opção para o Adobe Analytics e quiser ativar o Target ou o Experience Platform, você pode simplesmente virar um botão na configuração do Datastream e acender esses casos de uso.

O que é o Alloy?

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

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

Não. Qualquer cliente do Adobe Digital Experience pode usá-lo. Totalmente livre. Qualquer cliente que deseje usar o SDK da Web terá acesso para criar esquemas e conjuntos de dados na interface do usuário do Adobe Experience Platform.

Quem deve usar o SDK da Web?

O SDK da Web da Adobe Experience Platform 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.

    O Adobe está ciente de que usar o conector do Adobe Analytics é mais rápido se o cliente já tiver o Adobe Analytics, mas não é a estratégia de longo prazo para a coleta de dados.

  • Clientes de solução 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 obtenho acesso para começar a usar o SDK da Web da Adobe Experience Platform?

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 está chegando em breve. O SDK é gratuito, é hospedado gratuitamente pelo Adobe e pode ser baixado para que você possa hospedá-lo em seus próprios servidores, se desejar, gratuitamente. O SDK da Web da plataforma requer configurações de conjunto de dados e o construtor de esquema Adobe Experience Platform XDM, para que os servidores Adobe lidem corretamente com os dados de entrada provenientes do SDK. Se você quiser obter acesso, entre em contato com o Gerente de sucesso do cliente (CSM) para iniciar o processo de solicitação.

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

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

Os clientes atuais precisam remarcar seus sites?

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

  • Apenas outra tag: se o site já tiver tags de soluções e você não puder remarcar, mas desejar enviar dados para a Adobe Experience Platform Edge Network para casos de uso do Experience Platform ou para os recursos futuros de encaminhamento de eventos (veja abaixo), é possível adicionar a alloy.js tag ao site, onde funciona como "apenas outra tag".

  • A única tag: se quiser usar o SDK da Web para uma solução do Experience Cloud, use-o para todas __ as soluções da página. Por exemplo, se o 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 decidir usar o SDK da Web da Adobe Experience Platform para casos de uso não solucionados, você poderá adicionar tags ao site com alloy.js e continuar como se fosse uma nova solução. Se quiser usá-lo para o Adobe Analytics, Target ou Audience Manager, ou para casos de uso de aplicativos, talvez seja necessário remover qualquer código herdado na página.

Posso migrar as 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 na Documentação de identidade do SDK da Web da plataforma para obter mais detalhes.

Como o SDK da Web é diferente das tags?

  • Tags na Experience Platform gerenciam o código do dispositivo. Use-os para implantar o código com mais facilidade. Elas são livres e poderosas.

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

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

Preciso usar tags para implantar o SDK da Web?

Não. Você pode baixar o arquivo alloy.js sozinho.

No entanto:

  • O SDK da Web da Adobe Experience Platform requer algo chamado de ID do conjunto 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 usuário da coleta de dados para criar propriedades ou implantar o código do JavaScript, mas sim usar tags para criar uma ID de configuração.

  • As tags não são apenas o melhor gerenciador de tags e SDK disponível, mas também facilitam a implantação do alloy.js e o mapeamento de dados para esquemas XDM. Se decidir não usar tags, será necessário gerenciar a implantação de alloy.js, o desenvolvimento de eventos e o mapeamento de seus dados para o XDM antes de enviá-los. Esse é um processo muito 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ê o usa.

O que é o encaminhamento de eventos?

Se você usar nossos SDKs e enviar o XDM para o Experience Edge, esses novos recursos de encaminhamento de eventos permitirão instalar novas extensões do lado do servidor e mapear esses dados para qualquer coisa — e enviá-los para qualquer lugar — de nossa rede de borda. Pense nisso como "coleta de dados como um serviço". Isso estará disponível por um custo, além de ser incluído 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 na documentação do Adobe

O SDK da Web da Adobe Experience Platform usa cookies? Em caso afirmativo, que cookies utiliza?

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

kndct_orgid_identity: O cookie de identidade é usado para armazenar a ECID, bem como algumas outras informações relacionadas à ECID.

kdctr_orgid_consent: este cookie armazena a preferência de consentimento do usuário para o site.

kdctr_orgid_personalization: esse cookie inclui informações de sessão que o Adobe Target usa para personalizar páginas da Web.

kdctr_orgid_consent: este cookie baseado em sessão sinaliza o servidor para procurar o lado do servidor das preferências de consentimento.

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 de navegadores.

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

Nesta página