Adobe plug-in: getPageName
Plugin-programmet getPageName
skapar en lättläst, användarvänlig formaterad version av den aktuella URL:en. Adobe rekommenderar att du använder det här plugin-programmet om du vill ha ett pageName
-värde som är enkelt att ställa in och förstå vid rapportering. Detta plugin-program behövs inte om du redan har en namnstruktur för variabeln pageName
, till exempel via ett datalager. Det används bäst när du inte har någon annan lösning för att ställa in variabeln pageName
.
Installera plugin-programmet med Web SDK-tillägget
Adobe har ett tillägg som gör att du kan använda de vanligaste plugin-programmen med Web SDK.
-
Logga in på Adobe Experience Platform Data Collection med dina inloggningsuppgifter för AdobeID.
-
Klicka på Tags till vänster och klicka sedan på den önskade taggegenskapen.
-
Klicka på Extensions till vänster och sedan på fliken Catalog
-
Leta reda på och installera tillägget Common Web SDK Plugins.
-
Klicka på Data Elements till vänster och klicka sedan på det önskade dataelementet.
-
Ange det önskade dataelementnamnet med följande konfiguration:
- Tillägg: Vanliga SDK-plugin-program för webben
- Dataelement:
getPageName
-
Ange önskade parametrar till höger.
-
Spara och publicera ändringarna i dataelementet.
Installera plugin-programmet manuellt för att implementera Web SDK
Denna plugin stöds ännu inte för användning i en manuell implementering av Web SDK.
Installera plugin-programmet med Adobe Analytics-tillägget
Adobe har ett tillägg som gör att du kan använda de vanligaste plugin-programmen med Adobe Analytics.
-
Logga in på Adobe Experience Platform Data Collection med dina inloggningsuppgifter för AdobeID.
-
Klicka på den önskade taggegenskapen.
-
Gå till fliken Extensions och klicka sedan på knappen Catalog
-
Installera och publicera tillägget Common Analytics Plugins
-
Om du inte redan har det skapar du en regel med namnet"Initiera plugin-program" med följande konfiguration:
- Villkor: Inget
- Händelse: Kärna - Bibliotek inläst (sidan ovanpå)
-
Lägg till en åtgärd i ovanstående regel med följande konfiguration:
- Tillägg: Plugin-program för gemensam analys
- Åtgärdstyp: Initiera getPageName
-
Spara och publicera ändringarna i regeln.
Installera plugin-programmet med en anpassad kodredigerare
Om du inte vill använda tillägget för Common Analytics-plugin-program kan du använda den anpassade kodredigeraren.
- Logga in på Adobe Experience Platform Data Collection med dina inloggningsuppgifter för AdobeID.
- Klicka på önskad egenskap.
- Gå till fliken Extensions och klicka sedan på knappen Configure under Adobe Analytics-tillägget.
- Expandera dragspelsfliken Configure tracking using custom code som visar knappen Open Editor.
- Öppna den anpassade kodredigeraren och klistra in den plugin-kod som finns nedan i redigeringsfönstret.
- Spara och publicera ändringarna i Analytics-tillägget.
Installera plugin-programmet med AppMeasurementet
Kopiera och klistra in följande AppMeasurement var som helst i analysfilen efter att Analytics-spårningsobjektet har initierats (med s_gi
). Genom att bevara kommentarer och versionsnummer i koden i implementeringen kan Adobe felsöka eventuella problem.
/******************************************* 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 ********************************************/
Använda plugin-programmet
Funktionen getPageName
använder följande argument:
si
(valfri sträng): Ett ID infogades i början av strängen som representerar platsens ID. Värdet kan antingen vara ett numeriskt ID eller ett eget namn. Om den inte anges används den aktuella domänen som standard.qv
(valfri, sträng): En kommaavgränsad lista med frågesträngsparametrar som, om de hittas i URL:en, läggs till i strängenhv
(valfri, sträng): En kommaavgränsad lista med parametrar i URL-hash som, om de hittas i URL:en, läggs till i strängende
(valfri sträng): Avgränsaren för att dela upp enskilda delar av strängen. Standardvärdet är en pipe (|
).
Funktionen returnerar en sträng som innehåller en användarvänlig version av URL:en. Den här strängen tilldelas vanligtvis variabeln pageName
, men kan även användas i andra variabler.
Exempel
// 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",": ");
Uppgradera från tidigare versioner
Version 4.0+ av plugin-programmet getPageName
är inte beroende av om Adobe Analytics AppMeasurement-objektet finns (dvs. s
-objektet). Om du uppgraderar till den här versionen ändrar du koden som anropar plugin-programmet genom att ta bort alla instanser av objektet s
från anropet. Ändra till exempel s.getPageName();
till getPageName();
.
Tidigare versioner
4.2 (19 mars 2021)
- Versionsnummer har lagts till som kontextdata.
4.1 (17 september 2019)
- Standardvärdet för avgränsare har ändrats till ett lodstreck (från kolon + blanksteg).
4.0 (22 maj 2018)
- Fullständig omanalys/omskrivning av plugin-program