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 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 p_fo
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: 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

Il metodo 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, questo metodo restituisce true e crea l'oggetto. Se l'oggetto esiste già, questo metodo 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(s.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 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.