Erfassen Sie erstmals Besuche mit Metricalp

Die Schönheit von Metricalp liegt darin, dass wir es so flexibel und effizient wie möglich gestaltet haben. So können Sie verschiedene Probleme damit lösen. Eines der häufigen Probleme, das Sie möglicherweise lösen möchten, ist das Verfolgen von Erstbesuchen. In diesem Anwendungsfall zeigen wir Ihnen, wie Sie Erstbesuche mit Metricalp verfolgen können.

In der Analyse kategorisieren wir Benutzer in zwei Gruppen: neue Benutzer und wiederkehrende Benutzer. Neue Benutzer sind die Benutzer, die Ihre Website zum ersten Mal besuchen. Wiederkehrende Benutzer sind die Benutzer, die Ihre Website mehr als einmal besuchen. In diesem Anwendungsfall zeigen wir Ihnen, wie Sie Erstbesuche mit Metricalp verfolgen können. Mit wenigen grundlegenden Implementierungsschritten können Sie dies erreichen. Metricalp bietet Ihnen die Flexibilität, dieses Ziel zu erreichen. Wir werden hauptsächlich die Funktion "benutzerdefinierte Eigenschaften" von Metricalp verwenden, um dies zu erreichen.

Der erste Schritt besteht darin, zu erkennen, ob ein Benutzer neu (Erstbesuch) oder ein wiederkehrender Benutzer ist. Wir werden localStorage verwenden, um ein Flag zu speichern, um dies zu erkennen. Es wird nur ein Dummy-Wahrheitswert-Flag sein. Es werden keine persönlichen Daten enthalten, sodass es in den meisten Fällen in Ordnung ist, aber in einigen Fällen, abhängig von Ihrem Standort / Sektor und dem Standort der Benutzer, müssen Sie möglicherweise um die Zustimmung des Benutzers bitten, um dieses Flag zu speichern oder sie zumindest in Ihrer Datenschutzerklärung darüber informieren. Das liegt in Ihrer Verantwortung. Nennen wir dieses Flag "vis_bef", was „schon besucht“ bedeutet. Okay, sehen Sie sich den folgenden Codeausschnitt an:

        <script>
          const isFirstVisit = !localStorage.getItem('vis_bef');
          if (isFirstVisit) {
              localStorage.setItem('vis_bef', 'true')
          }
        
          window.metricalp = window.metricalp || {
            queue: [],
            sharedCustomProps: {
              _global: {
                custom_prop3: isFirstVisit
              },
            },
            event: function (e) {
                this.queue.push(e);
            },
          };
        </script>
        <script src="https://cdn.metricalp.com/event/metricalp.js" data-tid="YOUR_TID" async></script>
        

Lassen Sie uns hier einige Anmerkungen hinzufügen. Wir erklären dies durch pure JS-Integration. Wenn Sie unsere React-Bibliothek zur Integration verwenden, folgen Sie bitte der Dokumentation, um dasselbe Ergebnis zu erzielen. Eine andere Sache ist, dass wir oben die Funktion sharedCustomProps verwenden. Sie können dies in unserer Dokumentation nachlesen, um mehr darüber zu erfahren. Okay, wir lesen das Flag aus localStorage. Wenn es nicht existiert, bedeutet das, dass dies ein Erstbesuch ist. Wenn es existiert, bedeutet das, dass dies ein wiederkehrender Benutzer ist. Wir setzen diesen Wert als benutzerdefinierte Eigenschaft "custom_prop3" fest. Außerdem können Sie einen benutzerdefinierten Eigenschaftsalias für diese benutzerdefinierte Eigenschaft festlegen - was wir unten tun werden - wie „is_first_visit_ever: true“. Überprüfen Sie erneut die Dokumentation zu benutzerdefinierten Ereignissen und Eigenschaften für benutzerdefinierte Eigenschaften und Aliase. Nun, für alle Ereignisse (einschließlich Seitenaufrufe), die Sie an Metricalp senden, wird diese custom_prop3 als „Erstbesuch des aktuellen Benutzers“ enthalten sein oder nicht.

Aber es gibt einen Haken. Wenn Sie ein JavaScript-basiertes Framework verwenden, das eine SPA-ähnliche Routing-Struktur hat (wie React, NextJS, Angular, VueJS usw.), wird der obige Code einmal innerhalb aller Sitzungen eines Benutzers ausgeführt. Bei anderen Systemen (wie PHP, purem HTML usw.) wird es einmal pro Seitenaufruf (Navigation) ausgeführt. Während die erste besuchte Seite als Erstbesuch_ever gezählt wird, wird die zweite Seite als wiederkehrender Benutzer gezählt. Aber die aktuelle Sitzung ist immer noch eine Erstbesuch_ever-Sitzung, es sei denn, der Benutzer verlässt Ihre Website vollständig und besucht sie erneut.

Um dieses Problem zu lösen, können Sie den folgenden Codeausschnitt verwenden. Es überprüft, ob der Benutzer ein Erstbesucher in der aktuellen Sitzung ist (wir werden sessionStorage zusätzlich zu localStorage verwenden). Wenn dies der Fall ist, wird die benutzerdefinierte Eigenschaft auf true gesetzt. Wenn dies nicht der Fall ist, wird die benutzerdefinierte Eigenschaft auf false gesetzt. Der Codeausschnitt lautet wie folgt:

            <script>
              const isContinueFirstSession = sessionStorage.getItem('first_session');
              const isFirstVisit = isContinueFirstSession || !localStorage.getItem('vis_bef');
              if (isFirstVisit && !isContinueFirstSession) {
                      sessionStorage.setItem('first_session', 'true')
                      localStorage.setItem('vis_bef', 'true')
              }
            
              window.metricalp = window.metricalp || {
                queue: [],
                sharedCustomProps: {
                  _global: {
                    custom_prop3: isFirstVisit
                  },
                },
                event: function (e) {
                    this.queue.push(e);
                },
              };
            </script>
            <script src="https://cdn.metricalp.com/event/metricalp.js" data-tid="YOUR_TID" async></script>
        

