Adobe plug-in: getPageName

IMPORTANT
Denna plugin tillhandahålls av Adobe Consulting som en tjänst som hjälper dig att få ut mer av Adobe Analytics. Adobe kundtjänst ger inte support för denna plugin, inklusive installation och felsökning. Om du behöver hjälp med det här plugin-programmet kontaktar du din organisations Adobe Account Team. De kan ordna ett möte med en konsult för att få hjälp.

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.

  1. Logga in på Adobe Experience Platform Data Collection med dina inloggningsuppgifter för AdobeID.

  2. Klicka på Tags till vänster och klicka sedan på den önskade taggegenskapen.

  3. Klicka på Extensions till vänster och sedan på fliken Catalog

  4. Leta reda på och installera tillägget Common Web SDK Plugins.

  5. Klicka på Data Elements till vänster och klicka sedan på det önskade dataelementet.

  6. Ange det önskade dataelementnamnet med följande konfiguration:

    • Tillägg: Vanliga SDK-plugin-program för webben
    • Dataelement: getPageName
  7. Ange önskade parametrar till höger.

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

  1. Logga in på Adobe Experience Platform Data Collection med dina inloggningsuppgifter för AdobeID.

  2. Klicka på den önskade taggegenskapen.

  3. Gå till fliken Extensions och klicka sedan på knappen Catalog

  4. Installera och publicera tillägget Common Analytics Plugins

  5. 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å)
  6. 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
  7. 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.

  1. Logga in på Adobe Experience Platform Data Collection med dina inloggningsuppgifter för AdobeID.
  2. Klicka på önskad egenskap.
  3. Gå till fliken Extensions och klicka sedan på knappen Configure under Adobe Analytics-tillägget.
  4. Expandera dragspelsfliken Configure tracking using custom code som visar knappen Open Editor.
  5. Öppna den anpassade kodredigeraren och klistra in den plugin-kod som finns nedan i redigeringsfönstret.
  6. 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ängen
  • hv (valfri, sträng): En kommaavgränsad lista med parametrar i URL-hash som, om de hittas i URL:en, läggs till i strängen
  • de (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
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690