Adobe-insteekmodule: getQueryParam
Met de insteekmodule getQueryParam
kunt u de waarde van elke querytekenreeksparameter in een URL extraheren. Het is nuttig om campagnecodes, zowel intern als extern, uit het landen van pagina URLs te halen. Het is ook nuttig wanneer het halen van onderzoekstermijnen of andere parameters van het vraagkoord.
Deze plug-in biedt robuuste functies voor het parseren van complexe URL's, waaronder hashes en URL's die meerdere parameters voor queryreeksen bevatten. Als u alleen eenvoudige parametervereisten voor queryreeksen hebt, raadt Adobe u aan de URL-parameterfuncties te gebruiken met de extensie Web SDK of Adobe Analytics of de methode Util.getQueryParam()
die in AppMeasurement is opgenomen.
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 Platformgebruikend 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:
getQueryParam
-
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 Platformgebruikend 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: getQueryParam initialiseren
-
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 Platformgebruikend 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.
/******************************************* 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 ********************************************/
De plug-in gebruiken
De functie getQueryParam
gebruikt de volgende argumenten:
qsp
(vereist): een door komma's gescheiden lijst met querytekenreeksparameters die moet worden gezocht binnen de URL. Het is niet hoofdlettergevoelig.de
(optioneel): Het scheidingsteken dat moet worden gebruikt wanneer meerdere parameters van de queryreeks overeenkomen. Heeft als standaardwaarde een lege tekenreeks.url
(optioneel): Een aangepaste URL, tekenreeks of variabele waaruit de parameterwaarden voor de queryreeks moeten worden geƫxtraheerd. Wordt standaard ingesteld opwindow.location
.
Als deze functie wordt aangeroepen, wordt een waarde geretourneerd die afhankelijk is van de bovenstaande argumenten en de URL:
- Als er geen overeenkomende parameter voor een querytekenreeks wordt gevonden, retourneert de functie een lege tekenreeks.
- Als een overeenkomende parameter voor een querytekenreeks wordt gevonden, retourneert de functie de parameterwaarde voor de queryreeks.
- Als een overeenkomende parameter voor een querytekenreeks wordt gevonden maar de waarde leeg is, retourneert de functie
true
. - Als er meerdere overeenkomende parameters voor queryreeksen worden gevonden, retourneert de functie een tekenreeks met elke parameterwaarde die door de tekenreeks in het argument
de
wordt gescheiden.
Voorbeelden
// 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);
Versiehistorie
4.0.1 (26 maart 2021)
- Bijgewerkte kwestie waar undefined in plaats van ""werd teruggekeerd als vraagparam niet in het vraagkoord aanwezig was.
4.0 (19 maart 2021)
- Versienummer toegevoegd als contextgegevens.
- Afhankelijkheden van
pt
plug-in zijn verwijderd.
3.3 (24 september 2019)
- Overbodige logica om codegrootte te verkleinen
3.2 (15 mei 2018)
findParameterValue
- engetParameterValue
-functies verplaatst naar de functiegetQueryParam
3.1 (10 mei 2018)
- Probleem verholpen met het vastleggen van parameters voor queryreeksen zonder waarde
3.0 (16 april 2018)
- Puntrelease (opnieuw gecompileerd, kleiner codeformaat).
- De naam van hulplijnfuncties is gewijzigd in
findParameterValue
engetParameterValue
voor leesbaarheidsdoeleinden. - Verwijderde de behoefte om een argument toe te voegen om parameters in het knoeiboel te vinden URL
2.5 (8 januari 2016)
- Compatibel met zowel H-code als AppMeasurement (vereist
s.pt
met AppMeasurement).
2,4
- De parameter
h
is toegevoegd, zodat de code kan zoeken naar parameters van queryreeksen die na het hash-teken (#
) worden gevonden.
2,3
- Probleem verholpen waarbij de insteekmodule alleen werkte toen de hash aanwezig was na de trackingcode. Dit probleem is nu opgelost.
2,2
- Verwijdert nu hash-tekens (en alles daarna) uit de geretourneerde waarde
2,1
- Compatibel met H.10-code