Übersicht über die allgemeine Web SDK-Plug-ins-Erweiterung
In diesem Dokument wird beschrieben, wie Sie die Web SDK-Plug-in-Tag-Erweiterung konfigurieren und verwenden, um die Adobe Experience Platform Web SDK-Erweiterung.
Konfigurieren der allgemeinen Web SDK-Plug-in-Erweiterung
Dieser Abschnitt enthält eine Referenz zu den verfügbaren Optionen beim Konfigurieren der Web SDK Plugins-Erweiterung.
Hinzufügen von Plug-ins zur Adobe Experience Platform Web SDK-Erweiterung
Es ist keine Konfiguration erforderlich, um ein Plug-in zu Ihrer Bibliothek zu initialisieren oder hinzuzufügen, außerhalb der Verwendung der folgenden nativen Datenelemente, die von der Common Web SDK Plugins-Erweiterung bereitgestellt werden:
getAndPersistValue
Ermöglicht die Einrichtung und Konfiguration der getAndPersistValue Analytics-Plug-in. Die getAndPersistValue -Datenelement speichert einen Wert in einem Cookie, der später während eines Besuchs abgerufen werden kann.
Die getAndPersistValue data -Element stellt die folgenden Argumente bereit:
vtp(erforderlich): Der Wert, der von Seite zu Seite beibehalten werden sollcn(optional): Der Name des Cookies, in dem der Wert gespeichert werden soll. Wenn dieses Argument nicht gesetzt ist, heißt Das Cookie"s_gapv"ex(optional): Die Anzahl der Tage vor Ablauf des Cookies. Wenn dieses Argument0oder nicht gesetzt ist, läuft das Cookie am Ende des Besuchs ab (30 Minuten Inaktivität).
Wenn die Variable in der Variablen vtp festgelegt ist, setzt das Datenelement das Cookie und gibt dann den Cookie-Wert zurück. Wenn die Variable in der Variablen vtp nicht festgelegt ist, gibt das Datenelement nur den Cookie-Wert zurück.
getGeoCoordinates
Ermöglicht die Einrichtung und Konfiguration der getGeoCoordinates Analytics-Plug-in. Die getGeoCoordinates -Datenelement erfasst den Breiten- und Längengrad der Geräte von Besuchern.
Die getGeoCoordinates -Datenelement verwendet keine Argumente. Sie gibt einen der folgenden Werte zurück:
"geo coordinates not available": Für Geräte, die zum Zeitpunkt der Ausführung des Plug-ins keine Geolocation-Daten verfügbar haben. Dieser Wert wird häufig beim ersten Treffer des Besuchs verwendet, insbesondere dann, wenn Besucher zunächst ihre Zustimmung zum Tracking ihres Standorts geben müssen."error retrieving geo coordinates": Wenn das Plug-in beim Versuch, den Standort des Geräts abzurufen, auf Fehler stößt."latitude=[LATITUDE] | longtitude=[LONGITUDE]": Wobei [BREITENGRAD]/[LÄNGENGRAD] der Breitengrad bzw. der Längengrad ist.
getNewRepeat
Ermöglicht die Einrichtung und Konfiguration der getNewRepeat Analytics-Plug-in. Die getNewRepeat -Datenelement bestimmt, ob es sich bei einem Besucher auf der Site um einen neuen Besucher oder einen wiederkehrenden Besucher innerhalb einer gewünschten Anzahl von Tagen handelt.
Die getNewRepeat data -Element verwendet die folgenden Argumente:
d(Ganzzahl, optional): Die erforderliche Mindestanzahl von Tagen zwischen Besuchen, die Besucher auf"New"zurücksetzt. Wenn dieses Argument nicht festgelegt ist, wird der Standardwert 30 Tage verwendet.
Dieses Datenelement gibt den Wert von "New" , wenn das vom Datenelement eingestellte Cookie nicht vorhanden oder abgelaufen ist. Es wird der Wert von "Repeat" wenn das vom Datenelement eingestellte Cookie vorhanden ist und die Zeit seit dem aktuellen Treffer und die im Cookie festgelegte Zeit länger als 30 Minuten sind. Diese Methode gibt denselben Wert für den gesamten Besuch zurück.
getPageName
Ermöglicht die Einrichtung und Konfiguration der getPageName Analytics-Plug-in. Die getPageName -Datenelement erstellt eine leicht lesbare, benutzerfreundlich formatierte Version der aktuellen URL.
Die getPageName data -Element verwendet die folgenden Argumente:
si(optional, Zeichenfolge): Eine ID, die am Anfang der Zeichenfolge eingefügt wird, welche die ID der Website darstellt. Dieser Wert kann entweder eine numerische ID oder ein benutzerfreundlicher Name sein. Wenn sie nicht eingestellt ist, wird standardmäßig die aktuelle Domain verwendet.qv(optional, Zeichenfolge): Eine durch Komma getrennte Liste von Abfragezeichenfolgenparametern, die, falls sie in der URL enthalten sind, der Zeichenfolge hinzugefügt werdenhv(optional, Zeichenfolge): Eine durch Komma getrennte Liste von Parametern im URL-Hash, die, wenn sie in der URL gefunden werden, der Zeichenfolge hinzugefügt werdende(optional, Zeichenfolge): Das Trennzeichen zum Aufteilen einzelner Teile der Zeichenfolge. Der Standardwert ist ein senkrechter Strich (|).
Das Datenelement gibt eine Zeichenfolge zurück, die eine benutzerfreundlich formatierte Version der URL enthält. Diese Zeichenfolge wird normalerweise der pageName-Variablen zugewiesen, kann aber auch in anderen Variablen verwendet werden.
getPreviousValue
Ermöglicht die Einrichtung und Konfiguration der getPreviousValue Analytics-Plug-in. Die getPreviousValue -Datenelement legt eine Variable auf einen Wert fest, der bei einem vorherigen Treffer festgelegt wurde.
Die getPreviousValue data -Element verwendet die folgenden Argumente:
v(Zeichenfolge erforderlich): Die Variable mit dem Wert, der an die nächste Bildanforderung übergeben werden soll. Eine häufig verwendete Variable ists.pageName, um den Wert der vorherigen Seite abzurufen.c(Zeichenfolge, optional): Der Name des Cookies, in dem der Wert gespeichert wird. Wenn dieses Argument nicht festgelegt ist, wird standardmäßig"s_gpv"verwendet.
Wenn Sie dieses Datenelement aufrufen, wird der im Cookie enthaltene Zeichenfolgenwert zurückgegeben. Das Plug-in setzt dann das Ablaufdatum des Cookies zurück und weist ihm den Variablenwert aus dem v-Argument zu. Das Cookie läuft nach 30 Minuten Inaktivität ab.
getQueryParam
Ermöglicht die Einrichtung und Konfiguration der getQueryParam Analytics-Plug-in. Die getQueryParam -Datenelement extrahiert den Wert eines beliebigen Abfragezeichenfolgenparameters, der in einer URL enthalten ist. Dies ist nützlich, um interne und externe Kampagnencodes aus den Landingpage-URLs zu extrahieren. Dies ist auch beim Extrahieren von Suchbegriffen oder anderen Abfragezeichenfolgenparametern nützlich. Dieses Datenelement bietet zuverlässige Funktionen zum Analysieren komplexer URLs, einschließlich Hashes und URLs, die mehrere Abfragezeichenfolgenparameter enthalten.
Die getQueryParam data -Element verwendet die folgenden Argumente:
qsp(erforderlich): Eine durch Komma getrennte Liste von Abfragezeichenfolgenparametern, nach denen in der URL gesucht werden soll. Es wird nicht zwischen Groß- und Kleinschreibung unterschieden.de(optional): Das zu verwendende Trennzeichen, wenn mehrere Abfragezeichenfolgenparameter übereinstimmen. Der Standardwert ist eine leere Zeichenfolge.url(optional): Eine benutzerdefinierte URL, Zeichenfolge oder Variable, aus der die Parameterwerte der Abfragezeichenfolge extrahiert werden. Die Standardeinstellung istwindow.location.
Der Aufruf dieses Datenelements gibt einen Wert zurück, der von den oben genannten Argumenten und der URL abhängt:
- Wenn kein übereinstimmender Abfragezeichenfolgenparameter gefunden wird, gibt die Methode eine leere Zeichenfolge zurück.
- Wenn ein übereinstimmender Abfragezeichenfolgenparameter gefunden wird, gibt die Methode den Parameterwert der Abfragezeichenfolge zurück.
- Wenn ein übereinstimmender Abfragezeichenfolgenparameter gefunden wird, der Wert jedoch leer ist, gibt die Methode
truezurück. - Wenn mehrere übereinstimmende Abfragezeichenfolgenparameter gefunden werden, gibt die Methode eine Zeichenfolge zurück, bei der jeder Parameterwert durch die Zeichenfolge im
de-Argument getrennt wird.
getTimeParting
Ermöglicht die Einrichtung und Konfiguration der getTimeParting Analytics-Plug-in. Die getTimeParting -Datenelement erfasst die Details zum Zeitpunkt, zu dem eine beliebige messbare Aktivität auf Ihrer Site stattfindet. Dieses Datenelement ist nützlich, wenn Sie Metriken nach wiederholbarer Zeitteilung über einen bestimmten Datumsbereich aufschlüsseln möchten. Sie können beispielsweise die Konversionsraten zwischen zwei verschiedenen Wochentagen vergleichen, z. B. alle Sonntage im Vergleich zu allen Donnerstagen. Sie können auch Tageszeiträume vergleichen, z. B. alle Morgen im Vergleich zu allen Abenden.
Die getTimeParting -Datenelement verwendet das folgende Argument:
t (Optional, aber empfohlen, Zeichenfolge): Der Name der Zeitzone, in die die Ortszeit des Besuchers umgerechnet werden soll. Die Standardeinstellung ist die UTC/GMT-Zeit. Siehe Abschnitt Liste der Zeitzonen der TZ-Datenbank auf Wikipedia für eine vollständige Liste der gültigen Werte.
Zu den üblichen gültigen Werten gehören:
"America/New_York"für Eastern Time (EST)"America/Chicago"für Central Time (CST)"America/Denver"für Mountain Time (MST)"America/Los_Angeles"für Pacific Time (PST)
Der Aufruf dieses Datenelements gibt eine Zeichenfolge zurück, die die folgende durch einen senkrechten Strich (|):
- Das aktuelle Jahr
- Der aktuelle Monat
- Der Tag des Monats
- Der Tag des Woche
- Die aktuelle Zeit
getTimeSinceLastVisit
Ermöglicht die Einrichtung und Konfiguration der getTimeSinceLastVisit Analytics-Plug-in. Die getTimeSinceLastVisit -Datenelement verfolgt, wie lange ein Besucher nach seinem letzten Besuch gebraucht hat, um zu Ihrer Site zurückzukehren.
Die getTimeSinceLastVisit -Datenelement verwendet keine Argumente. Sie gibt die seit dem letzten Website-Besuch des Besuchers verstrichene Zeit in folgendem Format zurück:
- Eine Zeit zwischen 30 Minuten und einer Stunde seit dem letzten Besuch wird auf den nächsten halbminütigen Benchmark gesetzt. Beispiel,
"30.5 minutes","53 minutes" - Eine Zeit zwischen einer Stunde und einem wird auf den nächsten viertelstündigen Benchmark gerundet. Beispiel,
"2.25 hours","7.5 hours" - Eine Zeit, die länger als ein Tag ist, wird auf den nächsten Tages-Benchmark gerundet. Beispiel,
"1 day","3 days","9 days","372 days" - Wenn ein Besucher noch nie zuvor einen Besuch gemacht hat oder die verstrichene Zeit größer als zwei Jahre ist, wird der Wert auf
"New Visitor"gesetzt.
getValOnce
Ermöglicht die Einrichtung und Konfiguration der getValOnce Analytics-Plug-in. Die getValOnce -Datenelement verhindert, dass eine Variable mehrmals auf denselben Wert gesetzt wird.
Die getValOnce data -Element verwendet die folgenden Argumente:
vtc(erforderlich, Zeichenfolge): Die Variable, die daraufhin geprüft werden soll, ob sie gerade zuvor auf einen identischen Wert gesetzt wurdecn(optional, Zeichenfolge): Der Name des Cookies, das den zu prüfenden Wert enthält. Die Standardeinstellung ist"s_gvo"et(optional, Ganzzahl): Der Ablauf des Cookies in Tagen (oder Minuten, je nach demep-Argument). Die Standardeinstellung ist0, die am Ende der Browser-Sitzung abläuftep(optional, Zeichenfolge): Legen Sie dieses Argument nur fest, wenn daset-Argument ebenfalls festgelegt ist. Setzen Sie dieses Argument auf"m", wenn Sie möchten, dass daset-Argument in Minuten statt in Tagen abläuft. Die Standardeinstellung ist"d", die daset-Argument in Tagen festlegt.
Wenn das vtc-Argument und der Cookie-Wert übereinstimmen, gibt diese Methode eine leere Zeichenfolge zurück. Wenn das vtc-Argument und der Cookie-Wert nicht übereinstimmen, gibt die Methode das vtc-Argument als Zeichenfolge zurück.
getVisitDuration
Ermöglicht die Einrichtung und Konfiguration der getVisitDuration Analytics-Plug-in. Die getVisitDuration -Datenelement verfolgt die Zeit in Minuten, die der Besucher bis zu diesem Zeitpunkt auf der Site verbracht hat.
Die getVisitDuration -Datenelement verwendet keine Argumente. Sie gibt einen der folgenden Werte zurück:
"first hit of visit""less than a minute""1 minute""[x] minutes"(wobei[x]die Anzahl der Minuten ist, die seit der Landung des Besuchers auf der Website vergangen sind)
getVisitNum
Ermöglicht die Einrichtung und Konfiguration der getVisitNum Analytics-Plug-in. Die getVisitNum -Datenelement gibt die Besuchsnummer für alle Besucher zurück, die innerhalb der gewünschten Anzahl von Tagen auf die Site kommen.
Die getVisitNum data -Element verwendet die folgenden Argumente:
-
rp(optional, Ganzzahl ODER Zeichenfolge): Die Anzahl der Tage, bevor der Besuchsnummerzähler zurückgesetzt wird. Die Standardeinstellung ist365, wenn nicht festgelegt.- Wenn dieses Argument
"w"ist, wird der Zähler am Ende der Woche (an diesem Samstag um 23:59 Uhr) zurückgesetzt - Wenn dieses Argument
"m"ist, wird der Zähler am Ende des Monats (am letzten Tag dieses Monats) zurückgesetzt - Wenn dieses Argument
"y"ist, wird der Zähler am Ende des Jahres (am 31. Dezember) zurückgesetzt
- Wenn dieses Argument
-
erp(optional, boolesch): Wenn dasrp-Argument eine Zahl ist, bestimmt dieses Argument, ob die Gültigkeit der Besuchsnummer verlängert werden soll. Wenn der Wert auftruegesetzt wird, wird der Besuchsnummernzähler durch nachfolgende Treffer auf Ihrer Website zurückgesetzt. Wenn der Wert auffalsegesetzt wird, werden nachfolgende Treffer auf Ihrer Website nicht verlängert, wenn der Zähler für die Besuchsnummer zurückgesetzt wird. Die Standardeinstellung isttrue. Dieses Argument ist nicht gültig, wenn dasrp-Argument eine Zeichenfolge ist.
Die Anzahl der Besuche wird erhöht, wenn der Besucher nach 30 Minuten Inaktivität zu Ihrer Website zurückkehrt. Der Aufruf dieser Methode gibt eine Ganzzahl zurück, die die aktuelle Besuchsnummer des Besuchers angibt.
p_fo (Nur Seite zuerst)
Ermöglicht die Einrichtung und Konfiguration der p_fo Analytics-Plug-in. Die p_fo data -Element ist ein Dienstprogramm, das prüft, ob ein bestimmtes JavaScript-Objekt vorhanden ist. Wenn das Objekt nicht vorhanden ist, erstellt das Plug-in das Objekt und gibt true zurück. Wenn das JavaScript-Objekt bereits auf der Seite vorhanden ist, gibt es false zurück. Dieses Datenelement ist nützlich, um Code genau einmal auf einer Seite auszuführen.
Die p_fo data -Element verwendet die folgenden Argumente:
on(erforderlich, Zeichenfolge): Der Name des JavaScript-Objekts, das vom Datenelement erstellt wird, wenn das Objekt noch nicht auf der Seite vorhanden ist.
Wenn das Objekt noch nicht vorhanden ist, gibt diese Methode true zurück und erzeugt das Objekt. Wenn das Objekt bereits vorhanden ist, gibt diese Methode false zurück.