Adobe-Plug-in: apl (appendToList)

Mit dem apl-Plug-in können Sie sicher neue Werte zu durch Listen getrennten Variablen hinzufügen, wie z. B. events, linkTrackVars, list und andere.

• Wenn der Wert, den Sie hinzufügen möchten, nicht in der Variablen vorhanden ist, fügt der Code den Wert am Ende der Zeichenfolge hinzu.
• Wenn der Wert, den Sie hinzufügen möchten, bereits in der Variablen vorhanden ist, ändert dieses Plug-in den Wert nicht. Diese Funktionen ermöglichen es Ihrer Implementierung, doppelte Werte zu vermeiden.
• Wenn die Variable, der Sie hinzufügen möchten, leer ist, setzt das Plug-in die Variable auf den neuen Wert.

Adobe empfiehlt die Verwendung dieses Plug-ins, wenn Sie vorhandenen Variablen, die eine Zeichenfolge aus durch Trennzeichen getrennten Werten enthalten, neue Werte hinzufügen möchten. Dieses Plug-in ist nicht erforderlich, wenn Sie Zeichenfolgen für Variablen mit getrennten Werten verknüpfen möchten.

Installieren des Plug-ins mit der Adobe Experience Platform Launch-Erweiterung

Adobe bietet eine Erweiterung, mit der Sie die gängigsten Plug-ins verwenden können.

1. Melden Sie sich mit Ihren Adobe ID-Anmeldeinformationen bei launch.adobe.com an.
2. Klicken Sie auf die gewünschte Eigenschaft.
3. Gehen Sie zur Registerkarte Erweiterungen und klicken Sie dann auf die Schaltfläche Katalog.
4. Installieren und Veröffentlichen der Erweiterung Common Analytics Plugins.
5. Wenn Sie dies noch nicht getan haben, erstellen Sie eine Regel mit der Bezeichnung „Plug-ins initialisieren“ mit der folgenden Konfiguration:
   • Bedingung: Keine
   • Ereignis: Core – Bibliothek geladen (Seitenanfang)
6. Fügen Sie der obenstehenden Regel eine Aktion mit der folgenden Konfiguration hinzu:
   • Erweiterung: Common Analytics Plugins
   • Aktionstyp: APL („Append To List“ (An Liste anhängen)) initialisieren
7. Speichern und veröffentlichen Sie die Änderungen an der Regel.

Installieren des Plug-ins mit dem benutzerdefinierten Code-Editor in Launch

Wenn Sie die Plug-in-Erweiterung nicht verwenden möchten, können Sie den Editor für benutzerdefinierten Code verwenden.

1. Melden Sie sich mit Ihren Adobe ID-Anmeldeinformationen bei launch.adobe.com an.
2. Klicken Sie auf die gewünschte Eigenschaft.
3. Gehen Sie zur Registerkarte Erweiterungen und klicken Sie dann unter der Erweiterung „Adobe Analytics“ auf die Schaltfläche Konfigurieren.
4. Erweitern Sie das Akkordeon Tracking mit benutzerdefiniertem Code konfigurieren, wodurch die Schaltfläche Editor öffnen angezeigt wird.
5. Öffnen Sie den Editor für benutzerdefinierten Code und fügen Sie den unten angegebenen Plug-in-Code in das Bearbeitungsfenster ein.
6. Speichern und veröffentlichen Sie die Änderungen an der Analytics-Erweiterung.

Installieren des Plug-ins mit AppMeasurement

Kopieren Sie den folgenden Code und fügen Sie ihn an beliebiger Stelle in der AppMeasurement Datei ein, nachdem das Analytics-Tracking-Objekt instanziiert wurde (unter Verwendung von s_gi). Die Beibehaltung von Kommentaren und Versionsnummern des Codes in Ihrer Implementierung hilft Adobe bei der Fehlerbehebung potenzieller Probleme.

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

Verwenden des Plug-ins

Die apl-Methode verwendet die folgenden Argumente:

• lv (erforderlich, Zeichenfolge): Die Variable, die eine durch Trennzeichen getrennte Liste von Elementen enthält, der ein neuer Wert hinzugefügt werden soll
• vta (erforderlich, Zeichenfolge): Eine durch Komma getrennte Liste der neuen Werte, die dem lv-Argumentwert hinzugefügt werden sollen.
• d1 (optional, Zeichenfolge): Das Trennzeichen, mit dem die einzelnen Werte getrennt werden, die bereits im lv-Argument enthalten sind. Die Standardeinstellung ist ein Komma (,), wenn nicht festgelegt.
• d2 (optional, Zeichenfolge): Das Ausgabetrennzeichen. Der Standardwert ist derselbe Wert wie d1, wenn nicht festgelegt.
• cc (optional, boolesch): Eine Markierung, die anzeigt, ob bei einer Prüfung die Groß-/Kleinschreibung beachtet wird. Wenn die Markierung true ist, wird bei der Duplizierungsprüfung die Groß- und Kleinschreibung beachtet. Wenn die Markierung false oder nicht gesetzt ist, wird bei der Duplizierungsprüfung nicht zwischen Groß- und Kleinschreibung unterschieden. Die Standardeinstellung ist false.

Die apl-Methode gibt den Wert des lv-Arguments sowie alle nicht duplizierten Werte im vta-Argument zurück.

Beispielaufrufe

Beispiel 1

Wenn …

s.events = "event22,event24";

… und der folgende Code ausgeführt wird …

s.events = s.apl(s.events, "event23");

… lautet der Endwert von s.events:

s.events = "event22,event24,event23";

Beispiel 2

Wenn …

s.events = "event22,event23";

