1 Webtrekk Cookies
Inhalt 2
1 Allgemein Cookies sind Textinformationen, die beim Besuch einer Webseite gesetzt werden können und daraufhin auf dem Gerät/Rechner des Besuchers gespeichert werden. Jedes Cookies ist dabei an die jeweilige Domain gebunden und kann auch nur dort ausgelesen oder bearbeitet werden, wo dieses gesetzt wurde. Dabei unterscheidet man zwischen Session- und Ever-Cookies. Ein Session-Cookie wird automatisch vom Browser entfernt, sobald die Sitzung beendet wird. Dies geschieht, sobald der Browser geschlossen wird. Im Gegensatz zu einem Session-Cookie, hat ein Ever-Cookie ein festes Ablaufdatum, an dem es vom Browser entfernt wird. Zusätzlich werden Cookie noch zwischen 1st-Party und 3rd-Party unterschieden. Der Unterschied besteht darin, dass bei 1st-Party Cookies die Webseite das Cookie setzt, welche gerade aktive besucht wird. Bei 3rd-Party Cookies werden die Cookies unter einer anderen Domain gesetzt, die ungleich der gerade aktiv besuchten Seite ist. 2 1st und 3rd Party Cookies Sie haben die Möglichkeit das Tracking mit 1st-Party oder 3rd-Party Cookies zu nutzen, standardmäßig werden 1st-Party Cookies genutzt. Die Akzeptanz von 1st-Party Cookies ist größer als die der 3rd-Party Cookies. Der Nachteil der 1st-Party Cookies ist, dass sie nur eine Domain zählen können, d.h. wenn Ihre Website auf verschiedenen Domains verteilt ist, kann kein zusammenhängender Besuch gezählt werden (z.b. www.website.com und www.websitespecial.com). Der Wechsel zwischen verschiedenen Subdomains (z.b. www1.website.com und www2.website.com) oder HTTP/HTTPS wird unterstützt. Die Einstellung 1 lässt das Tracking-Pixel 1st-Party Cookies nutzen, bei der Einstellung 3 werden 3rd-Party Cookies genutzt. Beispiel für vollständige Konfiguration: // cookie handling wt.cookie = "1"; // (3 1, 1st or 3rd party cookie) 2.1 Nutzung einer eigenen Track Domain Die Cookie Einstellung 1 (siehe Kap. 2) erzeugt die nötigen Cookies über JavaScript und setzt die Cookies als 1st-Party in der Kunden Domain. Sie haben jedoch auch die Möglichkeit, die Cookies weiterhin über Webtrekk generieren zu lassen und eine eigene Track Domain zu nutzen. Damit können dann mit der Einstellung 3 die 3
Cookies in der Kunden Domain auch bei No-Script Nutzern gesetzt und werden. Diese werden dann vom Browser als First-Party Cookies erkannt. Hinweis: Sie kauft ein Zertifikat für jede eigene Track-Domain, die Namensgebung können Sie dabei frei wählen (pixel.domain.com). Dabei akzeptiert Webtrekk, für mehrere einzelne Zertifikate unterschiedlicher Track-Domains, nicht. In diesem Fall besorgen Sie sich ein Zertifikatbundle, welches für alle Track-Domains ausgestellt wurde. Anschließend benötigen wir den Server-Key mit dem der CSR generiert wurde und das Zertifikat (ausgestellt für gängige Webserver Apache ). Stellen Sie uns diese Informationen anschließend über einen sicheren Kommunikationskanal oder in einem Passwortgeschützen Archiv zu. Danach wandeln wir das Zertifikat in das pkcs12 Fileformat um und richten die Track-Domain ein. Zusätzlich wird noch ein neuer CNAME Eintrag für die neue Track-Domain gesetzt. Sie erhalten anschließend die Information, diesen CNAME Eintrag in Ihrem DNS-System, für die neue Track-Domain zu setzten. Bei Fragen zu einer eigenen Track Domain wenden Sie sich bitte an Ihren Ansprechpartner oder senden Sie eine E-Mail an support@webtrekk.com. 3 Empfehlung Dadurch, dass der Safari und Firefox (ab Version 22) standartmäßig alle 3rd-Party Cookies blockieren, empfiehlt Webtrekk die Nutzung von 1st-Party Cookies. Wenn Sie trotz alledem domainübergreifend Daten in einen Account senden möchten, empfehlen wir folgende Plugins zu nutzen. "Cross-Domain Tracking" (siehe Kap. 5) "Cross-Domain iframe" (siehe Kap.6) Für Bestandskunden, die von 3rd-Party auf 1st-Party Cookies umstellen möchten, bieten wir zu den oben genannten Plugins zusätzlich das "Cookie-Control" Plugin (siehe Kap. 4 und 4.2.1) an. Damit können Sie z.b. die bestehende Webtrekk Ever-ID von 3rd-Party nach 1st-Party umziehen, um somit Ihre Nutzererkennung beizubehalten. 4 Cookie-Control Plugin Das Cookie-Control Plugin erlaubt Ihnen Zugriff auf die Eigenschaften der Webtrekk Cookies. Es ist möglich Cookies, 1. eine neue Tack-Domain und/oder Track-ID zuzuweisen, 2. von einem Server Cookie in ein Client Cookie (3rd-Party Cookie in 1st-Party Cookie) oder 4
3. von einem Client Cookie in ein Server Cookie (1st-Party Cookie in 3rd-Party Cookie) umzuziehen. 4.1 Integration Integrieren Sie das Plugin direkt in den Header-Tag der Seite. Hinweis: Das Plugin sollte nicht asynchron nachgeladen werden. Beispiel für eine Integration: <html> <header> </header> <body> </body> </html> <title>startseite</title> <script type="text/javascript" src="webtrekk_cookiecontrol.js"></script> Content der Seite 4.2 Konfiguration Bevor Sie das Plugin konfigurieren, passen Sie Ihre Webtrekk Pixel Konfiguration an. Wenn Sie von First- auf Third-Party Cookies umsteigen möchten, ändern Sie die Einstellung cookie="1" auf cookie="3" bzw. wenn Sie von Third- auf First-Party Cookies umsteigen, von cookie="3" auf cookie="1". Falls Sie Ihre Track-Domain und/oder Track-ID wechseln möchten, passen Sie diese im Webtrekk Pixel dementsprechend an. Nachdem Sie dies getan haben, passen Sie das Plugin an. Das Plugin bietet drei verschiedene Konfigurationsmöglichkeiten, die Cookies umzuziehen. Dabei ist bei jeder Variante die Basiskonfiguration gleich. trackid : beinhaltet Ihre aktuelle Webtrekk Track-ID trackdomain : beinhaltet Ihre aktuelle Webtrekk Track-Domain version : beinhaltet Ihre aktuelle Pixelversion path : gibt den Pfad an, in dem das Cookie gespeichert werden soll [optional] duration : gibt die Laufzeit des Cookies in Tage an [optional] action : beinhaltet die Art des Cookie Umzugs 5
Beispiel für eine vollständige Konfiguration im Plugin: var wtcc_config = { trackid : "123451234512345", trackdomain : "q3.webtrekk.net", version : 3, path : "", duration : "180", action : { action : "3->1" } }; 4.2.1 Server Cookie nach Client Cookie umziehen Bei dieser Variante wird das Cookie, das serverseitig gesetzt wurde (cookie="3") in ein Cookie konvertiert, dass clientseitig gesetzt wird (cookie="1"). Beispiel für eine vollständige Konfiguration im Plugin: var wtcc_config = { trackid : "123451234512345", trackdomain : "q3.webtrekk.net", version : 3, path : "", duration : "180", action : { action : "3->1" } }; 4.2.2 Client Cookie nach Server Cookie umziehen Bei dieser Variante wird das Cookie, das clientseitig gesetzt wurde (cookie="1") in ein Cookie konvertiert, das serverseitig gesetzt wird (cookie="3"). 6
Beispiel für eine vollständige Konfiguration im Plugin: var wtcc_config = { trackid : "123451234512345", trackdomain : "q3.webtrekk.net", version : 3, path : "", duration : "180", action : { action : "1->3" } }; 4.2.3 Server Cookie in Domain1 nach Domain2 umziehen Diese Variante ermöglicht Ihnen den Umzug der Cookies in eine neue Track-Domain und/oder Track-ID. trackid : beinhaltet Ihre neue Webtrekk Track-ID trackdomain : beinhaltet Ihre neue Webtrekk Track-Domain Beispiel für eine vollständige Konfiguration im Plugin: var wtcc_config = { trackid : "123451234512345", trackdomain : "q3.webtrekk.net", version : 3, path : "", duration : "180", action : { trackid : "543215432154321", trackdomain : "wt01.webtrekk.net", action : "3->3" } }; 4.3 Wichtige Hinweise Es können nur die Cookies von Nutzern konvertiert werden, die die Website auch besuchen. Das Cookie-Control Plugin erzeugt pro Besuch mindestens einen zusätzlichen Request an das Webtrekk Tracking System. 7
Das Plugin darf nur für eine mit Webtrekk abgestimmte Laufzeit in der Website eingebunden werden und muss nach Ablauf unverzüglich wieder ausgebaut werden. Die genaue Laufzeit stimmen Sie bitte mit dem technischen Support ab. Das Plugin muss auf allen potentiellen Einstiegsseiten eingebaut werden. 5 Cross-Domain Tracking Plugin Dieses Plugin ermöglicht Ihnen das Übernehmen der Webtrekk Ever-ID einer anderen Domain. Hierbei wird auf allen Seiten an die URL jedes Links, der auf die domainfremde URL zeigt, die Webtrekk Ever-ID als Parameter angehangen. Sobald ein Nutzer auf einen dieser Links klickt, wird auf der Folgeseite die Ever-ID aus der URL ausgelesen und die Webtrekk Ever-ID übernommen. Um das Plugin nutzen zu können, müssen Sie 1st-Party- Cookies nutzen (webtrekk.cookie="1"). Hinweis: Das Plugin sollte nicht asynchron nachgeladen werden. Nutzen Sie dieses Plugin nur, wenn Ihre anderen Domains ausschließlich über Ihre Hauptdomain zu erreichen sind, d.h. das Plugin arbeitet nur in eine Richtung ordnungsgemäß. Beispiel: Sie besitzen domain-a, domain-b und domain-c, wobei domain-a Ihre Hauptdomain ist. Domain-b und domain-c sind ausschließlich nur über domain-a zu erreichen. Sobald dann ein Nutzer von domain-a auf domain-b oder domain-c (über einen Link wechselt), wird auf der jeweiligen Fremddomain die Ever-ID übernommen. Wenn aber auf domain-b eingestiegen werden kann, funktioniert das Plugin nicht mehr einwandfrei, weil auf domain-a und domain-b verschiedene Ever-IDs existieren können. Wenn dann zwischen domain-a und domain-b gewechselt wird, wird die Ever-ID auf der jeweiligen Domain überschrieben und Sie haben keine eindeutige Nutzererkennung mehr. 5.1 Integration Integrieren Sie das Plugin auf Ihrer Hauptdomain direkt vor dem schießenden Body-Tag, damit auch alle Links ordnungsgemäß markiert werden können. Auf allen Fremddomains sollte das Plugin vor dem Webtrekk Pixel integriert werden. 8
Beispiel für eine Integration: <html> <header> <title>startseite</title> </header> <body> <!-- Integration auf den Fremddomains --> <script type="text/javascript" src="webtrekk_crossdomaintracking.js"></script> Content der Seite <!-- Integration auf der Hauptdomain --> <script type="text/javascript" src="webtrekk_crossdomaintracking.js"></script> </body> </html> 5.2 Konfiguration In dem Konfigurationsobjekt wtcdt_config befinden sich drei Variablen, die Sie bitte wie folgt Konfigurieren müssen. trackid : beinhaltet Ihre Webtrekk Track-ID version : beinhaltet Ihre aktuelle Pixelversion domain : beinhaltet die Domainnamen der Folgeseiten als regulären Ausdruck Beispiel für eine vollständige Konfiguration im Plugin: var wtcdt_config = { trackid : "123451234512345", version : 3, domain : new RegExp("/domain-b\\.com domain-c\\.com/") }; 6 Cross-Domain iframe Plugin Durch den Einsatz eines iframes ist es möglich, auch beim Einsatz von 1st-Party Tracking Webseitenbesucher Domainübergreifend zu erkennen. 9
Das Skript übernimmt die in Webtrekk für die Nutzererkennung notwendige Ever-Id von einer anderen Domain. Auf allen potentiellen Einstiegsseiten sollte dazu das Skript eingebunden. Dieses lädt dann per iframe die gewünschten Seiten nach und holt sich die Ever-Id, die dort ggf. bei einem früheren Besuch gesetzt wurde. Um das Plugin nutzen zu können, müssen Sie 1st-Party-Cookies nutzen (webtrekk.cookie="1"). Hinweis: Das Plugin sollte nicht asynchron nachgeladen werden. Beispiel: Sie besitzen domain-a, domain-b und domain-c. Sobald ein Nutzer auf domain-a einsteigt, werden die jeweiligen Domains domain-b und domain-c als iframe nachgeladen. Diese werden dann angefragt, ob ggf. eine Ever-Id existiert. Wenn dies der Fall ist, gibt das iframe die Ever-Id an die Hauptseite weiter und wird dort dann 1st-Partyseitig gesetzt. Existiert noch keine Ever-Id, übernimmt das Webtrekk Pixel den Teil und setzt selber eine Ever-Id. Sobald jetzt der Nutzer(der vorher die Seite domain-a besucht hatte) domain-b besucht, werden dort domain-a und domain-c nachgeladen. Da der Nutzer vorher domain-a besucht hatte, existiert dort die Ever-Id, die somit an die domain-b weitergegeben wird und dort 1st-Partyseitig gesetzt wird. Das gleiche würde auch bei domain-c passieren. 6.1 Integration Das Skript muss auf allen potentiellen Einstiegsseiten eingebunden werden und vor dem Webtrekk Pixel integriert werden. Auf allen iframe Seiten sollte bestmöglich kein Content enthalten sein, damit die Seite so schnell wie möglich geladen werden kann. Ein Webtrekk Pixel ist auf den Seiten auch nicht vonnöten. Es reicht lediglich das Script in die Seite zu integrieren und zu konfigurieren. Das iframe wird entsprechend der eingetragenen URLs nachgeladen. Beispiel für eine Integration im iframe: <html> <header></header> <body> <script type="text/javascript" src="webtrekk_crossdomainiframe.js"></script> </body> </html> 10
Beispiel für eine Integration auf der Seite: <html> <header> <title>startseite</title> </header> <body> <script type="text/javascript" src="webtrekk_crossdomainiframe.js"></script> Content <script type="text/javascript" src="webtrekk_v3.js"></script> </body> </html> 6.2 Konfiguration In dem Script befindet sich das Konfigurationsobjekt wtcdi_config, in dem Sie Ihre Basisinformationen hinterlegen müssen: url : alle URLs, die als iframe nachgeladen werden sollen version : beinhaltet Ihre aktuelle Pixelversion trackid : Webtrekk-TrackId der jeweiligen Domain Beispiel für eine vollständige Konfiguration im Plugin: var wtcdi_config = { url : [ "www.domian-a.com/iframe.html", "www.domian-a.com.ng/iframe.html", "www.domain-b.com/iframe.html", "track.domain-c.fr/iframe.html", "www.domain-d.com.br/iframe.html", "www.domain-e.de/iframe.html" ], version : 3, trackid : "123451234512345" }; 11
7 Kontakt Wenn Sie Fragen zur Einrichtung haben sollten, stehen wir Ihnen selbstverständlich zur Verfügung. Für priorisierten Support oder umfassendere Beratung bietet Webtrekk Support- und Consultingpakete an. Sprechen Sie uns an, wir unterbreiten Ihnen gerne ein individuelles Angebot. Webtrekk GmbH Hannoversche Straße 19 10115 Berlin fon 030-755 415-0 fax 030-755 415-100 support@webtrekk.com http://www.webtrekk.com 12