Adobe plug-in: apl (appendToList)

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.

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.

  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 APL (Bifoga till lista)
  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: 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 i
  • vta (obligatoriskt, sträng): En kommaavgränsad lista över nya värden som ska läggas till i argumentet lv.
  • d1 (valfri sträng): Avgränsaren som används för att separera de enskilda värden som redan finns i argumentet lv. Standardvärdet är ett kommatecken (,) när inget anges.
  • d2 (valfri, sträng): Utdataavgränsaren. Standardvärdet är samma som d1 när det inte är inställt.
  • cc (valfritt, booleskt): En flagga som anger om en skiftlägeskänslig kontroll används. Om true är dubblettkontrollen skiftlägeskänslig. Om false anges eller inte är dubblettkontrollen inte skiftlägeskänslig. Standardvärdet är false.

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 argumentet d1 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
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690