bufferRequests

Última atualização em 2023-09-18
  • Tópicos
  • Variables
    Exibir mais informações sobre este tópico
  • Criado para:
  • User
    Admin

A variável bufferRequests() O método permite armazenar solicitações de imagem em cache na página atual, em vez de enviá-las para o Adobe. O acionamento desse método é útil em cenários nos quais um navegador não é compatível navigator.sendBeacon() ou cancela solicitações de imagem quando uma página é descarregada. Muitas versões dos navegadores WebKit, como o Safari, geralmente exibem o comportamento de interromper uma solicitação de imagem ao clicar em um link. A variável bufferRequests() O método está disponível em todas as versões do AppMeasurement v2.25.0 ou posterior.

Quando você chama t() ou tl() em uma página subsequente na mesma sessão do navegador e bufferRequests() ainda não foi chamado nessa página, todas as solicitações em buffer são enviadas além da solicitação de imagem dessa página. As solicitações em buffer são enviadas na ordem correta, sendo que a solicitação de imagem da página atual é enviada por último.

DICA

O carimbo de data e hora das solicitações em buffer é compartilhado com a página para a qual os dados são enviados. Se quiser obter mais precisão no segundo exato em que uma solicitação armazenada em buffer for registrada, você poderá definir o timestamp antes de armazenar a solicitação em buffer. Se você usar essa variável, verifique se Carimbos opcionais de data e hora está ativado - se não estiver, todas as ocorrências com carimbo de data e hora serão perdidas permanentemente!

Limitações

Ao chamar o bufferRequests() , lembre-se das limitações a seguir. Como esse método usa Window.sessionStorage, muitas das mesmas limitações se aplicam:

  • O link de destino deve residir no mesmo domínio e subdomínio. As solicitações em buffer não funcionam entre domínios ou subdomínios, mesmo se ambos tiverem a mesma implementação do Adobe Analytics. Essa limitação também significa que não é possível usar solicitações em buffer para rastrear links de saída.
  • O link de destino deve usar o mesmo protocolo da página atual. Não é possível enviar solicitações em buffer entre HTTP e HTTPS.
  • As solicitações em buffer são armazenadas até que você chame t() ou tl() sem chamar bufferRequests() primeiro ou até que o navegador ou a guia seja fechada. Se uma sessão do navegador terminar antes que você possa enviar esses dados para o Adobe, as solicitações em buffer não enviadas serão perdidas permanentemente.
  • Se um navegador não suportar a variável API de armazenamento na Web ou o API JSON, um aviso será enviado ao console do navegador e o AppMeasurement tentará enviar imediatamente a solicitação de imagem usando o t() método.

Solicitações em buffer no SDK da Web

No momento, o SDK da Web não oferece a capacidade de armazenar solicitações em buffer.

Solicitações em buffer usando a extensão do Adobe Analytics

Não há um campo dedicado na extensão do Adobe Analytics para o uso dessa variável. Use o editor de código personalizado após a sintaxe do AppMeasurement.

s.bufferRequests() no AppMeasurement e no editor de código personalizado da extensão do Analytics

Chame o bufferRequests() método antes de chamar t() ou tl(). Quando bufferRequests() for chamada, as chamadas de rastreamento subsequentes serão gravadas no armazenamento da sessão em vez de enviadas aos servidores de coleta de dados do Adobe.

// Instantiate the tracking object
var s = s_gi("examplersid");

// Flag the request to be buffered
s.bufferRequests();

// The t() or tl() method then writes the data to session storage instead of sending it to Adobe
s.tl(true,"o","Example link click");

// On a subsequent page, the tracking call sends both the above link tracking call and the page view call
s.t();

Nesta página