Wie kann ich eine Call-Tracking-Rufnummer in einer Single-Page-Application abrufen?

Da in einer Single Page Application (SPA) nicht der gesamte Content beim Laden der Seite vorhanden ist, muss das matelso Script erweitert werden, um vollständiges Call-Tracking zu implementieren.

Hierzu bietet das Matelso Script zwei Funktionen an. Beide dieser Methoden können unabhängig und auch zusammen miteinander verwendet werden. In beiden Fällen sollten sie nach dem laden von dynamischen Content aufgerufen werden.

Die erste Methode ist der manuelle Scan. Mit dem manuellen Scan wird der Austausch der Rufnummern erneut angestoßen. Mehr Informationen zum manuellen Scan

Die zweite Methode ist "getNumberBySearchtext". Die Nutzung dieser Methode wird im folgenden genauer beschrieben.

Wie verwende ich die Methode "getNumberBySearchtext"?

Um die Methode "getNumberBySearchtext" nutzen zu können muss das Matelso Script auf der Seite verbaut sein und zusätzlich muss ich eine Callback-Methode definieren. Diese Callback-Methode wird vom Matelso Script aufgerufen sobald die Call-Tracking-Rufnummer verfügbar ist. Sollte beim Abrufen der Rufnummer ein Fehler auftreten, wird die Fehlermeldung an die Callback-Methode übergeben.  

Es werden zwei Parameter an die Callback-Methode übergeben:

  • numberObject: Dieses Objekt enthält die Call-Tracking-Rufnummer in unterschiedlichen Formaten. (e164, nach CP-Konfiguration formatiert und als Tel-Link)
  • errorString: Ein Text der die Fehlermeldung enthält, sollte ein Fehler aufgetreten sein.

Ein Beispiel für diese Callback-Methode sieht wie folgt aus:

var callback = function(numberObject, errorString){
    if(!numberObject){
      console.log('getNumberBySearchtext failed:', errorString);
        return;
    }
    // Do something with the number here
}

In diesem Beispiel fehlt die Logik um die Call-Tracking-Rufnummer auf der Website zu platzieren. Dies muss bei der Implementierung selbst gemacht werden.

Sobald diese beiden Voraussetzungen erfüllt sind, kann die Methode mit folgendem Snippet aufgerufen werden:

window[window.CallTrackingObject]("getNumberBySearchtext", "{SUCHTEXT}", callback);

In diesem Snippet wird {SUCHTEXT} als Platzhalter verwendet und muss durch den Suchtext, für den eine Call-Tracking-Rufnummer abgerufen werden soll, ersetzt werden.