Show Menu
TÓPICOS×

Plug-in da Adobe: getVisitNum

Esse plug-in é fornecido pela Adobe Consulting como cortesia para ajudar você a tirar maior proveito do Adobe Analytics. O Atendimento ao cliente da Adobe não fornece suporte para este plug-in, o que inclui instalação ou solução de problemas. Se você precisar de ajuda com esse plug-in, entre em contato com o Gerente de conta de sua organização. Ele pode organizar uma reunião com um consultor para obter ajuda.
O plug-in getVisitNum retorna o número da visita para todos os visitantes que chegam ao site dentro do número desejado de dias. O Analysis Workspace oferece uma dimensão "Número de visitas" que fornece funcionalidade semelhante. A Adobe recomenda usar esse plug-in se você quiser mais controle sobre como o número de visitas é incrementado. Esse plug-in é desnecessário se a dimensão "Número de visitas" integrada no Analysis Workspace for suficiente para suas necessidades de relatórios.

Instale o plug-in usando a extensão Adobe Experience Platform Launch

A Adobe oferece uma extensão que permite usar os plug-ins usados com mais frequência.
  1. Faça logon em launch.adobe.com usando as credenciais da Adobe ID.
  2. Clique na propriedade desejada.
  3. Vá para a guia Extensões e clique no botão Catálogo
  4. Instale e publique a extensão Plug-ins comuns do Analytics
  5. Caso ainda não o tenha feito, crie uma regra denominada "Inicializar plug-ins" com a seguinte configuração:
    • Condição: Nenhuma
    • Evento: principal – biblioteca carregada (início da página)
  6. Adicione à regra acima uma ação com a seguinte configuração:
    • Extensão: Plug-ins comuns do Analytics
    • Tipo de ação: inicializar getVisitNum
  7. Salve e publique as alterações na regra.

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

Se você não quiser usar a extensão do plug-in, poderá usar o editor de código personalizado.
  1. Faça logon em launch.adobe.com usando as credenciais da Adobe ID.
  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 na janela de edição o código do plug-in fornecido abaixo.
  6. Salve e publique as alterações na extensão do Analytics.

Instalar 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: getVisitNum v4.11 (Requires endOfDatePeriod plug-in) */
s.getVisitNum=function(rp,erp){var s=this,c=function(rp){return isNaN(rp)?!1:(parseFloat(rp)|0)===parseFloat(rp)};rp=rp?rp:365;erp= "undefined"!==typeof erp?!!erp:c(rp)?!0:!1;var e=(new Date).getTime(),b=endOfDatePeriod(rp);if(s.c_r("s_vnc"+rp))var g=s.c_r("s_vnc"+rp).split("&vn="),d=g[1];if(s.c_r("s_ivc"))return d?(b.setTime(e+18E5),s.c_w("s_ivc",!0,b),d):"unknown visit number";if("undefined"!==typeof d)return d++,c=erp&&c(rp)?e+864E5*rp:g[0],b.setTime(c),s.c_w("s_vnc"+rp,c+"&vn="+d,b),b.setTime(e+ 18E5),s.c_w("s_ivc",!0,b),d;c=c(rp)?e+864E5*rp:endOfDatePeriod(rp).getTime();s.c_w("s_vnc"+rp,c+"&vn=1",b);b.setTime(e+18E5); s.c_w("s_ivc",!0,b);return"1"};

/* Adobe Consulting Plugin: endOfDatePeriod v1.1 */
var endOfDatePeriod=function(dp){var a=new Date,b=isNaN(dp)?0:Math.floor(dp);a.setHours(23);a.setMinutes(59);a.setSeconds(59); "w"===dp&&(b=6-a.getDay());if("m"===dp){b=a.getMonth()+1;var d=a.getFullYear();b=(new Date(d?d:1970,b?b:1,0)).getDate()-a.getDate()}a.setDate(a.getDate()+b);"y"===dp&&(a.setMonth(11),a.setDate(31));return a};
/******************************************** END CODE TO DEPLOY ********************************************/

Usar o plug-in