Nun haben wir ein weiteres Flag „isContinueFirstSession“, das bedeutet, dass diese Sitzung die erste Sitzung des Benutzers ist und sie immer noch andauert. Der Benutzer navigiert nur auf unserer Website. Wenn der Benutzer beispielsweise auf die Schaltfläche „Kaufen“ klickt und wir ein benutzerdefiniertes Ereignis für diese Aktion wie „click_buy“ erzeugen, hat dieses Ereignis auch custom_prop3 (ist Erstbesuch_ever) auf true. So können wir überprüfen, wie viele Benutzer beim ersten Besuch auf die Schaltfläche „Kaufen“ geklickt haben. Auch das Gegenteil: Wie viele Benutzer haben beim wiederholten Besuch auf die Schaltfläche „Kaufen“ geklickt. Dies kann Ihre Marketingstrategien und Ziele beeinflussen. Das ist die Schönheit von Metricalp, mit einfachen Anpassungen können Sie wertvolle Daten über Ihre Benutzer erhalten.

Aber wie Sie sehen, ist custom_prop3 schwer im Dashboard zu merken. Wir haben in Metricalp eine Funktion für benutzerdefinierte Aliase, um die Dinge leichter zu merken und zu verwalten. Während wir das isFirstVisit-Flag global (für alle Ereignisse) weitergeben, arbeiten benutzerdefinierte Aliase ereignisbasiert. Lassen Sie uns einen Alias für screen_view- und click_buy-Ereignisse für custom_prop3 definieren und ihn als „is_first_visit_ever“ benennen.

Nun haben nur diese beiden Ereignisse die Aliase und wir werden unsere benutzerdefinierte Eigenschaft als diese Aliase übergeben. Sie wird für andere Ereignisse ignoriert. (Sie können es weiterhin als custom_prop3 senden, dann funktioniert es für alle Ereignisse und ist für die definierten Aliase im Dashboard lesbarer, bleibt aber für andere Ereignisse als custom_prop3. Aber hier möchten wir es auch in der Phase der Datenübertragung an das Dashboard leserlich halten, also werden wir den Alias auch beim Senden des Ereignisses verwenden.). Lassen Sie uns unseren Codeausschnitt noch einmal aktualisieren:

  
            <script>
              const isContinueFirstSession = sessionStorage.getItem('first_session');
              const isFirstVisit = isContinueFirstSession || !localStorage.getItem('vis_bef');
              if (isFirstVisit && !isContinueFirstSession) {
                      sessionStorage.setItem('first_session', 'true')
                      localStorage.setItem('vis_bef', 'true')
              }
            
              window.metricalp = window.metricalp || {
                queue: [],
                sharedCustomProps: {
                  _global: {
                    is_first_visit_ever: isFirstVisit
                  },
                },
                event: function (e) {
                    this.queue.push(e);
                },
              };
            </script>
            <script src="https://cdn.metricalp.com/event/metricalp.js" data-tid="YOUR_TID" async></script>
        

Es ist bereit. Besuchen Sie unsere Website, klicken Sie auf die Schaltfläche „Kaufen“. Verlassen Sie unsere Website, besuchen Sie sie erneut und klicken Sie erneut auf „Kaufen“. Überprüfen Sie dann die Ereignisse und benutzerdefinierten Eigenschaften in unserem Dashboard:

Wow, wir haben es geschafft, es funktioniert und ist großartig, herzlichen Glückwunsch 🚀

Unser is_first_visit_ever-Flag funktioniert unabhängig von der Zeit (es sei denn, der Benutzer wechselt den Browser / das Gerät). Angenommen, ein Benutzer hat Ihre Website heute zum ersten Mal besucht. Wir haben das Flag is_first_visit_ever als true gesendet. Dann hat der Benutzer die Website verlassen und am selben Tag erneut besucht, und diesmal haben wir das Flag is_first_visit_ever als false gesendet. Nun, true ist 1 und false zählt auch 1 in unserem Dashboard für is_first_visit_ever. Der Benutzer hat die Seite verlassen und am selben Tag erneut besucht, wir haben das Flag is_first_visit_ever erneut als false gesendet (ab jetzt wird jeder Besuch immer false sein). Aber unser is_first_visit_ever-Prop zeigt die false-Zahl im Dashboard immer noch als 1 an, da es die einzigartige Anzahl pro Prop anzeigt. Wenn der Benutzer am nächsten Tag erneut besucht, wird es wieder nicht einzigartig sein, sodass die Anzahl nicht steigen wird. Wenn wir also den Wochenbericht in unserem Dashboard ansehen, werden die Zählungen wie 1 für true und 1 für false aussehen. Wir sehen, wie viele 'einzigartige' true und false im ausgewählten Zeitraum bereitgestellt wurden. Also zeigt der erste Besuch true, wie viele Erstbenutzer es gab, und false zeigt, wie viele einzigartige wiederkehrende Benutzer es gab, zwei sehr wertvolle Metriken, die wir leicht mit Metricalp erreicht haben 🚀