Plug-in di Adobe: p_fo (solo pagina prima)
Il plug-in p_fo
è un'utility che verifica l'esistenza di un oggetto JavaScript specifico. Se l'oggetto non esiste, il plug-in crea l'oggetto e restituisce true
. Se l'oggetto JavaScript esiste già nella pagina, restituisce false
. Questo plug-in è utile per eseguire il codice esattamente una volta su una pagina. Diversi altri plug-in si basano su questo codice per funzionare. Questo plug-in non è necessario se non sei preoccupato del numero di volte in cui il codice viene eseguito su una pagina o se non utilizzi plug-in dipendenti.
Installare il plug-in utilizzando l’estensione Web SDK
Adobe offre un’estensione che consente di utilizzare i plug-in più comunemente utilizzati con Web SDK.
-
Accedi a Raccolta dati di Adobe Experience Platform utilizzando le credenziali Adobe ID.
-
Fare clic su Tags a sinistra, quindi fare clic sulla proprietà tag desiderata.
-
Fai clic su Extensions a sinistra, quindi sulla scheda Catalog
-
Individuare e installare l'estensione Common Web SDK Plugins.
-
Fai clic su Data Elements a sinistra, quindi sull'elemento dati desiderato.
-
Imposta il nome dell’elemento dati desiderato con la seguente configurazione:
- Estensione: Common Web SDK Plugins
- Elemento dati:
p_fo
-
Salva e pubblica le modifiche apportate all’elemento dati.
Installare manualmente il plug-in implementando Web SDK
Questo plug-in non è ancora supportato per l’utilizzo in un’implementazione manuale dell’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.
-
Accedi a Raccolta dati di Adobe Experience Platform utilizzando le credenziali Adobe ID.
-
Fai clic sulla proprietà del tag desiderata.
-
Vai alla scheda Extensions, quindi fai clic sul pulsante Catalog
-
Installa e pubblica l'estensione Common Analytics Plugins
-
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)
-
Aggiungi un’azione alla regola precedente con la seguente configurazione:
- Estensione: Common Analytics Plugins
- Tipo azione: inizializza p_fo
-
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.
- Accedi a Raccolta dati di Adobe Experience Platform utilizzando le credenziali Adobe ID.
- Fai clic sulla proprietà desiderata.
- Vai alla scheda Extensions, quindi fai clic sul pulsante Configure sotto l'estensione Adobe Analytics.
- Espandere il pannello a soffietto Configure tracking using custom code, che mostra il pulsante Open Editor.
- Apri l’editor di codice personalizzato e incolla il codice del plug-in fornito di seguito nella finestra di modifica.
- Salva e pubblica le modifiche nell’estensione Analytics.
Installare il plug-in utilizzando AppMeasurement
Copiare e incollare il codice seguente 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: p_fo (pageFirstOnly) v3.0 (Requires AppMeasurement) */
function p_fo(c){if("-v"===c)return{plugin:"p_fo",version:"3.0"};a:{if("undefined"!==typeof window.s_c_il){var a=0;for(var b;a<window.s_c_il.length;a++)if(b=window.s_c_il[a],b._c&&"s_c"===b._c){a=b;break a}}a=void 0}"undefined"!==typeof a&&(a.contextData.p_fo="3.0");window.__fo||(window.__fo={});if(window.__fo[c])return!1;window.__fo[c]={};return!0};
/******************************************** END CODE TO DEPLOY ********************************************/
Utilizzare il plug-in
La funzione p_fo
utilizza i seguenti argomenti:
- on (obbligatorio, stringa): nome dell'oggetto JavaScript creato dal plug-in, se l'oggetto non esiste ancora nella pagina.
Se l'oggetto non esiste ancora, questa funzione restituisce true
e crea l'oggetto. Se l'oggetto esiste già, questa funzione restituisce false
.
Esempio di chiamate
Esempio di #1
Il codice seguente verifica l'esistenza dell'oggetto "myobject" all'interno della pagina. Se l'oggetto "myobject" non esiste, il codice creerà l'oggetto "myobject" e restituirà il valore true. Di conseguenza, verrà eseguito il codice all’interno dell’istruzione condizionale (ovvero Console.log('hello');).
D'altra parte, se l'oggetto "myobject" esiste già quando viene effettuata la chiamata p_fo, la funzione p_fo restituirà il valore false e, pertanto, l'istruzione condizionale sarà considerata false. In questo caso, il codice all’interno dell’istruzione condizionale non verrà eseguito.
if(p_fo("myobject"))
{
console.log("hello");
}
NOTA: ogni volta che un nuovo oggetto pagina/DOM viene caricato (o la pagina corrente viene ricaricata), l'oggetto specificato nell'argomento on non esiste più e pertanto il plug-in p_fo restituisce nuovamente true la prima volta che viene eseguito dopo il completamento del caricamento della pagina.
Cronologia versioni
3.0 (19 marzo 2021)
- È stato aggiunto il numero di versione come dati contestuali.
2.0
- Versione a punti (ricompilata, con codice di dimensioni inferiori).
- Tipo di valore restituito cambiato da intero a booleano
1,0
- Versione iniziale.