Plug-in di Adobe: p_fo (solo pagina prima)

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

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

  2. Fare clic su Tags a sinistra, quindi fare clic sulla proprietà tag desiderata.

  3. Fai clic su Extensions a sinistra, quindi sulla scheda Catalog

  4. Individuare e installare l'estensione Common Web SDK Plugins.

  5. Fai clic su Data Elements a sinistra, quindi sull'elemento dati desiderato.

  6. Imposta il nome dell’elemento dati desiderato con la seguente configurazione:

    • Estensione: Common Web SDK Plugins
    • Elemento dati: p_fo
  7. 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.

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

  2. Fai clic sulla proprietà del tag 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 "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 p_fo
  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 alla scheda Extensions, quindi fai clic sul pulsante Configure sotto l'estensione Adobe Analytics.
  4. Espandere il pannello a soffietto Configure tracking using custom code, che mostra il pulsante Open Editor.
  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

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.
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690