Show Menu
TÓPICOS×

Plug-in da Adobe: getPercentPageViewed

Este plug-in é fornecido pela Adobe Consulting como cortesia para ajudá-lo a obter mais valor do Adobe Analytics. O Atendimento ao cliente da Adobe não fornece suporte para este plug-in, incluindo instalação ou solução de problemas. Se precisar de ajuda com esse plug-in, entre em contato com o Gerente de conta de sua organização. Eles podem organizar uma reunião com um consultor para obter assistência.
The getPercentPageViewed plug-in measures a visitor's scroll activity to see how much of a page they view before moving on to another page. Esse plug-in não é necessário se as páginas tiverem uma altura pequena ou não quiserem medir a atividade de rolagem.

Instale o plug-in usando o editor de código personalizado Iniciar

Se você não quiser usar a extensão do plug-in, poderá usar o editor de código personalizado.
  1. Log in to launch.adobe.com using your AdobeID credentials.
  2. Clique na propriedade desejada.
  3. Vá até a guia Extensões e clique no botão Configurar na extensão do Adobe Analytics.
  4. Expanda a opção Configurar rastreamento usando código personalizado, que revela o botão Abrir editor .
  5. Abra o editor de código personalizado e cole o código do plug-in fornecido abaixo na janela de edição.
  6. Salve e publique as alterações na extensão do Analytics.

Instale o plug-in usando o AppMeasurement

Copie e cole o seguinte código em qualquer lugar no arquivo AppMeasurement depois que o objeto de rastreamento do Analytics for instanciado (usando s_gi ). A preservação de comentários e números de versão do código na sua implementação ajuda a Adobe a solucionar possíveis problemas.
/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: getPercentPageViewed v4.0 w/handlePPVevents helper function (Requires p_fo plug-in) */
s.getPercentPageViewed=function(pid,ch){var s=this,a=s.c_r("s_ppv");a=-1<a.indexOf(",")?a.split(","):[];a[0]=s.unescape(a[0]); pid=pid?pid:s.pageName?s.pageName:document.location.href;s.ppvChange="undefined"===typeof ch||!0==ch?!0:!1;if("undefined"=== typeof s.linkType||"o"!==s.linkType)s.ppvID&&s.ppvID===pid||(s.ppvID=pid,s.c_w("s_ppv",""),s.handlePPVevents()), s.p_fo("s_gppvLoad") &&window.addEventListener&&(window.addEventListener("load",s.handlePPVevents,!1),window.addEventListener("click",s.handlePPVevents, !1),window.addEventListener("scroll",s.handlePPVevents,!1)),s._ppvPreviousPage=a[0]?a[0]:"",s._ppvHighestPercentViewed=a[1]?a[1]:"",s._ppvInitialPercentViewed=a[2]?a[2]:"",s._ppvHighestPixelsSeen=a[3]?a[3]:"",s._ppvFoldsSeen=a[4]?a[4]:"",s._ppvFoldsAvailable=a[5]?a[5]:""};

/* Adobe Consulting Plugin: handlePPVevents helper function (for getPercentPageViewed v4.0 Plugin) */
s.handlePPVevents=function(){if("undefined"!==typeof s_c_il){for(var c=0,g=s_c_il.length;c<g;c++)if(s_c_il[c]&& (s_c_il[c].getPercentPageViewed||s_c_il[c].getPreviousPageActivity)){var s=s_c_il[c];break}if(s&&s.ppvID){var f=Math.max (Math.max(document.body.scrollHeight,document.documentElement.scrollHeight),Math.max(document.body.offsetHeight, document.documentElement.offsetHeight),Math.max(document.body.clientHeight,document.documentElement.clientHeight)),h= window.innerHeight||document.documentElement.clientHeight||document.body.clientHeight;c=(window.pageYOffset|| window.document.documentElement.scrollTop||window.document.body.scrollTop)+h;g=Math.min(Math.round(c/f*100),100);var k=Math.floor(c/h);h=Math.floor(f/h);var d="";if(!s.c_r("s_tp")||s.unescape(s.c_r("s_ppv").split(",")[0])!==s.ppvID||s.p_fo(s.ppvID) ||1==s.ppvChange&&s.c_r("s_tp")&&f!=s.c_r("s_tp")){(s.unescape(s.c_r("s_ppv").split(",")[0])!==s.ppvID||s.p_fo(s.ppvID+"1"))&&s.c_w("s_ips",c);if(s.c_r("s_tp")&&s.unescape(s.c_r("s_ppv").split(",")[0])===s.ppvID){s.c_r("s_tp");d=s.c_r("s_ppv");var e=-1< d.indexOf(",")?d.split(","):[];d=e[0]?e[0]:"";e=e[3]?e[3]:"";var l=s.c_r("s_ips");d=d+","+Math.round(e/f*100)+","+Math.round(l/ f*100)+","+e+","+k}s.c_w("s_tp",f)}else d=s.c_r("s_ppv");var b=d&&-1<d.indexOf(",")?d.split(",",6):[];f=0<b.length?b[0]: escape(s.ppvID);e=1<b.length?parseInt(b[1]):g;l=2<b.length?parseInt(b[2]):g;var m=3<b.length?parseInt(b[3]):c,n=4<b.length? parseInt(b[4]):k;b=5<b.length?parseInt(b[5]):h;0<g&&(d=f+","+(g>e?g:e)+","+l+","+(c>m?c:m)+","+(k>n?k:n)+","+(h>b?h:b)); s.c_w("s_ppv",d)}}};

