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 p_fo Il plug-in è 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. Clic Tags a sinistra, fai clic sulla proprietà tag desiderata.

  3. Clic Extensions a sinistra, quindi fai clic su Catalog scheda

  4. Individuare e installare Common Web SDK Plugins estensione.

  5. Clic Data Elements a sinistra, quindi fai clic 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 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 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 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: 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

Il p_fo La funzione utilizza i seguenti argomenti:

  • il (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 esisterà più e pertanto il plug-in p_fo restituirà 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