Adobe plug-in: getQueryParam
Med plugin-programmet getQueryParam
kan du extrahera värdet för alla frågesträngsparametrar som finns i en URL. Det är användbart för att extrahera kampanjkoder, både interna och externa, från URL:er för landningssidor. Det är också värdefullt när du extraherar söktermer eller andra frågesträngsparametrar.
Detta plugin-program innehåller robusta funktioner för att analysera komplexa URL:er, inklusive hashvärden och URL:er som innehåller flera frågesträngsparametrar. Om du bara behöver ha en enkel frågesträngsparameter rekommenderar Adobe att du använder URL-parameterfunktionerna med hjälp av Web SDK eller Adobe Analytics-tillägget eller metoden Util.getQueryParam()
som ingår i AppMeasurementet.
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:
getQueryParam
-
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 getQueryParam
-
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.
/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: getQueryParam v4.0.1 */
function getQueryParam(a,d,f){function n(g,c){c=c.split("?").join("&");c=c.split("#").join("&");var e=c.indexOf("&");if(g&&(-1<e||c.indexOf("=")>e)){e=c.substring(e+1);e=e.split("&");for(var h=0,p=e.length;h<p;h++){var l=e[h].split("="),q=l[1];if(l[0].toLowerCase()===g.toLowerCase())return decodeURIComponent(q||!0)}}return""}if("-v"===a)return{plugin:"getQueryParam",version:"4.0.1"};var b=function(){if("undefined"!==typeof window.s_c_il)for(var g=0,c;g<window.s_c_il.length;g++)if(c=window.s_c_il[g],c._c&&"s_c"===c._c)return c}();"undefined"!==typeof b&&(b.contextData.getQueryParam="4.0");if(a){d=d||"";f=(f||"undefined"!==typeof b&&b.pageURL||location.href)+"";(4<d.length||-1<d.indexOf("="))&&f&&4>f.length&&(b=d,d=f,f=b);b="";for(var m=a.split(","),r=m.length,k=0;k<r;k++)a=n(m[k],f),"string"===typeof a?(a=-1<a.indexOf("#")?a.substring(0,a.indexOf("#")):a,b+=b?d+a:a):b=""===b?a:b+(d+a);return b}};
/******************************************** END CODE TO DEPLOY ********************************************/
Använda plugin-programmet
Funktionen getQueryParam
använder följande argument:
qsp
(obligatoriskt): En kommaavgränsad lista med frågesträngsparametrar som ska sökas efter i URL:en. Den är inte skiftlägeskänslig.de
(valfritt): Den avgränsare som ska användas om flera frågesträngsparametrar matchar. Standardvärdet är en tom sträng.url
(valfritt): En anpassad URL, sträng eller variabel som frågesträngsparametervärdena ska extraheras från. Standardvärdet ärwindow.location
.
Om den här funktionen anropas returneras ett värde beroende på argumenten ovan och URL
- Om ingen matchande frågesträngsparameter hittas returnerar funktionen en tom sträng.
- Om en matchande frågesträngsparameter hittas returnerar funktionen frågesträngsparameterns värde.
- Om en matchande frågesträngsparameter påträffas men värdet är tomt returnerar funktionen
true
. - Om flera matchande frågesträngsparametrar hittas returnerar funktionen en sträng med varje parametervärde avgränsat med strängen i argumentet
de
.
Exempel
// Given the URL https://example.com/?cid=trackingcode
// Sets the campaign variable to "trackingcode"
s.campaign = getQueryParam('cid');
// Given the URL https://example.com/?cid=trackingcode&ecid=123
// Sets the campaign variable to "trackingcode:123"
s.campaign = getQueryParam('cid,ecid',':');
// Given the URL https://example.com/?cid=trackingcode&ecid=123
// Sets the campaign variable to "trackingcode123"
s.campaign = getQueryParam('cid,ecid');
// Given the URL https://example.com/?cid=trackingcode&ecid=123#location
// Sets the campaign variable to "123"
s.campaign = getQueryParam('ecid');
// Given the URL https://example.com/#location&cid=trackingcode&ecid=123
// Sets the campaign variable to "123"
// The plug-in replaces the URL's hash character with a question mark if a question mark doesn't exist.
s.campaign = getQueryParam('ecid');
// Given the URL https://example.com
// Does not set the campaign variable to a value.
s.pageURL = "https://example.com/?cid=trackingcode";
s.campaign = getQueryParam('cid');
// Given the URL https://example.com
// Sets the campaign variable to "trackingcode"
s.pageURL = "https://example.com/?cid=trackingcode";
s.campaign = getQueryParam('cid','',s.pageURL);
// Given the URL https://example.com
// Sets eVar2 to "123|trackingcode|true|300"
s.eVar1 = "https://example.com/?cid=trackingcode&ecid=123#location&pos=300";
s.eVar2 = getQueryParam('ecid,cid,location,pos','|',s.eVar1);
Tidigare versioner
4.0.1 (26 mars 2021)
- Ett problem har uppdaterats där undefined returnerades i stället för "" om frågeparametern inte fanns i frågesträngen.
4.0 (19 mars 2021)
- Versionsnummer har lagts till som kontextdata.
- Tog bort beroenden för plugin-programmet
pt
.
3.3 (24 september 2019)
- Onödig logik som minskar kodstorleken har ignorerats
3.2 (15 maj 2018)
- Flyttade
findParameterValue
- ochgetParameterValue
-funktioner till funktionengetQueryParam
3.1 (10 maj 2018)
- Ett problem med att hämta frågesträngsparametrar utan värde har korrigerats
3.0 (16 april 2018)
- Punktrelease (omkompilerad, mindre kodstorlek).
- Hjälpfunktionerna har bytt namn till
findParameterValue
ochgetParameterValue
i läsbarhetssyfte. - Tog bort behovet av att lägga till ett argument för att hitta parametrar i URL-hash
2.5 (8 januari 2016)
- Kompatibel med både H-kod och AppMeasurement (kräver
s.pt
med AppMeasurementet).
2,4
- Parametern
h
har lagts till, vilket gör att koden kan hitta frågesträngsparametrar som hittas efter hash-tecknet (#
)
2,3
- Korrigerade ett regressionsproblem där plugin-programmet bara fungerade när hashen fanns efter spårningskoden
2,2
- Tar nu bort hash-tecken (och allt efteråt) från returvärdet
2,1
- Kompatibel med H.10-kod