Show Menu
THEMEN×

Adobe-Plug-in:getTimeBetweenEvents

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 getTimeBetweenEvents Plug-in können Sie die Zeitdauer zwischen zwei beliebigen Analytics-Ereignissen, einschließlich Warenkorb- und benutzerspezifischen Ereignissen, verfolgen. Es ist nützlich, wenn Sie verfolgen möchten, wie lange ein Kassengangprozess dauert, oder einen anderen Prozess, bei dem Sie die Zeit messen möchten. Dieses Plug-in ist nicht erforderlich, wenn Sie keine Konvertierungsprozesse haben, mit denen Sie messen möchten, wie lange sie dauern.

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: Initialize getTimeBetweenEvents
  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: getTimeBetweenEvents v2.1 (Requires formatTime and inList plug-ins) */
s.getTimeBetweenEvents=function(ste,rt,stp,res,cn,etd,fmt,bml,rte){var s=this;if("string"===typeof ste&&"undefined"!==typeof rt&&"string"===typeof stp&&"undefined"!==typeof res){cn=cn?cn:"s_tbe";etd=isNaN(etd)?1:Number(etd);var f=!1,g=!1,n=!1, p=ste.split(","),q=stp.split(",");rte=rte?rte.split(","):[];for(var h=s.c_r(cn),k,v=new Date,r=v.getTime(),c=new Date,a=0; a<rte.length;++a)s.inList(s.events,rte[a])&&(n=!0);c.setTime(c.getTime()+864E5*etd);for(a=0;a<p.length&&!f&&(f=s.inList(s.events,p[a]),!0!==f);++a);for(a=0;a<q.length&&!g&&(g=s.inList(s.events,q[a]),!0!==g);++a);1===p.length&&1===q.length&&ste===stp&&f&&g?(h&&(k=(r-h)/1E3),s.c_w(cn,r,etd?c:0)):(!f||1!=rt&&h||s.c_w(cn,r,etd?c:0),g&&h&&(k=(v.getTime()-h)/1E3,!0===res&&(n=!0)));!0===n&&(c.setDate( c.getDate()-1),s.c_w(cn,"",c));return k?s.formatTime(k,fmt,bml):""}};

/* Adobe Consulting Plugin: formatTime v1.1 (Requires inList plug-in) */
s.formatTime=function(ns,tf,bml){var s=this;if(!("undefined"===typeof ns||isNaN(ns)||0>Number(ns))){if("string"===typeof tf&&"d"===tf||("string"!==typeof tf||!s.inList("h,m,s",tf))&&86400<=ns){tf=86400;var d="days";bml=isNaN(bml)?1:tf/(bml*tf)} else"string"===typeof tf&&"h"===tf||("string"!==typeof tf||!s.inList("m,s",tf))&&3600<=ns?(tf=3600,d="hours", bml=isNaN(bml)?4: tf/(bml*tf)):"string"===typeof tf&&"m"===tf||("string"!==typeof tf||!s.inList("s",tf))&&60<=ns?(tf=60,d="minutes",bml=isNaN(bml)?2: tf/(bml*tf)):(tf=1,d="seconds",bml=isNaN(bml)?.2:tf/bml);ns=Math.round(ns*bml/tf)/bml+" "+d;0===ns.indexOf("1 ")&&(ns=ns.substring(0,ns.length-1));return ns}};

