Plug-in di Adobe: rfl (Rimuovi dall'elenco)

IMPORTANT
Questo plug-in è fornito a titolo di cortesia da Adobe Consulting per aiutarti a ottenere più valore da Adobe Analytics. L’Assistenza clienti di Adobe non fornisce supporto per questo plug-in, per la sua installazione né per la risoluzione di problemi. Se hai bisogno di aiuto con questo plug-in, contatta il team dell’account Adobe della tua organizzazione. Il team può organizzare una riunione con un consulente per l’assistenza.

Il rfl Il plug-in consente di rimuovere "in modo sicuro" i valori dalle stringhe delimitate, ad esempio events, products, list, e altri. Questo plug-in è utile se si desidera rimuovere valori specifici da una stringa delimitata senza preoccuparsi dei delimitatori. Diversi altri plug-in dipendono da questo codice per funzionare correttamente. Questo plug-in non è necessario se non è necessario eseguire una funzione specifica su più variabili Analytics alla volta o se non si utilizzano plug-in dipendenti.

Il plug-in utilizza la logica seguente:

  • Se il valore da rimuovere esiste, il plug-in mantiene tutto nella variabile, tranne il valore da rimuovere.
  • Se il valore da rimuovere non esiste, il plug-in mantiene invariata la stringa originale.

Installare il plug-in utilizzando l’estensione Web SDK o Web SDK

Questo plug-in non è ancora supportato per l’utilizzo nell’SDK per web.

Installare il plug-in utilizzando l’estensione Adobe Analytics

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

  1. Accedi a Raccolta dati di Adobe Experience Platform utilizzando le credenziali Adobe ID.

  2. Fai clic sulla proprietà del tag desiderata.

  3. Vai a Extensions , quindi fare clic sul pulsante Catalog pulsante

  4. Installare e pubblicare Common Analytics Plugins estensione

  5. Se non lo hai già fatto, crea una regola denominata "Initialize Plug-ins" (Inizializza plug-in) con la seguente configurazione:

    • Condizione: nessuna
    • Evento: Core - Library Loaded (Page Top)
  6. Aggiungi un’azione alla regola precedente con la seguente configurazione:

    • Estensione: Common Analytics Plugins
    • Tipo azione: Inizializza RFP (Rimuovi dall'elenco)
  7. Salva e pubblica le modifiche apportate alla regola.

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

Se non desideri utilizzare l’estensione del plug-in Common Analytics Plugins, puoi utilizzare l’editor di codice personalizzato.

  1. Accedi a Raccolta dati di Adobe Experience Platform utilizzando le credenziali Adobe ID.
  2. Fai clic sulla proprietà desiderata.
  3. Vai a Extensions , quindi fare clic sulla scheda Configure sotto l'estensione Adobe Analytics.
  4. Espandi Configure tracking using custom code Pannello a soffietto, che mostra Open Editor pulsante.
  5. Apri l’editor di codice personalizzato e incolla il codice del plug-in fornito di seguito nella finestra di modifica.
  6. Salva e pubblica le modifiche nell’estensione Analytics.

Installare il plug-in utilizzando AppMeasurement

Copia e incolla il seguente codice in qualsiasi punto del file di AppMeasurement dopo la creazione dell'istanza dell'oggetto di tracciamento di Analytics (utilizzando s_gi). Mantenere i commenti e i numeri di versione del codice nella tua implementazione aiuta ad Adobe nella risoluzione di eventuali problemi.

/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: rfl (removeFromList) v2.1  */
function rfl(lv,vr,d1,d2,df){var b=lv,f=vr,e=d1,h=d2,g=df;if("-v"===b)return{plugin:"rfl",version:"2.1"};a:{if("undefined"!==typeof window.s_c_il){var c=0;for(var a;c<window.s_c_il.length;c++)if(a=window.s_c_il[c],a._c&&"s_c"===a._c){c=a;break a}}c=void 0}"undefined"!==typeof c&&(c.contextData.rfl="2.1");if(!b||!f)return"";c=[];a="";e=e||",";h=h||e;g=g||!1;b=b.split(e);e=b.length;for(var d=0;d<e;d++)-1<b[d].indexOf(":")&&(a=b[d].split(":"),a[1]=a[0]+":"+a[1],b[d]=a[0]),-1<b[d].indexOf("=")&&(a=b[d].split("="),a[1]=a[0]+"="+a[1],b[d]=a[0]),b[d]!==f&&a?c.push(a[1]):b[d]!==f?c.push(b[d]):b[d]===f&&g&&(a?c.push(a[1]):c.push(b[d]),g=!1),a="";return c.join(h)};
/******************************************** END CODE TO DEPLOY ********************************************/

Utilizzare il plug-in

Il rfl La funzione utilizza i seguenti argomenti:

  • lv (obbligatorio, stringa): variabile (o stringa) contenente un elenco di valori delimitati
  • vr (obbligatorio, stringa): valore che si desidera rimuovere dal lv argomento. L'Adobe consiglia di non rimuovere più valori durante una singola rfl chiamare.
  • d1 (facoltativo, stringa): delimitatore utilizzato dalla proprietà lv utilizza. Impostazione predefinita: virgola (,).
  • d2 (facoltativo, stringa): delimitatore che si desidera utilizzare per la stringa restituita. Valore predefinito dello d1 argomento.
  • df (facoltativo, booleano): If true, forza solo le istanze duplicate del vr argomento da lv invece di tutte le istanze. Impostazione predefinita false quando non è impostato.

La chiamata di questa funzione restituisce una stringa modificata contenente lv ma senza alcuna istanza (o istanze duplicate) del valore specificato in vr argomento.

Esempio di chiamate

Esempio di #1

Se…

s.events = "event22,event24,event25";

…e viene eseguito il seguente codice…

s.events = rfl(s.events,"event24");

…il valore finale di s.events sarà:

s.events = "event22,event25";

Esempio di #2

Se…

s.events = "event22,event24,event25";

…e viene eseguito il seguente codice…

s.events = rfl(s.events,"event26");

…il valore finale di s.events sarà:

s.events = "event22,event24,event25";

In questo esempio, la chiamata rfl non ha apportato modifiche a s.events poiché s.events non conteneva "event26"

Esempio di #3

Se…

s.events = "event22,event24,event25";

…e viene eseguito il seguente codice…

s.events = rfl(s.events);

…il valore finale di s.events sarà:

s.events = "";

Se lv argomento o vr sono vuoti in un rfl effettua una chiamata, quindi il plug-in non restituisce nulla.

Esempio di #4

Se…

s.prop4 = "hello|people|today";

…e viene eseguito il seguente codice…

s.eVar5 = rfl(s.prop4,"people","|");

…il valore finale di s.prop4 sarà comunque…

s.prop4 = "hello|people|today";

…ma il valore finale di s.eVar 5 sarà:

s.eVar5 = "hello|today";

Tieni presente che il plug-in restituisce solo un valore; in realtà non "reimposta" la variabile trasmessa attraverso il lv argomento.

Esempio di #5

Se…

s.prop4 = "hello|people|today";

…e viene eseguito il seguente codice…

s.prop4 = rfl(s.prop4,"people");

…il valore finale di s.prop4 sarà comunque…

s.prop4 = "hello|people|today";

Assicurarsi di impostare d1 nei casi in cui lv il valore dell'argomento contiene un delimitatore diverso dal valore predefinito (ovvero virgola).

Esempio di #6

Se…

s.events = "event22,event23,event25";

…e viene eseguito il seguente codice…

s.events = rfl(s.events,"EVenT23");

…il valore finale di s.events sarà:

s.events = "event22,event23,event25";

Anche se questo esempio non è pratico, dimostra la necessità di trasmettere valori con distinzione tra maiuscole e minuscole.

Esempio di #7

Se…

s.events = "event22,event23:12345,event25";

…e viene eseguito il seguente codice…

s.events = rfl(s.events,"event23");

…il valore finale di s.events sarà:

s.events = "event22,event25";

Esempio di #8

Se…

s.events = "event22,event23:12345,event25";

…e viene eseguito il seguente codice…

s.events = rfl(s.events,"event23:12345");

…il valore finale di s.events sarà:

s.events = "event22,event23:12345,event25";

Quando devi rimuovere un evento che utilizza la serializzazione e/o la sintassi numerica/valuta, devi specificare solo l’evento stesso (ovvero senza i valori di serializzazione/numerica/valuta) nel rfl chiamare.

Esempio di #9

Se…

s.events = "event22,event23,event23,event23,event24,event25";

…e viene eseguito il seguente codice…

s.events = rfl(s.events,"event23");

…il valore finale di s.events sarà:

s.events = "event22,event24,event25");

Esempio di #10

Se…

s.events = "event22,event23,event23,event23,event24,event25";

…e viene eseguito il seguente codice…

s.events = rfl(s.events,"event23", "", "",true);

…il valore finale di s.events sarà:

s.events = "event22,event23,event24,event25");

