Zum Hauptinhalt springen

Integrationsoptionen

Optionen bei der Integration​

Bei der Integration können noch verschiedene Verhaltensweisen definiert werden, um WebCare noch besser auf Ihren Webauftritt abzustimmen.

Unter bestimmten Umständen kann es nötig sein, den Link zur Datenschutzerklärung dynamisch zur Laufzeit zu ändern. Dies kann man in der HTML - Integration mit folgendem Code bewirken:

<link href="https://webcache.datareporter.eu/c/xxx/banner.css" rel="stylesheet">
<script src="https://webcache.datareporter.eu/c/xxxx/banner.js" type="text/javascript" charset="utf-8"></script>
<script>
  dr_cookiebanner_options.privacyLinkUrl = "https://www.cookiebanner.at";
  window.cookieconsent.initialise(dr_cookiebanner_options);
</script>

In diesem Beispiel wird die Url "https://www.cookiebanner.at" geöffnet, sobald im Cookie Banner auf die Datenschutzerklärung geklickt wird.

URL Parameter für WebCare​

Die Einwilligung über URL Parameter vorgeben​

In bestimmten Situationen kann es nötig sein, die Einwilligung des Benutzers vorzugeben. Zum Beispiel, wenn man die Einwilligung in einen iFrame auf der Seite übergeben will oder ein Tool für Screenshots einsetzt und man nicht will, dass der Banner auf den Bildern erscheint.

Dies erreicht man durch die Übergabe des Parameters __drconsent (2x Underscore am Anfang)

Folgende Werte sind erlaubt:

__drconsent=allow - entspricht dem Klick auf "Alles Erlauben"

__drconsent=deny - entspricht dem Klick auf "Nur technisch notwendiges erlauben"

__drconsent=tpsmu - einzelne Kategorien erlauben:

Der Parameter kann sich beliebig aus folgenden Zeichen zusammensetzen:

  • t = Technisch notwendiges erlauben
  • p = Benutzereinstellungen erlauben
  • s = Statistik erlauben
  • m = Marketing erlauben
  • u = Unkategorisierte erlauben

Also zb __drconsent=tps würde nur technisch Notwendiges, Benutzereinstellungen und Statistik erlauben.

Beispiele​

https://www.datareporter.eu?__drconsent=allow

https://www.datareporter.eu?__drconsent=deny

https://www.datareporter.eu?__drconsent=tpm

Wenn Sie beim Laden der Webseite oder beim Linken auf andere Seiten den aktuellen Einwilligungsstatus als Parameter anhängen wollen, bieten wir Ihnen eine Hilfsfunktion die das erledigen kann:

let filteredUrl = dr_filterUrlAddConsent("url");

Sie müssen dazu nur eine URL als String übergeben, alle Pfade und Parameter werden dabei erhalten.

Falls du einen (etwa für Cross Domain Tracking) einen zusätzlichen Parameter an den Link anhängen musst, kannst du den als zweiten Parameter optional an die Funktion anfügen - das wird dann an die URL angehängt:

let filteredUrl = dr_filterUrlAddConsent("url", "_ga=test123");

Beispiele​

console.log(dr_filterUrlAddConsent("https://www.datareporter.eu"));
// ergibt z.B.: "https://www.datareporter.eu?__drconsent=p"

console.log(dr_filterUrlAddConsent("https://www.datareporter.eu/pfad?test=1"));
// ergibt z.B.: "https://www.datareporter.eu/pfad?test=1&__drconsent=allow"

Wobei jedesmal der aktuelle Einwilligungsstatus angehängt wird.

Debug - Modus zur Fehlersuche aktivieren​

Falls unerklärliche Fehler auftreten, können Sie den Debug - Modus für WebCare aktivieren.

Das können Sie temporär für einen Aufruf machen, indem Sie folgenden URL Parameter angeben:

https://www.datareporter.eu/?_webcare_debug=true

Dann werden in der Browserkonsole erweiterte Logs angezeigt, die bei der Lösung Ihres Problems helfen können.

Sie können diesen Modus aber auch permanent aktivieren:

<link href="https://webcache.datareporter.eu/c/xxx/banner.css" rel="stylesheet">
<script src="https://webcache.datareporter.eu/c/xxxx/banner.js" type="text/javascript" charset="utf-8"></script>
<script>
  dr_cookiebanner_options.debugLogActive = true;
  window.cookieconsent.initialise(dr_cookiebanner_options);
</script>

Loader Integration: Warten (Zeitspanne oder Manuell)​

Falls der Banner nicht sofort geladen werden soll, sondern erst nach einer Zeitspanne oder nach einem Signal von der Webseite, so kann man folgende Integration verwenden:

<script src="https://webcachex-eu.datareporter.eu/loader/v5/cmp-load.js?url=INTEGRATION_ID&wait=WAIT_MODE" defer ></script>

Bitte das "v5" im Pfad nach "/loader/" beachten

INTEGRATION_ID ist dabei die WebCare Integration ID für den Loader wie im Integration Wizard ersichtlich.

Der Parameter WAIT_MODE kann dabei folgende Werte annehmen:

manual: Warten auf ein Signal von der Webseite. Ein Aufruf von window.drShowWebCareBanner() zeigt den Banner dann an.

Zeitspanne in Millisekunden: Wartet X Millisekunden bevor der Banner angezeigt wird. Ein Wert von "2000" würde dabei 2 Sekunden warten.

Beispiele​

3 Sekunden warten*

<script src="https://webcachex-eu.datareporter.eu/loader/v5/cmp-load.js?url=05d2cb1b-6c7f-449e-927d-af52f153233b.musterGroup.Kg&wait=3000" defer ></script>

Auf Signal von der Webseite warten*

<script src="https://webcachex-eu.datareporter.eu/loader/v5/cmp-load.js?url=05d2cb1b-6c7f-449e-927d-af52f153233b.musterGroup.Kg&wait=manual" defer ></script>
...
<a href="javascript:window.drShowWebCareBanner()">Show Banner </a>