Um die Funktionalität von schlau.io herzustellen, muss zunächst die Website Intergration erfolgen. Diese beinhaltet die Implementierung des Global Site Tags, die Definition von Ereignissen sowie die Etablierung des Opt-out Prozesses. Optional kann zudem ein Opt-In Prozess etabliert werden.
Das Global Site Tag sollte zwischen den <head></head> Tags jeder Seite deiner Website eingefügt werden. Du musst das Global Site Tag nur einmal implementieren, auch wenn du mehrere Ereignisse erfassen möchtest. Wenn das Global Site Tag korrekt implementiert ist, werden Zugriffe mit den Parametern gclid (Google Ads) und msclkid (Microsoft Advertising) automatisch als Klicks erfasst.
<!DOCTYPE html>
<html>
<head>
...
<script src="https://app.schlau.io/api/js/gst/XXXXXXXXXXX.js" async></script>
</head>
<body>
...
</body>
</html>Bitte beachte, dass das obige Beispiel nicht das spezifische Global Site Tag für dein Projekt verwendet. Um Fehler zu vermeiden, musst du das zu deinem Projekt gehörende Global Site Tag auf deiner Website implementieren. Du kannst das richtige Global Site Tag abrufen, wenn du das entsprechende Projekt öffnest.
Bezüglich der Einbindung externer Skripte bestehen unterschiedliche Auffassungen zur Datenschutzkonformität. Um auch nach strenger Auffassung eine Konformität zu ermöglichen, besteht die Möglichkeit, das Global Site Tag selbst zu hosten. Wenn du das Global Site Tag selbst hosten möchtest, kannst du das zu deinem Projekt gehörige JavaScript-Snippet direkt in der schlau.io-Projektansicht herunterladen.
Auch wenn du das Global Site Tag selbst hostest, werden bei der Erfassung von Klicks und Ereignissen die IP-Adressen deiner Nutzer an schlau.io übergeben. Diese Übergabe der IP-Adressen kann, je nach Auffassung, als datenschutzrechtlich problematisch eingestuft werden. Um diese Problematik zu adressieren, steht das PHP Proxy Script zur Verfügung. Wenn du das PHP Proxy Script einsetzt, wird eine Übergabe der IP-Adressen deiner Nutzer an schlau.io konsequent vermieden.
Um das PHP Proxy Script einzusetzen, musst du es im ersten Schritt herunterladen und anschließend unter einer beliebigen öffentlich verfügbaren URL bereitstellen.
Damit das PHP Proxy Script auch tatsächlich verwendet wird, benötigst du im zweiten Schritt ein entsprechend modifiziertes Global Site Tag. Um das modifizierte Global Site Tag herunterzuladen, gib bitte deine Projektnummer, die du dem jeweiligen schlau.io-Projekt entnehmen kannst, und die URL, unter der du das PHP Proxy Script bereitgestellt hast, an.
Ereignisse können frei definiert werden, aber du solltest nur Ereignisse definieren, die du auch als Conversion in deinen Werbekonten importieren möchtest und jedes Ereignis muss einen Namen, einen Wert und eine Währung haben. Das folgende Beispiel zeigt ein Ereignis mit dem Namen purchase, einem Wert von 1250.00 und der Währung EUR:
<script>
window['schlau_io'] = window['schlau_io'] || [];
window['schlau_io'].push({
type: 'event',
event: {
name: 'purchase',
value: 1250.00,
currency: 'EUR'
}
});
</script>Wenn eine Unterscheidung des Werts verschiedener Ereignisse nicht relevant ist, kann einfach der Wert 1 bei jedem Event verwendet werden. Selbstverständlich kann das Ereignis Teil einer Funktion oder Methode sein und bei Bedarf ausgelöst werden. Das folgende Beispiel zeigt ein Ereignis mit dem Namen lead, einem Wert von 1 und der Währung USD, das Teil einer Funktion ist, die ausgelöst wird, wenn ein Klick auf einen Button mit der id example-button erfolgt.
<script>
function triggerLeadEvent() {
window['schlau_io'] = window['schlau_io'] || [];
window['schlau_io'].push({
type: 'event',
event: {
name: 'lead',
value: 1,
currency: 'USD'
}
});
}
document.getElementById('example-button').addEventListener('click', () => {
triggerLeadEvent();
});
</script>Bitte beachte, dass du die Namen der Ereignisse sorgfältig wählen solltest, da der Name des Ereignisses mit dem Namen der Conversion in den Werbekonten übereinstimmen muss, wenn du ein Ereignis als Conversion importieren möchtest. Wie du die Ereignisse benennen, bleibt dir überlassen, im einfachsten Fall kannst du allen Ereignissen den gleichen Namen geben. Natürlich kannst du den Wert und die Währung eines Ereignisses dynamisch setzen und der Wert und die Währung können unabhängig von der gleichen Bezeichnung eines Ereignisses unterschiedlich sein.
Es ist notwendig, dem Nutzer die Möglichkeit zu geben, der Erfassung durch schlau.io zu widersprechen. Der einfachste Weg die Opt-out Möglichkeit zu implementieren ist es, einen Link mit dem Parameter schlau_io_opt_out=true bereitzustellen.
<a href="./?schlau_io_opt_out=true">Opt-out</a>Wenn ein Nutzer einen Link mit dem benannten Parameter aufruft, wird der User mit einem JavaScript Alert über den erfolgten Opt-out informiert, ein technisch notwendiger Cookie mit den Namen schlau_io_opt_out und dem Wert true gesetzt und ein möglicherweise vorhandener Opt-in Cookie gelöscht. Solange der benannte Opt-out Cookie gesetzt ist, erfolgt keine Erfassung des Nutzer durch schlau.io.
Alternativ kannst du schlau.io auch programmatisch über einen getätigten Opt-out informieren. Bitte beachte, dass in diesem Fall der Nutzer nicht mit einem JavaScript Alert informiert wird. Das gibt dir die Möglichkeiten, eine eigene Rückmeldung an den Nutzer zu etablieren.
<script>
window['schlau_io'] = window['schlau_io'] || [];
window['schlau_io'].push({
type: 'optOut'
});
</script>Auch wenn es nicht viele sinnvolle Anwendungsfälle gibt, wollen wir dir nicht verschweigen, dass es möglich ist, einen Opt-out zurückzuziehen. Sobald ein Opt-out zurückgezogen ist, wird der Cookie mit den Namen schlau_io_opt_out gelöscht und die Erfassung des Nutzers wieder aufgenommen.
<script>
window['schlau_io'] = window['schlau_io'] || [];
window['schlau_io'].push({
type: 'revokeOptOut'
});
</script>Auch wenn schlau.io drauf ausgelegt ist, Conversions auch ohne Zustimmung des Nutzers zu tracken, kannst du eine erfolgte Zustimmung mitteilen. In diesem Fall wird ein Cookie mit den Namen schlau_io_opt_in und einem nutzerspezifischen Hashwert gesetzt gesetzt, mit dessen Hilfe die Erkennung wiederkehrender Zugriffe optimiert wird.
<script>
window['schlau_io'] = window['schlau_io'] || [];
window['schlau_io'].push({
type: 'optIn'
});
</script>Sollte der Nutzer seine Zustimmung zurückziehen, solltest du schlau.io entsprechend informieren. In diesem Fall wird der Cookie mit den Namen schlau_io_opt_in umgehend gelöscht.
<script>
window['schlau_io'] = window['schlau_io'] || [];
window['schlau_io'].push({
type: 'revokeOptIn'
});
</script>Bitte beachte, dass du die Opt-in Möglichkeit nicht nutzen solltest, wenn du ein Cross-Domain Tracking etablieren möchtest, da Cookies nicht domainübergreifend gesetzt und ausgelesen werden können und daher die Implementierung der Opt-in Option im Rahmen eines Cross-Domain Trackings zu fehlerhaften Daten führen würde.