… und der folgende Code ausgeführt wird …

s.events = s.apl(s.events, "event23");

… lautet der Endwert von s.events weiterhin:

s.events = "event22,event23";

In diesem Beispiel hat der apl-Aufruf keine Änderungen an s.events vorgenommen, da s.events bereits „event23“ enthielt

Beispiel 3

Wenn …

s.events = ""; //blank value

… und der folgende Code ausgeführt wird …

s.events = s.apl(s.events, "event23");

… lautet der Endwert von s.events …

s.events = "event23";

Beispiel 4

Wenn …

s.prop4 = "hello|people";

… und der folgende Code ausgeführt wird …

s.eVar5 = s.apl(s.prop4, "today", "|");

… lautet der Endwert von s.prop4 weiterhin …

s.prop4 = "hello|people";

… aber der Endwert von s.eVar5 lautet

s.eVar5 = "hello|people|today";

Beachten Sie, dass das Plug-in nur einen Wert zurückgibt; es setzt die durch das lv-Argument übergebene Variable nicht unbedingt zurück.

Beispiel 5

Wenn …

s.prop4 = "hello|people";

… und der folgende Code ausgeführt wird …

s.prop4 = s.apl(s.prop4, "today");

… lautet der Endwert von s.prop4 …

s.prop4 = "hello|people,today";

Stellen Sie sicher, dass das Trennzeichen zwischen dem Wert des lv-Arguments und dem Wert der Argumente d1/d2 konsistent ist

Beispiel 6

Wenn …

s.events = "event22,event23";

… und der folgende Code ausgeführt wird …

s.events = s.apl(s.events,"EVenT23", ",", ",", true);

… lautet der Endwert von s.events:

s.events = "event22,event23,EVentT23";

Obwohl dieses Beispiel nicht praktikabel ist, zeigt es, dass bei Verwendung der Markierung, bei der die Groß- und Kleinschreibung beachtet werden muss, Vorsicht geboten ist.

Beispiel 7

Wenn …

s.events = "event22,event23";

… und der folgende Code ausgeführt wird …

s.events = s.apl(s.events, "event23,event24,event25");

… lautet der Endwert von s.events:

s.events = "event22,event23,event24,event25");

Das Plug-in fügt s.events „event23“ nicht hinzu, da es bereits in s.events vorhanden ist. Allerdings werden „event24“ und „event25“ zu s.events hinzugefügt, da keines der beiden Ereignisse zuvor in s.events enthalten war.

Beispiel 8

Wenn …

s.linkTrackVars = "events,eVar1";

… und der folgende Code ausgeführt wird …

s.linkTrackVars = s.apl(s.linkTrackVars, "campaign", ",", ",", false);

… lautet der Endwert von s.linkTrackVars:

s.linkTrackVars = "events,eVar1,campaign";

Die letzten drei Argumente (d. h. „,“, „,“, false) am Ende dieses apl-Aufrufs sind nicht erforderlich, verletzen aber auch nichts, da sie mit den Standardargumentwerten übereinstimmen.

Beispiel 9

Wenn …

s.events = "event22,event24";

… und der folgende Code ausgeführt wird …

s.apl(s.events, "event23");

… lautet der Endwert von s.events weiterhin:

s.events = "event22,event24";

Wenn Sie das Plug-in allein ausführen (ohne den Rückgabewert einer Variablen zuzuweisen), wird die Variable, die über das lv-Argument übergeben wird, nicht zurückgesetzt.

Beispiel 10

Wenn …

s.list2 = "casesensitivevalue|casesensitiveValue"

… und der folgende Code ausgeführt wird …

s.list2 = s.apl(s.list2, "CasESensiTiveValuE", "|", "-", true);

… lautet der Endwert von s.list2:

s.list2 = "casesensitivevalue-casesensitiveValue-CasESensiTiveValuE"

Da die beiden Trennzeichen-Argumente unterschiedlich sind, wird der übergebene Wert durch das erste Trennzeichen-Argument („ “) getrennt und dann durch das zweite Trennzeichen („-“) verbunden.

Versionsverlauf

4.0 (19. März 2021)

• Versionsnummer als Kontextdaten hinzugefügt.

3.2 (25. September 2019)

• Kompatibilitätsprobleme mit apl-Aufrufen behoben, bei denen ältere Versionen des Plug-ins verwendet wurden
• Konsolenwarnungen zur Reduzierung der Größe entfernt
• Hinzufügung von inList 2.1

3.1 (22. April 2018)

• Das Argument d2 wird jetzt standardmäßig auf den Wert des Arguments d1 gesetzt, wenn nicht festgelegt

3.0 (16. April 2018)

• Vollständige Neuanalyse/Umformulierung des Plug-ins
• Erweiterte Fehlerprüfung hinzugefügt
• Das vta-Argument akzeptiert jetzt mehrere Werte auf einmal
• Das d2-Argument zum Formatieren des Rückgabewerts wurde hinzugefügt
• Das cc-Argument wurde in einen boolesches Argument geändert

2.5 (18. Februar 2016)

• Verwendet jetzt die inList-Methode für die Vergleichsverarbeitung

2.0 (26. Januar 2016)

• Das Argument d (Trennzeichen) ist jetzt optional (standardmäßig ein Komma)
• Das Argument u (Markierung für Groß-/Kleinschreibung) ist jetzt optional (standardmäßig wird nicht zwischen Groß- und Kleinschreibung unterschieden)
• Unabhängig vom Argument u (Markierung für Groß-/Kleinschreibung), hängt das Plug-in keinen Wert mehr an eine Liste an, wenn der Wert bereits in der Liste vorhanden ist