Adobe-insteekmodule: getPageName
Met de insteekmodule getPageName kunt u de huidige URL gemakkelijk lezen en een gebruiksvriendelijke versie van de URL gebruiken. Adobe raadt u aan deze plug-in te gebruiken als u een pageName -waarde wilt instellen die gemakkelijk te begrijpen is in de rapportage. Deze insteekmodule is niet nodig als u al een naamgevingsstructuur voor de variabele pageName hebt, bijvoorbeeld via een gegevenslaag. U kunt dit het beste gebruiken als u geen andere oplossing hebt om de variabele pageName in te stellen.
De insteekmodule installeren met de extensie Web SDK
Adobe biedt een extensie waarmee u veelgebruikte plug-ins kunt gebruiken voor de webversie van SDK.
-
Login aan de Inzameling van Gegevens van Adobe Experience Platform gebruikend uw geloofsbrieven van AdobeID.
-
Klik op Tags aan de linkerkant en klik op de gewenste eigenschap Tag.
-
Klik op Extensions aan de linkerkant en klik vervolgens op de tab Catalog
-
Zoek en installeer de extensie Common Web SDK Plugins .
-
Klik op Data Elements aan de linkerkant en klik op het gewenste gegevenselement.
-
Stel de gewenste naam van het gegevenselement in met de volgende configuratie:
- Extensie: algemene SDK-plug-ins voor het web
- Gegevenselement:
getPageName
-
Stel de gewenste parameters rechts in.
-
Sla de wijzigingen in het gegevenselement op en publiceer deze.
De insteekmodule handmatig installeren voor de Web SDK
Deze insteekmodule wordt nog niet ondersteund voor gebruik in een handmatige implementatie van de Web SDK.
De insteekmodule installeren met de Adobe Analytics-extensie
Adobe biedt een extensie waarmee u veelgebruikte plug-ins kunt gebruiken in Adobe Analytics.
-
Login aan de Inzameling van Gegevens van Adobe Experience Platform gebruikend uw geloofsbrieven van AdobeID.
-
Klik op de gewenste tageigenschap.
-
Ga naar de tab Extensions en klik vervolgens op de knop Catalog
-
De extensie Common Analytics Plugins installeren en publiceren
-
Als u niet reeds hebt, creeer een regel geëtiketteerd "Initialize stop-ins"met de volgende configuratie:
- Voorwaarde: geen
- Event: Core - bibliotheek geladen (pagina boven)
-
Voeg een actie aan de bovengenoemde regel met de volgende configuratie toe:
- Extensie: veelgebruikte plug-ins voor Analytics
- Type handeling: Initialize getPageName
-
Sla de wijzigingen in de regel op en publiceer deze.
Plug-in installeren met aangepaste code-editor
Als u niet de Gemeenschappelijke Insteekmodule van Analytics wilt gebruiken, kunt u de redacteur van de douanecode gebruiken.
- Login aan de Inzameling van Gegevens van Adobe Experience Platform gebruikend uw geloofsbrieven van AdobeID.
- Klik op de gewenste eigenschap.
- Ga naar de tab Extensions en klik vervolgens op de knop Configure onder de extensie Adobe Analytics.
- Vouw de accordeon Configure tracking using custom code uit, zodat de knop Open Editor zichtbaar wordt.
- Open de aangepaste code-editor en plak de onderstaande plug-incode in het bewerkingsvenster.
- Sla de wijzigingen in de extensie Analytics op en publiceer deze.
Plug-in installeren met AppMeasurement
Kopieer en plak de volgende code ergens in het AppMeasurement-bestand nadat het object Analytics tracking is geïnstantieerd (met s_gi ). Door opmerkingen en versienummers van de code in uw implementatie te behouden, helpt Adobe bij het oplossen van mogelijke problemen.
/******************************************* 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 ********************************************/
De plug-in gebruiken
De functie getPageName gebruikt de volgende argumenten:
si(optioneel, tekenreeks): een id die wordt ingevoegd aan het begin van de tekenreeks die de id van de site vertegenwoordigt. Deze waarde kan een numerieke id of een vriendelijke naam zijn. Wanneer deze niet is ingesteld, wordt standaard het huidige domein gebruikt.qv(optioneel, tekenreeks): een door komma's gescheiden lijst met parameters van queryreeksen die, indien aanwezig in de URL, aan de tekenreeks worden toegevoegdhv(optioneel, tekenreeks): een door komma's gescheiden lijst met parameters in de URL-hash die, indien aanwezig in de URL, aan de tekenreeks worden toegevoegdde(optioneel, tekenreeks): het scheidingsteken voor het opsplitsen van afzonderlijke delen van de tekenreeks. Heeft als standaardwaarde een pipe (|).
De functie retourneert een tekenreeks met een gebruiksvriendelijke versie van de URL. Deze tekenreeks wordt doorgaans toegewezen aan de variabele pageName , maar kan ook in andere variabelen worden gebruikt.
Voorbeelden
// 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",": ");
Upgrade uitvoeren vanaf vorige versies
Versie 4.0+ van de plug-in getPageName is niet afhankelijk van het bestaan van het AppMeasurement-object van Adobe Analytics (dat wil zeggen het s -object). Als u een upgrade uitvoert naar deze versie, wijzigt u de code waarmee de plug-in wordt aangeroepen door instanties van het s -object uit de aanroep te verwijderen. Wijzig bijvoorbeeld s.getPageName(); in getPageName(); .
Versiehistorie
4.2 (19 maart 2021)
- Versienummer toegevoegd als contextgegevens.
4.1 (17 september 2019)
- Standaardwaarde voor scheidingstekens is gewijzigd in een pijpteken (van een dubbele punt + spatie).
4.0 (22 mei 2018)
- Volledige heranalyse/herschrijven van plug-in