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 i tag in Adobe Experience Platform

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

1. Accedi all' Interfaccia di raccolta dati 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 p_fo
7. Salva e pubblica le modifiche alla regola.

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

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

1. Accedi all' Interfaccia di raccolta dati 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: 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 ********************************************/

Usa 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.

Chiamate di esempio

Esempio n. 1

Il codice seguente controllerà 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, viene eseguito il codice all’interno dell’istruzione condizionale (ad esempio Console.log('hello');).

Se invece l'oggetto "myobject" esiste già quando avviene la chiamata p_fo, la funzione p_fo restituirà il valore di false e, quindi, l'istruzione condizionale verrà 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 viene caricato un nuovo oggetto/DOM di pagina (o la pagina corrente viene ricaricata), l'oggetto specificato nell'argomento on non esisterà più e quindi il plug-in p_fo restituirà nuovamente true la prima volta che viene eseguito dopo il termine del caricamento della pagina.

Cronologia versioni

3.0 (19 marzo 2021)

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

2.0

• Rilascio del punto (ricompilato, dimensioni del codice più piccole).
• Tipo di valore restituito modificato da integer a booleano

1,0

• Versione iniziale.