O método getVisitNum aceita os seguintes argumentos:
  • rp (opcional, número inteiro OU string): o número de dias antes da redefinição do contador do número de visitas. O valor padrão é 365 quando um valor não está definido.
    • Quando esse argumento é "w" , o contador é reiniciado no final da semana (neste sábado, às 23:59)
    • Quando esse argumento é "m" , o contador é redefinido no final do mês (o último dia deste mês)
    • Quando esse argumento é "y" , o contador é reiniciado no final do ano (31 de dezembro)
  • erp (opcional, booleano): Quando o argumento rp é um número, esse argumento determina se a expiração do número de visitas deve ser estendida. Se definido como true , as ocorrências subsequentes do site redefinirão o contador de número de visitas. Se definido como false , as ocorrências subsequentes do site serão estendidas quando o contador de número de visitas é redefinido. O padrão é true . Esse argumento não é válido quando o argumento rp é uma string.
O número de visitas aumenta sempre que o visitante retorna ao site após 30 minutos de inatividade. Chamar esse método retorna um número inteiro que representa o número de visita atual do visitante.
Este plug-in define um cookie próprio chamado "s_vnc[LENGTH]" , onde [LENGTH] é o valor transmitido para o argumento rp . Por exemplo, "s_vncw" , "s_vncm" ou "s_vnc365" . O valor do cookie é uma combinação de um carimbo de data e hora de Unix que representa o momento quando o contador de visitas é redefinido, como um fim da semana, fim do mês ou após 365 dias de inatividade. Também contém o número de visitas atual. Este plug-in define outro cookie chamado "s_ivc" , que está definido como true e expira após 30 minutos de inatividade.

Exemplos de chamadas

Exemplo #1

Para um visitante que não esteve no site nos últimos 365 dias, o código a seguir definirá s.prop1 como 1:
s.prop1=s.getVisitNum();

Exemplo #2

Para um visitante que retorna ao site dentro de 364 dias após sua primeira visita, o seguinte código definirá s.prop1 como 2:
s.prop1=s.getVisitNum(365);

Se esse visitante retornar ao site dentro de 364 dias após sua segunda visita, o código a seguir definirá s.prop1 como 3:
s.prop1=s.getVisitNum(365);

Exemplo #3

Para um visitante que retorna ao site dentro de 179 dias após sua primeira visita, o seguinte código definirá s.prop1 como 2:
s.prop1=s.getVisitNum(180,false);

No entanto, se esse visitante retornar ao site um ou mais dias após sua segunda visita, o código a seguir definirá s.prop1 como 1:
s.prop1=s.getVisitNum(180,false);

Quando o segundo argumento na chamada for igual a false, a rotina que determina quando o número de visitas deve ser "redefinido" para 1 fará isso durante um número "x" de dias - neste exemplo, 365 dias - após a primeira visita do visitante ao site.
Quando o segundo argumento for igual a true (ou não for definido), o plug-in redefinirá o número de visita para 1 somente após um número "x" de dias - novamente, neste exemplo, 365 dias - de inatividade do visitante.

Exemplo #4

Para todos os visitantes que chegam ao site pela primeira vez durante a semana atual - começando no domingo - o código a seguir definirá s.prop1 como 1:
s.prop1=s.getVisitNum("w");

Exemplo #5

Para todos os visitantes que chegam ao site pela primeira vez durante o mês atual - começando no primeiro dia de cada mês - o código a seguir definirá s.prop1 como 1:
s.prop1=s.getVisitNum("m");

Lembre-se que o plug-in getVisitNum não considera calendários de varejo (ou seja, 4-5-4, 4-4-5 etc.)

Exemplo #6

Para todos os visitantes que chegam ao site pela primeira vez durante o ano atual - começando em 1º de janeiro - o código a seguir definirá s.prop1 como 1:
s.prop1=s.getVisitNum("y");

Exemplo #7

Se você deseja rastrear o número de visitas de um visitante naquela semana, mês e ano - tudo dentro de diferentes variáveis do Analytics - você deve usar um código semelhante ao seguinte:
s.prop1=s.getVisitNum("w");
s.prop2=s.getVisitNum("m");
s.prop3=s.getVisitNum("y");

Nesse caso, o plug-in criará três cookies diferentes - um para cada um dos diferentes períodos - para rastrear o número de visitas individuais por período.

Histórico da versão

4.11 (30 de setembro de 2019)

  • Correção de um problema em que o argumento erp era explicitamente definido como false .

4.1 (21 de maio de 2018)

  • Atualização do plug-in endOfDatePeriod para v1.1.

4.0 (17 de abril de 2018)

  • Versão pontual (recompilada, menor tamanho de código).
  • Argumentos de cookie removidos, pois o plug-in agora gera cookies dinamicamente com base no argumento rp )

3.0 (5 de junho de 2016)

  • Reformulação completa
  • Combinadas todas as soluções anteriores disponíveis em várias versões do plug-in getVisitNum .