Show Menu
THEMEN×

Adobe-Plug-in:inList

Dieses Plug-in wird von Adobe Consulting bereitgestellt, um Ihnen zu helfen, aus Adobe Analytics mehr Nutzen zu ziehen. Der Adobe-Kundendienst bietet keine Unterstützung für dieses Plug-in, einschließlich Installation und Fehlerbehebung. Wenn Sie Hilfe zu diesem Plug-in benötigen, wenden Sie sich an den Kundenbetreuer Ihres Unternehmens. Sie können ein Treffen mit einem Berater für Hilfe arrangieren.
Mit dem inList Plug-in können Sie überprüfen, ob ein Wert bereits in einer getrennten Zeichenfolge oder einem JavaScript-Array-Objekt vorhanden ist. Einige andere Plug-Ins hängen von dem inList Plug-In ab, um zu funktionieren. Dieses Plug-in bietet einen klaren Vorteil gegenüber der JavaScript-Methode, indexOf() bei der partielle Zeichenfolgen nicht übereinstimmen. Wenn Sie dieses Plug-In beispielsweise zur Überprüfung verwendet haben, "event2" stimmt es nicht mit einer Zeichenfolge überein, die "event25" Folgendes enthält. Dieses Plug-in ist nicht erforderlich, wenn Sie nicht nach Werten in getrennten Zeichenfolgen oder Arrays suchen müssen oder wenn Sie Ihre eigene indexOf() Logik verwenden möchten.

Installieren Sie das Plug-In mit der Adobe Experience Platform Launch-Erweiterung

Adobe bietet eine Erweiterung, mit der Sie am häufigsten verwendete Plug-ins verwenden können.
  1. Log in to launch.adobe.com using your AdobeID credentials.
  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: Keines
    • Ereignis: Core - Bibliothek geladen (Seitenanfang)
  6. Fügen Sie der oben stehenden Regel eine Aktion mit der folgenden Konfiguration hinzu:
    • Erweiterung: Allgemeine Analytics-Plugins
    • Aktionstyp: InList initialisieren
  7. Speichern und veröffentlichen Sie die Änderungen an der Regel.

Installieren des Plug-Ins mit dem Editor für benutzerdefinierten Code starten

Wenn Sie die Plug-in-Erweiterung nicht verwenden möchten, können Sie den Editor für benutzerspezifischen Code verwenden.
  1. Log in to launch.adobe.com using your AdobeID credentials.
  2. Klicken Sie auf die gewünschte Eigenschaft.
  3. Wechseln Sie zur Registerkarte Erweiterungen und klicken Sie dann unter der Erweiterung Adobe Analytics auf die Schaltfläche Konfigurieren .
  4. Erweitern Sie die Verfolgung mithilfe eines benutzerdefinierten Code -Akkordeons, das die Schaltfläche zum Öffnen des Editors anzeigt.
  5. Öffnen Sie den benutzerdefinierten Code-Editor und fügen Sie den unten angegebenen Plug-in-Code in das Bearbeitungsfenster ein.
  6. Speichern und veröffentlichen Sie die Änderungen in der Analytics-Erweiterung.

Plug-In mit AppMeasurement installieren

Kopieren Sie den folgenden Code an einer beliebigen Stelle in der AppMeasurement-Datei, nachdem das Analytics-Verfolgungsobjekt instanziiert wurde (unter Verwendung 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: inList v2.1 */
s.inList=function(lv,vtc,d,cc){if("string"!==typeof vtc)return!1;if("string"===typeof lv)lv=lv.split(d||",");else if("object"!== typeof lv)return!1;d=0;for(var e=lv.length;d<e;d++)if(1==cc&&vtc===lv[d]||vtc.toLowerCase()===lv[d].toLowerCase())return!0;return!1};
/******************************************** END CODE TO DEPLOY ********************************************/

Plug-In verwenden

Die inList Methode verwendet die folgenden Argumente:
  • lv (erforderlich, Zeichenfolge oder Array): Eine durch Trennzeichen getrennte Liste von Werten oder ein JavaScript-Array-Objekt, das gesucht werden soll
  • vtc (erforderlich, Zeichenfolge): Der zu suchende Wert
  • d (optional, Zeichenfolge): Das Trennzeichen, das zum Trennen einzelner Werte im lv Argument verwendet wird. Wenn kein Komma festgelegt ist, wird standardmäßig ein Komma ( , ) verwendet.
  • cc (optional, boolean): Bei Festlegung auf true wird die Groß-/Kleinschreibung überprüft. Wenn dies auf " false oder nicht angegeben"festgelegt ist, wird die Groß-/Kleinschreibung nicht überprüft. Die Standardeinstellung ist false .
Der Aufruf dieser Methode gibt zurück, true wenn eine Übereinstimmung gefunden wird und false wenn keine Übereinstimmung gefunden wird.

Beispielaufrufe

Beispiel 1

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

...und der folgende Code wird ausgeführt...
if(s.inList(s.events,"event22"))

...Die bedingte if-Anweisung ist "true"

Beispiel 2

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

...und der folgende Code wird ausgeführt...
if(s.inList(s.events,"event2"))

...Die bedingte if-Anweisung ist "false", da der InList-Aufruf keine exakte Übereinstimmung zwischen event2 und einem der durch Trennzeichen getrennten Werte in s.events machte

Beispiel 3

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

...und der folgende Code wird ausgeführt...
if(!s.inList(s.events,"event23"))

...Die bedingte if-Anweisung ist "true", da der InList-Aufruf keine exakte Übereinstimmung zwischen event23 und einem der durch Trennzeichen getrennten Werte in s.events hergestellt hat (beachten Sie den Operator "NOT"am Anfang des InList-Variablenaufrufs).

Beispiel 4

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

...und der folgende Code wird ausgeführt...
if(s.inList(s.events,"EVenT23","",1))

...Die bedingte if-Anweisung lautet false. Dieses Beispiel ist zwar nicht praktikabel, zeigt aber, dass bei der Verwendung des Flags unter Beachtung der Groß- und Kleinschreibung Vorsicht geboten ist.

Beispiel 5

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

...und der folgende Code wird ausgeführt...
if(s.inList(s.linkTrackVars,"eVar1","|"))

...Die bedingte if-Anweisung lautet false. Der Wert des d-Arguments, das an den Aufruf übergeben wird (d.h. "|") geht davon aus, dass die einzelnen Werte in s.linkTrackVars durch ein Pipe-Zeichen getrennt werden, während die Werte in Wirklichkeit durch ein Komma getrennt werden. In diesem Fall versucht das Plug-in, eine Übereinstimmung zwischen dem gesamten Wert von s.linkTrackVars (d.h. "events,eVar1") und den zu suchenden Wert (d.h. "eVar1").

Versionsverlauf

v2.1 (26. September 2019)

  • Es wurde die Option hinzugefügt, dass das cc Argument kein boolescher Wert sein darf. Beispiel: 1 ist ein gültiger Wert für die Groß-/Kleinschreibung.

v2.0 (17. April 2018)

  • Point Release (neu kompiliert, kleinere Codegröße).

v1.01 (27. September 2017)

  • Optimierter Code zur Verringerung der Größe

v1.0 (2009)

  • Erstes Release.