Documentatie Analytics Implementatiehandleiding

Adobe-insteekmodule: apl (appendToList)

Laatst bijgewerkt: 26 januari 2024

Onderwerpen:

Gemaakt voor:

Beheerder
Ontwikkelaar

IMPORTANT

Deze insteekmodule wordt door Adobe Consulting geleverd als hoffelijkheid om u te helpen meer waarde uit Adobe Analytics te krijgen. De klantenservice van de Adobe biedt geen ondersteuning voor deze plug-in, inclusief installatie of probleemoplossing. Neem contact op met het accountteam van de Adobe van uw organisatie als u hulp nodig hebt met deze plug-in. Zij kunnen een vergadering voor hulp met een consultant organiseren.

De apl Met plug-in kunt u veilig nieuwe waarden toevoegen aan door lijsten gescheiden variabelen, zoals events, linkTrackVars, listen andere.

Als de waarde die u wilt toevoegen niet in de variabele bestaat, voegt de code de waarde aan het einde van de tekenreeks toe.
Als de waarde die u wilt toevoegen al in de variabele bestaat, wijzigt deze plug-in de waarde niet. Hierdoor kan uw implementatie dubbele waarden voorkomen.
Als de variabele die u wilt toevoegen leeg is, stelt de plug-in de variabele in op de nieuwe waarde.

Adobe raadt u aan deze plug-in te gebruiken als u nieuwe waarden wilt toevoegen aan bestaande variabelen die een reeks gescheiden waarden bevatten. Deze plug-in is niet nodig als u tekenreeksen wilt samenvoegen voor variabelen met gescheiden waarden.

De insteekmodule installeren met de extensie Web SDK of Web SDK

Deze plug-in wordt nog niet ondersteund voor gebruik in de Web SDK.

De insteekmodule installeren met de Adobe Analytics-extensie

Adobe biedt een extensie waarmee u veelgebruikte plug-ins kunt gebruiken met Adobe Analytics.

Aanmelden bij Adobe Experience Platform-gegevensverzameling met uw Adobe-id-referenties.
Klik op de gewenste tageigenschap.
Ga naar de Extensions en klikt u op de knop Catalog knop
Installeer de Common Analytics Plugins extension
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: APL initialiseren (toevoegen aan lijst)
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.

Aanmelden bij Adobe Experience Platform-gegevensverzameling met uw Adobe-id-referenties.
Klik op de gewenste eigenschap.
Ga naar de Extensions en klikt u op de knop Configure onder de extensie Adobe Analytics.
Breid uit Configure tracking using custom code accordion, die de Open Editor knop.
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 bestand AppMeasurement nadat het object Analytics tracking is geïnstantieerd (met s_gi). Door opmerkingen en versienummers van de code in uw implementatie te behouden, kunt u Adoben met het oplossen van mogelijke problemen.

/******************************************* 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 ********************************************/

De plug-in gebruiken

De apl function gebruikt de volgende argumenten:

lv (vereist, tekenreeks): De variabele die een gescheiden lijst met items bevat waaraan een nieuwe waarde moet worden toegevoegd
vta (vereist, tekenreeks): Een door komma's gescheiden lijst met de nieuwe waarden die aan het object moeten worden toegevoegd lv waarde van het argument.
d1 (optioneel, tekenreeks): het scheidingsteken dat wordt gebruikt voor het scheiden van de afzonderlijke waarden die al in het dialoogvenster lv argument. Heeft als standaardwaarde een komma (,) wanneer niet ingesteld.
d2 (optioneel, tekenreeks): het uitvoerscheidingsteken. Heeft standaard dezelfde waarde als d1 wanneer niet ingesteld.
cc (optioneel, Boolean): een markering die aangeeft of een hoofdlettergevoelige controle wordt gebruikt. Indien trueDe duplicatiecontrole is hoofdlettergevoelig. Indien false of niet ingesteld, is de duplicatiecontrole niet hoofdlettergevoelig. Standaardwaarden: false.

De apl functie retourneert de waarde van de lv plus eventuele niet-dubbele waarden in het dialoogvenster vta argument.

Voorbeelden

// 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");

Versiehistorie

4.0 (19 maart 2021)

Versienummer toegevoegd als contextgegevens.

3.2 (25 september 2019)

Compatibiliteitsproblemen met apl aanroepen die oudere versies van de plug-in gebruikten
Verwijderde consolewaarschuwingen om grootte te verminderen
Toegevoegd inList 2.1

3.1 (22 april 2018)

d2 argument wordt nu standaard ingesteld op de waarde van de d1 argument indien niet ingesteld

3.0 (16 april 2018)

Volledige heranalyse/herschrijven van plug-in
Geavanceerde foutcontrole toegevoegd
De vta argument accepteert nu meerdere waarden tegelijk
De d2 argument om de geretourneerde waarde op te maken
De cc argument naar een Booleaanse waarde

2.5 (18 februari 2016)

Gebruikt nu de inList functie voor vergelijkingsverwerking

2.0 (26 januari 2016)

d (Scheidingsteken) argument nu optioneel (wordt standaard een komma)
u (Markering voor hoofdlettergevoeligheid) argument is nu optioneel (wordt standaard ingesteld op hoofdlettergevoelig)
Ongeacht de u (Markering voor hoofdlettergevoeligheid) voegt de plug-in geen waarde meer toe aan een lijst als de waarde al in de lijst voorkomt

recommendation-more-help