Adobe plug-in: apl (appendToList)
Med plugin-programmet apl
kan du lägga till nya värden i listavgränsade variabler som events
, linkTrackVars
, list
med flera.
- Om värdet som du vill lägga till inte finns i variabeln läggs värdet till i slutet av strängen.
- Om värdet som du vill lägga till redan finns i variabeln ändras inte värdet av det här plugin-programmet. Med den här funktionen kan implementeringen undvika dubblettvärden.
- Om variabeln som du vill lägga till i är tom ställs variabeln in på det nya värdet av plugin-programmet.
Adobe rekommenderar att du använder det här plugin-programmet om du vill lägga till nya värden till befintliga variabler som innehåller en sträng med avgränsade värden. Denna plugin behövs inte om du föredrar att sammanfoga strängar för variabler som innehåller avgränsade värden.
Installera plugin-programmet med Web SDK- eller Web SDK-tillägget
Det här plugin-programmet stöds ännu inte för användning i 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 APL (Bifoga till lista)
-
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: apl (appendToList) v4.0 */
function apl(lv,va,d1,d2,cc){var b=lv,d=va,e=d1,c=d2,g=cc;if("-v"===b)return{plugin:"apl",version:"4.0"};var h=function(){if("undefined"!==typeof window.s_c_il)for(var k=0,b;k<window.s_c_il.length;k++)if(b=window.s_c_il[k],b._c&&"s_c"===b._c)return b}();"undefined"!==typeof h&&(h.contextData.apl="4.0");window.inList=window.inList||function(b,d,c,e){if("string"!==typeof d)return!1;if("string"===typeof b)b=b.split(c||",");else if("object"!==typeof b)return!1;c=0;for(a=b.length;c<a;c++)if(1==e&&d===b[c]||d.toLowerCase()===b[c].toLowerCase())return!0;return!1};if(!b||"string"===typeof b){if("string"!==typeof d||""===d)return b;e=e||",";c=c||e;1==c&&(c=e,g||(g=1));2==c&&1!=g&&(c=e);d=d.split(",");h=d.length;for(var f=0;f<h;f++)window.inList(b,d[f],e,g)||(b=b?b+c+d[f]:d[f])}return b};
/******************************************** END CODE TO DEPLOY ********************************************/
Använda plugin-programmet
Funktionen apl
använder följande argument:
lv
(obligatoriskt, sträng): Variabeln som innehåller en avgränsad lista med objekt som ett nytt värde ska läggas till ivta
(obligatoriskt, sträng): En kommaavgränsad lista över nya värden som ska läggas till i argumentetlv
.d1
(valfri sträng): Avgränsaren som används för att separera de enskilda värden som redan finns i argumentetlv
. Standardvärdet är ett kommatecken (,
) när inget anges.d2
(valfri, sträng): Utdataavgränsaren. Standardvärdet är samma somd1
när det inte är inställt.cc
(valfritt, booleskt): En flagga som anger om en skiftlägeskänslig kontroll används. Omtrue
är dubblettkontrollen skiftlägeskänslig. Omfalse
anges eller inte är dubblettkontrollen inte skiftlägeskänslig. Standardvärdet ärfalse
.
Funktionen apl
returnerar värdet för argumentet lv
plus alla icke-duplicerade värden i argumentet vta
.
Exempel
// Set the events variable to "event22,event24,event23".
s.events = "event22,event24";
s.events = apl(s.events,"event23");
// The events variable remains unchanged because the apl function does not add duplicate values
s.events = "event22,event23";
s.events = apl(s.events,"event23");
// Set the events variable to "event23" if the events variable is blank
s.events = "";
s.events = apl(s.events,"event23");
// Append a value to eVar5. The value of prop4 remains unchanged.
// The value of eVar5 is "hello|people|today".
s.prop4 = "hello|people";
s.eVar5 = apl(s.prop4, "today", "|");
// Sets prop4 to "hello|people,today". Be mindful of correct delimiters!
s.prop4 = "hello|people";
s.prop4 = apl(s.prop4, "today");
// Sets the events variable to "event22,event23,EVentT23". Be mindful of capitalization when using the cc argument!
s.events = "event22,event23";
s.events = apl(s.events,"EVenT23", ",", ",", true);
// Sets the events variable to "event22,event23,event24,event25".
s.events = "event22,event23";
s.events = apl(s.events, "event23,event24,event25");
// Sets linkTrackVars to "events,eVar1,campaign".
// The last three arguments at the end of this apl call are not necessary because they match the default argument values.
s.linkTrackVars = "events,eVar1";
s.linkTrackVars = apl(s.linkTrackVars, "campaign", ",", ",", false);
// This apl call does not do anything because the code does not assign the returned value to a variable.
s.events = "event22,event24";
apl(s.events, "event23");
// Sets the list2 variable to "apple-APPLE-Apple".
// Since the two delimiter arguments are different, the value passed in is delimited by "|", then joined together by "-".
s.list2 = "apple|APPLE";
s.list2 = apl(s.list2, "Apple", "|", "-", true);
// Sets the list3 variable to "value1,value1,value1" (unchanged).
// Only new values are deduplicated. Existing duplicate values remain.
s.list3 = "value1,value1,value1";
s.list3 = apl(s.list3,"value1");
Tidigare versioner
4.0 (19 mars 2021)
- Versionsnummer har lagts till som kontextdata.
3.2 (25 september 2019)
- Korrigerade kompatibilitetsproblem med
apl
anrop som använde äldre versioner av plugin-programmet - Konsolvarningar har tagits bort för att minska storleken
inList 2.1
har lagts till
3.1 (22 april 2018)
- Argumentet
d2
får nu som standard värdet för argumentetd1
om det inte anges
3.0 (16 april 2018)
- Fullständig omanalys/omskrivning av plugin-program
- Avancerad felkontroll har lagts till
- Argumentet
vta
tar nu emot flera värden samtidigt - Argumentet
d2
har lagts till för att formatera returvärdet - Argumentet
cc
har ändrats till ett booleskt värde
2.5 (18 februari 2016)
- Använder nu funktionen
inList
för jämförelsebearbetning
2.0 (26 januari 2016)
- Argumentet
d
(avgränsare) är nu valfritt (standardvärdet är ett komma) - Argumentet
u
(flagga för skiftlägeskänslighet) är nu valfritt (standardvärdet är skiftlägeskänsligt) - Oavsett argumentet
u
(skiftlägeskänslighetsflagga) lägger plugin-programmet inte längre till ett värde i en lista om värdet redan finns i listan