/* Adobe Consulting Plugin: p_fo (pageFirstOnly) v2.0 */
s.p_fo=function(on){var s=this;s.__fo||(s.__fo={});if(s.__fo[on])return!1;s.__fo[on]={};return!0};
/******************************************** END CODE TO DEPLOY ********************************************/

Usar o plug-in

O getPercentPageViewed método usa os seguintes argumentos:
  • pid (opcional, string): Um identificador baseado em página que você pode correlacionar com as porcentagens fornecidas pelas medidas do plug-in. O padrão é a pageName variável.
  • ch (opcional, booleano): Defina como false (ou 0 ) se você não quiser que o plug-in considere quaisquer alterações feitas no tamanho de uma página após o carregamento inicial. Se omitido, esse argumento assumirá true como padrão. A Adobe recomenda omitir esse argumento na maioria dos casos.
Chamar esse método não retorna nada; em vez disso, ele define as seguintes variáveis:
  • s._ppvPreviousPage : O nome da página anterior exibida. As medidas de rolagem finais da página atual não estarão disponíveis até que uma nova página seja carregada.
  • s._ppvHighestPercentViewed : a porcentagem mais alta da página anterior que o visitante visualizou (em termos de altura). O ponto mais distante para o qual o visitante rolou para baixo na página anterior.
  • s._ppvInitialPercentViewed : a porcentagem da página anterior que estava visível quando a página anterior foi carregada pela primeira vez.
  • s._ppvHighestPixelsSeen : o maior número dos pixels totais vistos (em relação à altura) quando o visitante rolou pela página anterior.
  • s._ppvFoldsSeen : O maior número de "dobras de página" foi atingido quando o visitante rolou para baixo na página anterior. Essa variável inclui a dobra "top-of-page".
  • s._ppvFoldsAvailable : O número total de "dobras de página" disponíveis para rolar para baixo na página anterior.
Atribua uma ou mais dessas variáveis a eVars para ver dados de dimensão em relatórios.
Este plug-in cria um cookie próprio chamado s_ppv que contém os valores acima. Ela expira no final da sessão do navegador.

Exemplos de chamadas

Exemplo #1

O seguinte código...
if(s.pageName) s.getPercentPageViewed();
if(s._ppvPreviousPage)
{
  s.prop1 = s._ppvPreviousPage;
  s.prop2 = "highestPercentViewed=" + s._ppvHighestPercentViewed + " | initialPercentViewed=" + s._ppvInitialPercentViewed + " + | foldsSeen=" + s._ppvFoldsSeen + " | foldsAvailable=" + s._ppvFoldsAvailable;
}

  • Determina se s.pageName foi definido e, nesse caso, o código executará a função getPercentPageViewed
  • Quando a função getPercentPageViewed for executada, ela criará as variáveis descritas na seção "Retornos" acima
  • Se as variáveis "Retorna" tiverem sido definidas com êxito:
    • O código definirá s.prop1 igual ao valor de s._ppvPreviousPage (ou seja, o valor anterior de s.pageName ou a página anterior)
    • O código também definirá s.prop2 igual à porcentagem mais alta visualizada da página anterior e a porcentagem inicial visualizada da página anterior, juntamente com o número de dobradiças que o visitante alcançou e o número de dobradiças que estavam disponíveis
Observação : Se uma página inteira estiver visível quando for carregada pela primeira vez, tanto a porcentagem mais alta visualizada quanto as dimensões da porcentagem inicial visualizada serão iguais a 100, e ambas as dimensões Folds Seen e Folds Available serão iguais a 1. Quando uma página inteira NÃO estiver visível quando for carregada pela primeira vez, mas o visitante nunca terminar rolando para baixo antes de ir para a próxima página, então tanto a porcentagem mais alta visualizada quanto a porcentagem inicial visualizada serão iguais ao mesmo valor.

Exemplo #2

Suponha que s.prop5 tenha sido reservado para capturar um "tipo de página" acumulado, em vez do nome da página inteira.
O código a seguir determina se s.prop5 foi definido e, em caso afirmativo, armazenará seu valor como a "página anterior" para correlacionar com a porcentagem mais alta visualizada e a porcentagem inicial visualizada. O valor ainda será armazenado na variável s._ppvPreviousPage, mas pode ser tratado como se fosse o tipo de página anterior em vez do nome de página anterior.
if(s.prop5) s.getPercentPageViewed(s.prop5);
if(s._ppvPreviousPage)
{
  s.prop1 = s._ppvPreviousPage;
  s.prop2 = "highestPercentViewed = " + s._ppvHighestPercentViewed + " | initialPercentViewed=" + s._ppvInitialPercentViewed;
}

Histórico da versão

v4.0 (7 de outubro de 2019)

  • Adicionadas s._ppvFoldsSeen e s._ppvFoldsAvailable soluções

v3.01 (13 de agosto de 2018)

  • Corrigido um problema para páginas que têm vários objetos AppMeasurement em uma página

v3.0 (13 de abril de 2018)

  • Lançamento de ponto (recompilado, tamanho de código menor)
  • O plug-in agora cria variáveis a serem atribuídas às variáveis do Adobe Analytics em vez de valores de retorno