matelso logo 2022 brand
matelso logo 2022 brand
View Categories

Manueller Scan – matelso script mit Single-page applications und AJAX requests

2 min read

Das matelso Script durchsucht, beziehungsweise scant den Inhalt einer Webseite automatisch nach den eingestellten Suchtexten um diese dann mit einer Call Tracking Rufnummern zu ersetzen. Diese automatische Suche kann ergänzt oder vollständig ersetzt werden, wenn die entsprechenden Stellen im HTML der Code für das matelso Script markiert werden.
Die Funktion nennt sich bei uns “manueller Scan” und wird über einen JavaScript-Code ausgeführt.
Die Funktion kann genutzt werden, um die Performance auf der Seite zu verbessern, wenn dafür der automatische Scan vollständig ausgeschaltet wird. Die Option dazu finden Sie im Control Panel bei den Domain Einstellungen:

In manchen Fällen ist die Funktion auch notwendig, damit überhaupt ein Austausch der Nummer stattfindet.

 

Single-page applications und AJAX requests #

Eine Besonderheit von Webanwendungen und Seiten mit AJAX-Anfragen ist, dass sie zusätzliche Elemente laden, nachdem die Seite selbst eigentlich fertig geladen ist. Das führt dazu, dass die Tracking-Bibliothek nicht unabhängig erkennen kann, dass zusätzliche Seitenelemente geladen wurden. Damit Telefonnummern in den geladenen Elementen ersetzt werden können, müssen Sie die Tracking-Bibliothek mithilfe des manuellen Scans anweisen, die Seite erneut zu durchsuchen, sobald alle Elemente geladen sind.

 

Wie man den manuellen Scan ausführt #

Sie können dies tun, indem Sie den folgenden JavaScript-Code nach der erfolgreichen Ausführung der AJAX-Anfrage ausführen. Alternativ kann man auch einen anderen Trigger festlegen, wann dieses Script aktiviert werden soll.

MANUAL SCAN:
// Test ob die Tracking-Bibliothek schon geladen ist
if (mtls.loaded) {
// ausführen des Webseitenscans
mtls.scan();
}

 

Wenn Sie genau wissen, welches DOM-Element geladen wurde, können Sie es auch an die Scan-Funktion übergeben.

Dadurch wird die Laufzeit der Suchfunktion verkürzt.

SCAN WITH ELEMENT
mtls.scan(window.document.getElementById('id_des_geladenen_elements'));

 

Der Einsatz des manuellen Scans ersetzt nicht das matelso Script oder die S&R Konfiguration. Beides muss nach wie vor für die Webseite eingerichtet sein. Es ersetzt oder ergänzt nur die Script Scanfunktion nach den eingerichteten Suchtexten.