Show Menu
TÓPICOS×

Plug-in da Adobe: inList

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.
O inList plug-in permite verificar se um valor já existe em uma string delimitada ou em um objeto de matriz JavaScript. Vários outros plug-ins dependem do inList plug-in para funcionar. Esse plug-in oferece uma vantagem distinta sobre o método JavaScript indexOf() no qual você não corresponde a sequências parciais. Por exemplo, se você usou este plug-in para verificar se "event2" , ele não corresponderá a uma string que contém "event25" . Este plug-in não é necessário se você não precisa verificar valores em sequências delimitadas ou matrizes, ou se deseja usar sua própria indexOf() lógica.

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

A Adobe oferece uma extensão que permite usar plug-ins usados com mais frequência.
  1. Log in to launch.adobe.com using your AdobeID credentials.
  2. Clique na propriedade desejada.
  3. Vá para a Extensions guia e clique no Catalog botão
  4. Instalar e publicar a Common Analytics Plugins extensão
  5. Caso ainda não o tenha feito, crie uma regra denominada "Inicializar plug-ins" com a seguinte configuração:
    • Condição: Nenhum
    • Evento: Principal - Biblioteca carregada (início da página)
  6. Adicione uma ação à regra acima com a seguinte configuração:
    • Extensão: Plug-ins comuns do Analytics
    • Tipo de ação: Inicializar inList
  7. Salve e publique as alterações na regra.

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á para a Extensions guia e clique no Configure botão na extensão do Adobe Analytics.
  4. Amplie o Configure tracking using custom code acordeão, que revela o Open Editor botão.
  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: inList v2.1 */
s.inList=function(lv,vtc,d,cc){if("string"!==typeof vtc)return!1;if("string"===typeof lv)lv=lv.split(d||",");else if("object"!== typeof lv)return!1;d=0;for(var e=lv.length;d<e;d++)if(1==cc&&vtc===lv[d]||vtc.toLowerCase()===lv[d].toLowerCase())return!0;return!1};
/******************************************** END CODE TO DEPLOY ********************************************/

Usar o plug-in

O inList método usa os seguintes argumentos:
  • lv (obrigatório, sequência de caracteres ou matriz): Uma lista delimitada de valores ou um objeto de matriz JavaScript a ser pesquisado
  • vtc (obrigatório, string): O valor a ser pesquisado
  • d (opcional, string): O delimitador usado para separar valores individuais no lv argumento. O padrão é uma vírgula ( , ) quando não está definida.
  • cc (opcional, booleano): Se definido como true , é feita uma verificação que diferencia maiúsculas de minúsculas. Se definido como false ou omitido, então é feita uma verificação que não diferencia maiúsculas de minúsculas. O padrão é false .
Chamar esse método retornará true se encontrar uma correspondência e false se não encontrar uma correspondência.

Exemplos de chamadas

Exemplo n° 1

Se o status...
s.events="event22,event24";

...e o código a seguir é executado...
if(s.inList(s.events,"event22"))

...a declaração condicional if será verdadeira

Exemplo n° 2

Se o status...
s.events="event22,event24";

...e o código a seguir é executado...
if(s.inList(s.events,"event2"))

...a declaração condicional if será falsa porque a chamada inList não fez uma correspondência exata entre event2 e qualquer um dos valores delimitados em s.events

Exemplo 3

Se o status...
s.events="event22,event24";

...e o código a seguir é executado...
if(!s.inList(s.events,"event23"))

...a declaração condicional if será verdadeira porque a chamada inList não fez uma correspondência exata entre event23 e qualquer um dos valores delimitados em s.events (observe o operador "NOT" no início da chamada de variável inList).

Exemplo n° 4

Se o status...
s.events = "event22,event23";

...e o código a seguir é executado...
if(s.inList(s.events,"EVenT23","",1))

...a declaração condicional if será falsa. Embora esse exemplo não seja prático, demonstra a necessidade de usar cautela ao usar o sinalizador que diferencia maiúsculas de minúsculas.

Exemplo n° 5

Se o status...
s.linkTrackVars = "events,eVar1";

...e o código a seguir é executado...
if(s.inList(s.linkTrackVars,"eVar1","|"))

...a declaração condicional if será falsa. O valor do argumento d passado para a chamada (ou seja, "|") presume que os valores individuais em s.linkTrackVars são delimitados por um caractere de barra vertical, enquanto na realidade, os valores são delimitados por uma vírgula. Nesse caso, o plug-in tentará fazer uma correspondência entre o valor inteiro de s.linkTrackVars (ou seja, "events,eVar1") e o valor a ser procurado (ou seja, "eVar1").

Histórico da versão

v2.1 (26 de setembro de 2019)

  • Adicionada a opção para que o cc argumento não seja booleano. Por exemplo, 1 é um valor de verificação de letras maiúsculas e minúsculas válido.

v2.0 (17 de abril de 2018)

  • Lançamento de ponto (recompilado, tamanho de código menor).

v1.01 (27 de setembro de 2017)

  • Código otimizado para reduzir o tamanho

v1.0 (2009)

  • Versão inicial.