Plug-in di Adobe: getPageName
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.
-
Accedi a Raccolta dati di Adobe Experience Platform utilizzando le credenziali Adobe ID.
-
Fare clic su Tags a sinistra, quindi fare clic sulla proprietà tag desiderata.
-
Fai clic su Extensions a sinistra, quindi sulla scheda Catalog
-
Individuare e installare l'estensione Common Web SDK Plugins.
-
Fai clic su Data Elements a sinistra, quindi sull'elemento dati desiderato.
-
Imposta il nome dell’elemento dati desiderato con la seguente configurazione:
- Estensione: Common Web SDK Plugins
- Elemento dati:
getPageName
-
Imposta i parametri desiderati a destra.
-
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.
-
Accedi a Raccolta dati di Adobe Experience Platform utilizzando le credenziali Adobe ID.
-
Fai clic sulla proprietà del tag desiderata.
-
Vai alla scheda Extensions, quindi fai clic sul pulsante Catalog
-
Installa e pubblica l'estensione Common Analytics Plugins
-
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)
-
Aggiungi un’azione alla regola precedente con la seguente configurazione:
- Estensione: Common Analytics Plugins
- Tipo azione: inizializzare getPageName
-
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.
- Accedi a Raccolta dati di Adobe Experience Platform utilizzando le credenziali Adobe ID.
- Fai clic sulla proprietà desiderata.
- Vai alla scheda Extensions, quindi fai clic sul pulsante Configure sotto l'estensione Adobe Analytics.
- Espandere il pannello a soffietto Configure tracking using custom code, che mostra il pulsante Open Editor.
- Apri l’editor di codice personalizzato e incolla il codice del plug-in fornito di seguito nella finestra di modifica.
- 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 stringahv
(facoltativo, stringa): elenco delimitato da virgole di parametri presenti nell'hash URL che, se presenti nell'URL, verranno aggiunti alla stringade
(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