Plug-in di Adobe: inList

IMPORTANTE

Questo plug-in è fornito da Adobe Consulting come cortesia per aiutarti a ottenere più valore da Adobe Analytics. L’Assistenza clienti di Adobe non fornisce supporto per questo plug-in, inclusa l’installazione o la risoluzione dei problemi. Se hai bisogno di aiuto con questo plug-in, contatta l’Account Manager della tua organizzazione. Possono organizzare una riunione con un consulente per l'assistenza.

Il plug-in inList consente di verificare se un valore esiste già all’interno di una stringa delimitata o di un oggetto array JavaScript. Diversi altri plug-in dipendono dal funzionamento del plug-in inList . Questo plug-in fornisce un vantaggio distinto rispetto al metodo JavaScript indexOf() in cui non corrisponde a stringhe parziali. Ad esempio, se hai utilizzato questo plug-in per verificare la presenza di "event2", non corrisponderà a una stringa contenente "event25". Questo plug-in non è necessario se non è necessario verificare la presenza di valori in stringhe o array delimitati o se si desidera utilizzare la propria logica indexOf().

Installare il plug-in utilizzando l’estensione Adobe Experience Platform Launch

Adobe offre un’estensione che consente di utilizzare i plug-in più comunemente utilizzati.

  1. Accedi a launch.adobe.com utilizzando le tue credenziali AdobeID.
  2. Fai clic sulla proprietà desiderata.
  3. Vai alla scheda Extensions, quindi fai clic sul pulsante Catalog
  4. Installa e pubblica l'estensione Common Analytics Plugins
  5. Se non lo hai già fatto, crea una regola denominata "Inizializza plug-in" con la seguente configurazione:
    • Condizione: nessuna
    • Evento: Core - Libreria caricata (pagina in alto)
  6. Aggiungi un'azione alla regola precedente con la seguente configurazione:
    • Estensione: Plug-in comuni di Analytics
    • Tipo azione: Inizializza inList
  7. Salva e pubblica le modifiche alla regola.

Installare il plug-in utilizzando l’editor di codice personalizzato di Launch

Se non desideri utilizzare l'estensione plug-in, puoi utilizzare l'editor di codice personalizzato.

  1. Accedi a launch.adobe.com utilizzando le tue credenziali AdobeID.
  2. Fai clic sulla proprietà desiderata.
  3. Vai alla scheda Extensions , quindi fai clic sul pulsante Configure sotto l'estensione Adobe Analytics.
  4. Espandi il Configure tracking using custom code pannello a soffietto, che mostra il pulsante Open Editor .
  5. Apri l’editor di codice personalizzato e incolla il codice plug-in fornito di seguito nella finestra di modifica.
  6. Salva e pubblica le modifiche all’estensione Analytics.

Installare il plug-in utilizzando AppMeasurement

Copia e incolla il seguente codice in qualsiasi punto del file AppMeasurement dopo la creazione dell'istanza dell'oggetto di tracciamento Analytics (utilizzando s_gi). La conservazione dei commenti e dei numeri di versione del codice nell’implementazione consente ad Adobe di risolvere eventuali problemi.

/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: inList v3.0 */
function inList(lv,vtc,d,cc){var b=lv,e=vtc,c=d,f=cc;if("-v"===b)return{plugin:"inList",version:"3.0"};a:{if("undefined"!==typeof window.s_c_il){var a=0;for(var d;a<window.s_c_il.length;a++)if(d=window.s_c_il[a],d._c&&"s_c"===d._c){a=d;break a}}a=void 0}"undefined"!==typeof a&&(a.contextData.inList="3.0");if("string"!==typeof e)return!1;if("string"===typeof b)b=b.split(c||",");else if("object"!==typeof b)return!1;c=0;for(a=b.length;c<a;c++)if(1==f&&e===b[c]||e.toLowerCase()===b[c].toLowerCase())return!0;return!1};
/******************************************** END CODE TO DEPLOY ********************************************/

Usa il plug-in

Il metodo inList utilizza i seguenti argomenti:

  • lv (obbligatorio, stringa o matrice): Un elenco delimitato di valori o un oggetto array JavaScript da cercare
  • vtc (obbligatorio, stringa): Valore da cercare
  • d (facoltativo, stringa): Il delimitatore utilizzato per separare i singoli valori nell’ lv argomento. Se non è impostato, viene impostata automaticamente una virgola (,).
  • cc (facoltativo, booleano): Se è impostato su true, viene effettuato un controllo con distinzione tra maiuscole e minuscole. Se è impostato su false o omesso, viene effettuato un controllo senza distinzione tra maiuscole e minuscole. Predefinito su false.

Se si richiama questo metodo, viene restituito true se viene trovata una corrispondenza e false se non viene trovata una corrispondenza.

Chiamate di esempio

Esempio n. 1

Se viene mostrato…

s.events="event22,event24";

…e viene eseguito il seguente codice…

if(s.inList(s.events,"event22"))

…l’istruzione if condizionale sarà true

Esempio n. 2

Se viene mostrato…

s.events="event22,event24";

…e viene eseguito il seguente codice…

if(s.inList(s.events,"event2"))

…l’istruzione if condizionale sarà false perché la chiamata inList non ha effettuato una corrispondenza esatta tra event2 e uno dei valori delimitati in s.events

Esempio n. 3

Se viene mostrato…

s.events="event22,event24";

…e viene eseguito il seguente codice…

if(!s.inList(s.events,"event23"))

…l'istruzione if condizionale sarà true perché la chiamata inList non ha effettuato una corrispondenza esatta tra event23 e uno dei valori delimitati in s.events (nota l'operatore "NOT" all'inizio della chiamata alla variabile inList ).

Esempio n. 4

Se viene mostrato…

s.events = "event22,event23";

…e viene eseguito il seguente codice…

if(s.inList(s.events,"EVenT23","",1))

…l’istruzione if condizionale sarà false. Anche se questo esempio non è pratico, dimostra la necessità di usare cautela quando si utilizza il flag che distingue tra maiuscole e minuscole.

Esempio n. 5

Se viene mostrato…

s.linkTrackVars = "events,eVar1";

…e viene eseguito il seguente codice…

if(s.inList(s.linkTrackVars,"eVar1","|"))

…l’istruzione if condizionale sarà false. Il valore dell'argomento d trasmesso nella chiamata (ovvero "|") presuppone che i singoli valori in s.linkTrackVars siano delimitati da un carattere di barra verticale, mentre in realtà i valori sono delimitati da una virgola. In questo caso, il plug-in cercherà di stabilire una corrispondenza tra l’intero valore di s.linkTrackVars (cioè "events,eVar1") e il valore da cercare (ad es. "eVar1").

Cronologia versioni

3.0 (19 marzo 2021)

  • È stato aggiunto il numero di versione come dati contestuali.

v2.1 (26 settembre 2019)

  • È stata aggiunta l’opzione per l’argomento cc che non è booleano. Ad esempio, 1 è un valore di controllo maiuscole/minuscole valido.

v2.0 (17 aprile 2018)

  • Rilascio del punto (ricompilato, dimensioni del codice più piccole).

v1.01 (27 settembre 2017)

  • Codice ottimizzato per ridurre le dimensioni

v1.0 (2009)

  • Versione iniziale.

In questa pagina