Plug-in di Adobe: getPageName

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 getPageName crea una versione dell'URL corrente in formato semplice e intuitivo. L'Adobe consiglia di utilizzare questo plug-in se si desidera un valore pageName facile da impostare e da comprendere nei rapporti. Questo plug-in non è necessario se si dispone già di una struttura di denominazione per la variabile pageName, ad esempio tramite un livello dati. È consigliabile utilizzarlo quando non si dispone di un'altra soluzione per impostare la variabile pageName.

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: getPageName
  7. Imposta i parametri desiderati a destra.

  8. 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: inizializzare getPageName
  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: getPageName v4.2 */
var getPageName=function(si,qv,hv,de){var a=si,b=qv,f=hv,e=de;if("-v"===a)return{plugin:"getPageName",version:"4.2"};a:{if("undefined"!==typeof window.s_c_il){var d=0;for(var g;d<window.s_c_il.length;d++)if(g=window.s_c_il[d],g._c&&"s_c"===g._c){d=g;break a}}d=void 0}"undefined"!==typeof d&&(d.contextData.getPageName="4.2");var c=location.hostname,h=location.pathname.substring(1).split("/"),l=h.length,k=location.search.substring(1).split("&"),m=k.length;d=location.hash.substring(1).split("&");g=d.length;e=e?e:"|";a=a?a:c;b=b?b:"";f=f?f:"";if(1===l&&""===h[0])a=a+e+"home";else for(c=0;c<l;c+\+)a=a+e+decodeURIComponent(h[c]);if(b&&(1!==m||""!==k[0]))for(h=b.split(","),l=h.length,c=0;c<l;c++)for(b=0;b<m;b++)if(h[c]===k[b].split("=")[0]){a=a+e+decodeURIComponent(k[b]);break}if(f&&(1!==g||""!==d[0]))for(f=f.split(","),k=f.length,c=0;c<k;c++)for(b=0;b<g;b++)if(f[c]===d[b].split("=")[0]){a=a+e+decodeURIComponent(d[b]);break}return a.substring(a.length-e.length)===e?a.substring(0,a.length-e.length):a};
/******************************************** END CODE TO DEPLOY ********************************************/

Utilizzare il plug-in

La funzione getPageName utilizza i seguenti argomenti:

  • si (facoltativo, stringa): ID inserito all'inizio della stringa che rappresenta l'ID del sito. Questo valore può essere un ID numerico o un nome descrittivo. Se non viene impostato, per impostazione predefinita viene utilizzato il dominio corrente.
  • qv (facoltativo, stringa): elenco delimitato da virgole di parametri della stringa di query che, se presenti nell'URL, vengono aggiunti alla stringa
  • hv (facoltativo, stringa): elenco delimitato da virgole di parametri presenti nell'hash URL che, se presenti nell'URL, verranno aggiunti alla stringa
  • de (facoltativo, stringa): delimitatore per suddividere singole parti della stringa. Impostazione predefinita: una pipe (|).

La funzione restituisce una stringa contenente una versione dell’URL in formato descrittivo. Questa stringa viene in genere assegnata alla variabile pageName, ma può essere utilizzata anche in altre variabili.

Esempi

// Given the URL https://mail.example.com/mail/u/0/#inbox, sets the page variable to "mail.example.com|mail|u|0".
s.pageName = getPageName();

// Given the URL https://mail.example.com/mail/u/0/#inbox, sets the page variable to "example|mail|u|0".
s.pageName = getPageName("example");

// Given the URL https://www.example.com/, sets the page variable to "www.example.com|home".
// When the code runs on a URL that does not contain a path, it always adds the value of "home" to the end of the return value.
s.pageName = getPageName();

// Given the URL https://www.example.com/, sets the page variable to "example|home".
s.pageName = getPageName("example","","","|");

// Given the URL https://www.example.com/en/booking/room-booking.html?cid=1235#/step2&arrive=05-26&depart=05-27&numGuests=2
// Sets the page variable to "www.example.com|en|booking|room-booking.html".
s.pageName = getPageName();

// Given the URL https://www.example.com/en/booking/room-booking.html?cid=1235#/step2&arrive=05-26&depart=05-27&numGuests=2
// Sets the page variable to "example: en: booking: room-booking.html: cid=1235: arrive=05-26: numGuests=2"
s.pageName = getPageName("example","cid","arrive,numGuests",": ");

Aggiornamento da versioni precedenti

La versione 4.0+ del plug-in getPageName non dipende dall'esistenza dell'oggetto AppMeasurement di Adobe Analytics, ovvero l'oggetto s. Se si esegue l'aggiornamento a questa versione, modificare il codice che chiama il plug-in rimuovendo eventuali istanze dell'oggetto s dalla chiamata. Modificare ad esempio s.getPageName(); in getPageName();.

Cronologia versioni

4.2 (19 marzo 2021)

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

4.1 (17 settembre 2019)

  • Il valore del delimitatore di default è stato modificato in un carattere barra verticale (da due punti + spazio).

4.0 (22 maggio 2018)

  • Rianalisi/riscrittura completa del plug-in
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690