Esempio di #11

Se…

s.events = "event22,event23,event23,event23,event24,event25";

…e viene eseguito il seguente codice…

s.events = rfl(s.events,"event23", "", "|",true);

…il valore finale di s.events sarà:

s.events = "event22|event23|event24|event25");

Esempio di #12

Se…

s.events = "event22,event23,event24,event25";

…e viene eseguito il seguente codice…

s.events = rfl(s.events,"event23,event24");

…il valore finale di s.events sarà:

s.events = "event22,event23,event24,event25";

Impostazione di più valori in vr non è supportato. Il rfl nell’esempio precedente suddividerebbe prima i valori nella sezione lv (es. s.events), quindi prova a far corrispondere ogni valore delimitato con il valore completo vr valore argomento (ad es. "event23,event24").

Esempio di #13

Se…

s.events = "event22,event23,event24,event25";

…e viene eseguito il seguente codice…

s.events = rfl(s.events,"event23");
s.events = rfl(s.events,"event24");

…il valore finale di s.events sarà:

s.events = "event22,event25");

Ogni valore da rimuovere dall’elenco deve essere contenuto nel proprio rfl chiamare.

Esempio di #14

Se…

s.linkTrackVars = "events,eVar1,eVar2,eVar3";

…e viene eseguito il seguente codice…

s.linkTrackVars = rfl(s.linkTrackVars,"eVar2", ",", ",", false);

…il valore finale di s.linkTrackVars sarà:

s.linkTrackVars = "events,eVar1,eVar3";

Gli ultimi tre argomenti (ad esempio ",",",",false) alla fine di questo rfl Le chiamate di non sono necessarie, ma non causano alcun "danno" in quanto sono presenti in quanto corrispondono alle impostazioni predefinite.

Esempio di #15

Se…

s.events = "event22,event23,event24";

…e viene eseguito il seguente codice…

rfl(s.events,"event23");

…il valore finale di s.events sarà comunque:

s.events = "event22,event23,event24";

Anche in questo caso, ricorda che il plug-in restituisce solo un valore; in realtà non "reimposta" la variabile trasmessa attraverso il lv argomento.

Cronologia versioni

2.1 (19 marzo 2021)

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

2.01 (17 settembre 2019)

  • Correzione di bug minori per il valore delimitatore predefinito

2.0 (16 aprile 2018)

  • Versione a punti (ricompilata, con codice di dimensioni inferiori).
  • È stata eliminata la necessità di join plug-in.

1.0 (18 luglio 2016)

  • Versione iniziale.
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690