/* 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 getTimeBetweenEvents Methode verwendet die folgenden Argumente:
  • ste (erforderlich, Zeichenfolge): Start-Timer-Ereignisse. Eine kommagetrennte Zeichenfolge aus Analytics-Ereignissen, die den Timer starten soll.
  • rt (erforderlich, Boolescher Wert): Option Timer neu starten. Legen Sie diese Einstellung fest, true wenn Sie den Timer jedes Mal neu starten möchten, wenn die events Variable ein start timer-Ereignis enthält. Legen Sie diese Einstellung fest, false wenn der Timer nicht neu gestartet werden soll, wenn ein start timer-Ereignis angezeigt wird.
  • stp (erforderlich, Zeichenfolge): Stoppen von Timer-Ereignissen. Eine kommagetrennte Zeichenfolge aus Analytics-Ereignissen, die den Timer stoppen.
  • res (erforderlich, Boolescher Wert): Option Timer zurücksetzen. Legen Sie diese Einstellung fest, true wenn Sie die Zeit seit dem Start des Timers aufzeichnen möchten UND setzen Sie den Timer nach dem Beenden zurück. Legen Sie diese Einstellung fest, false wenn Sie die Zeit aufzeichnen möchten, den Timer jedoch nicht beenden möchten. Bei Festlegung auf false wird der Timer weiter ausgeführt, nachdem die Ereignisvariable ein stop-Ereignis aufgezeichnet hat.
    Wenn Sie dieses Argument auf false setzen, empfiehlt es sich dringend, das unten stehende rte Argument festzulegen.
  • cn (optional, Zeichenfolge): Der Cookie-Name, in dem die Zeit des ersten Ereignisses gespeichert wird. Die Standardeinstellung ist "s_tbe" .
  • etd (optional, integer): Die Ablaufzeit für das Cookie in Tagen. Mit 0 Ablauf am Ende der Browsersitzung festlegen. Wenn kein Wert festgelegt ist, wird standardmäßig 1 Tag verwendet.
  • fmt (optional, Zeichenfolge): Das Format der Zeit, in der die Anzahl der Sekunden zurückgegeben wird (standardmäßig ohne)
    • "s" für Sekunden
    • "m" für Minuten
    • "h" für Stunden
    • "d" für Tage
    • Ist dies nicht der Fall, basiert das Format des Rückgabewerts auf den folgenden Regeln:
      • Alles, was weniger als eine Minute beträgt, wird auf die nächste 5-Sekunden-Benchmark gerundet. Beispiel: 10 Sekunden, 15 Sekunden
      • Alles zwischen einer Minute und einer Stunde wird auf den nächsten 1/2-Minuten-Benchmark gerundet. Beispiel: 30,5 Minuten, 31 Minuten
      • Alles, was zwischen einer Stunde und einem Tag liegt, wird auf den nächstgelegenen Referenzwert der Viertelstunde gerundet. Beispiel: 2,25 Stunden, 3,5 Stunden
      • Alles, was länger als ein Tag ist, wird auf die nächste Benchmark gerundet. Beispiel: 1 Tage, 3 Tage, 9 Tage
  • bml (optional, Zahl): Die Länge des Rundungs-Referenzwerts entsprechend dem Format des fmt Arguments. Wenn das fmt Argument beispielsweise "s" und dieses Argument 2 lautet, wird der Rückgabewert auf den nächsten 2-Sekunden-Referenzwert gerundet. Wenn fmt das Argument "m" und dieses Argument 0.5 vorliegt, wird der Rückgabewert auf den nächstgelegenen Halbminutenwert gerundet.
  • rte (optional, Zeichenfolge): Kommagetrennte Zeichenfolge von Analytics-Ereignissen, die den Timer entfernen oder löschen. Die Standardeinstellung ist nichts.
Beim Aufrufen dieser Methode wird eine Ganzzahl zurückgegeben, die die Zeit zwischen dem Ereignis start timer und stop timer im gewünschten Format darstellt.

Beispielaufrufe

Beispiel 1

Der folgende Code...
s.eVar1 = s.getTimeBetweenEvents("event1", true, "event2", true, "", 0, "s", 2, "event3");

...wie folgt konfiguriert ist:
  • Der Timer beginnt, wenn s.events event1 enthält.
  • Der Timer startet jedes Mal neu, wenn s.events event1 enthält.
  • Der Timer wird beendet, wenn s.events event2 enthält
  • Der Timer wird jedes Mal, wenn s.events event2 enthält, zurückgesetzt (d. h. auf 0 Sekunden gehen)
  • Der Timer wird auch dann zurückgesetzt, wenn s.events event3 enthält ODER wenn der Besucher seinen Browser schließt
  • Wenn eine tatsächliche Zeit zwischen "event1"und "event2"aufgezeichnet wird, stellt das Plug-in "eVar1"auf die Anzahl der Sekunden zwischen den beiden eingestellten Ereignissen ein, gerundet auf die nächste 2-Sekunden-Benchmark (z. B. 0 Sekunden, 2 Sekunden, 4 Sekunden, 10 Sekunden, 184 Sekunden usw.)
  • Wenn s.events event2 enthält, bevor ein Timer gestartet wurde, wird eVar1 nicht eingestellt.

Beispiel 2

Der folgende Code...
s.eVar1 = s.getTimeBetweenEvents("event1", false, "event2", false, "s_20", 20, "h", 1.5, "event3");

...wie folgt konfiguriert ist:
  • Der Timer beginnt, wenn s.events event1 enthält.
  • Der Timer wird NICHT jedes Mal neu gestartet, wenn s.events event1 enthält. Der ursprüngliche Timer wird weiterhin ausgeführt
  • Der Timer wird NICHT angehalten, wenn s.events event2 enthält, aber das Plug-In zeichnet die Zeit seit der ursprünglichen Einstellung event1 auf
  • Der Timer wird in einem Cookie namens "s_20"gespeichert
  • Der Timer wird nur zurückgesetzt, wenn s.events event3 enthält ODER wenn 20 Tage seit dem Start des Timers vergangen sind
  • Wenn eine Zeit zwischen (dem ursprünglichen) Ereignis1 und event2 aufgezeichnet wird, stellt das Plug-in eVar1 auf die Anzahl der Stunden zwischen den beiden Ereignissen ein, die auf den nächsten 1 1/2-Stunden-Benchmark gerundet werden (z. B. 0 Stunden, 1,5 Stunden, 3 Stunden, 7,5 Stunden, 478,5 Stunden usw.).

Beispiel 3

Der folgende Code...
s.eVar1 = s.getTimeBetweenEvents("event1", true, "event2", true);

...werden ähnliche Ergebnisse wie im ersten Beispiel oben erzielt; Der Wert von eVar1 wird jedoch je nach der endgültigen Länge des Timers in Sekunden, Minuten, Stunden oder Tagen zurückgegeben. Außerdem läuft der Timer 1 Tag nach der ersten Einstellung ab und nicht, wenn der Besucher seinen Browser schließt.

Versionsverlauf

2.1 (26. Mai 2018)

  • Hiermit werden Änderungen an der neuen Version des formatTime Plug-Ins unterstützt.

2.0 (6. April 2018)

  • Umschreiben/Neuanalyse des Plug-Ins