Benutzerdefinierte Domainkonfiguration

Dieser Artikel richtet sich an Entwickler, die serverseitiges Tagging im selben selbst erhobenen Kontext wie ihre Website hosten möchten. Die Bereitstellung am selben Ursprung ist eine Best Practice, mit der Sie von der Sicherheit und Langlebigkeit serverseitiger Cookies profitieren können. Die folgende Anleitung gilt für die Einrichtung des Server-Auslieferungsmechanismus für denselben Ursprung unabhängig davon, welches Google-Tag auf Ihrer Website implementiert ist (gtag.js oder gtm.js).

Wenn Sie einen Tagging-Server zum ersten Mal einrichten, wird er auf einer vom Cloud-Anbieter bereitgestellten Domain gehostet. Wenn Sie den Standardendpunkt verwenden, werden Daten an den Servercontainer gesendet, aber in einem Drittanbieterkontext ausgeführt. Damit Sie die Vorteile von selbst erhobenen Daten nutzen können, z. B. langlebigere Cookies, müssen Ihr Tagging-Server und Ihre Website in derselben Domain ausgeführt werden.

In der folgenden Tabelle wird veranschaulicht, wie Sie einen Tagging-Server hosten, wenn die übergeordnete Website auf www.example.com gehostet wird:

	Selbe Quelle (Best Practice)	Subdomain	Standarddomain
Beispiel-URL	https://www.example.com/metrics	https://metrics.example.com	https://metrics.run.app
Zugriff auf serverseitig festgelegte Cookies	Vollständiger Zugriff auf die Vorteile in Bezug auf Sicherheit und Langlebigkeit.	Vollständiger Zugriff auf die Vorteile in Bezug auf Sicherheit und Langlebigkeit.	Keine. Es können nur JavaScript-Cookies gesetzt werden.
Komplexität der Einrichtung	Konfigurieren Sie ein CDN oder einen Load Balancer, um Anfragen weiterzuleiten. Möglicherweise müssen die DNS-Einträge aktualisiert werden.	Aktualisieren Sie die DNS-Einträge.	Sie ist vorkonfiguriert.

Wählen Sie zuerst eine Implementierungsoption aus.

Subdomain Gleicher Ursprung

Vorbereitung

In diesem Leitfaden wird Folgendes vorausgesetzt:

• Servercontainer in Tag Manager einrichten
• Tagging-Server einrichten
• Ein CDN oder Load Balancer, der Anfragen weiterleiten kann.
• Wenn Sie die App Engine verwenden: Auf dem Tagging-Server muss Version 2.2.0 oder höher ausgeführt werden. Migrieren Sie zu Cloud Run, um Ihren Tagging-Server zukunftssicher zu machen.

Benutzerdefinierte Domain konfigurieren

Sie können Ihren Servercontainer so einrichten, dass er auf einem Pfad derselben Domain wie Ihre Website ausgeführt wird. Wenn Ihre Website-URL beispielsweise www.example.com ist, reservieren Sie für Ihren Servercontainer einen Pfad wie www.example.com/metrics.

1. Wählen Sie einen Pfad Ihrer Domain für den Tagging-Server aus.

Dieser Pfad wird für diese Implementierung der Auslieferung von selbst erhobenen Daten reserviert. Achten Sie darauf, dass Sie einen Pfad auswählen, der noch nicht verwendet wird.

Beispiele für Pfade, die Sie verwenden können: /collect, /metrics, /data

Notieren Sie sich diesen Pfadstring. Sie verwenden sie in den folgenden Schritten anstelle von /metrics, wenn Folgendes angezeigt wird: /metrics

Achtung :Bei dieser Einrichtungsmethode wird der gesamte Traffic, der mit dem ausgewählten Pfad vorangestellt ist, an den Tagging-Server weitergeleitet. Wählen Sie einen nicht verwendeten Pfad aus, um den Traffic auf Ihrer Website nicht zu beeinträchtigen. Der Pfad darf /gtm nicht enthalten.

2. Traffic an den Tagging-Server weiterleiten

Wenn bereits ein CDN oder Load Balancer für Ihre Website eingerichtet ist, der das Routing von Traffic nach Pfaden unterstützt, fahren Sie mit Schritt 4 fort.

1. Legen Sie einen Ursprung oder ein Backend fest, der bzw. das auf Ihre Website verweist.
2. Überschreiben Sie den Host-Header mit dem Hostnamen der Website, z. B. example.com.
3. Lassen Sie zu, dass alle Cookies und Abfragestrings weitergeleitet werden. Wenn diese Option für die Plattform nicht verfügbar ist, erfolgt die Weiterleitung wahrscheinlich standardmäßig.
4. Fügen Sie einen weiteren Ursprung oder ein weiteres Backend hinzu, der bzw. das auf den Tagging-Server verweist. Das kann die vom Cloud-Anbieter bereitgestellte Domain sein, z. B. metrics.run.app
5. Überschreiben Sie den Host-Header so, dass er der oben angegebenen Domain entspricht. Lassen Sie zu, dass alle Cookies und Abfragestrings weitergeleitet werden.
6. Legen Sie eine Pfadregel wie /metrics/* fest, damit der Traffic an den Tagging-Server weitergeleitet wird.
7. Konfigurieren Sie den reservierten Pfad für das serverseitige Tagging so, dass er eine höhere Priorität hat als die Standardregel.
8. Aktualisieren Sie Ihr DNS so, dass es auf das CDN oder den Load Balancer verweist, sofern noch nicht geschehen. Es kann einige Zeit dauern, bis die DNS-Änderungen übernommen werden.
9. Rufen Sie den Endpunkt /healthy in der Domain auf, die Sie gerade eingerichtet haben, z. B. https://example.com/metrics/healthy. Es sollte ok angezeigt werden.

3. Server-URL in Google Tag Manager aktualisieren

Sie müssen die Konfiguration des Servercontainers aktualisieren, damit das Pfadpräfix erkannt und Anfragen richtig verarbeitet werden können.

So aktualisieren Sie auf den neuen Endpunkt:

1. Öffnen Sie Google Tag Manager.
2. Öffnen Sie den Servercontainer, der mit derselben Quelle wie die Website eingerichtet ist.
3. Entfernen Sie auf dem Tab Verwaltung > Containereinstellungen alle vorherigen URLs. Dies ist erforderlich, da alle Servercontainer-URLs denselben Pfad haben müssen.
4. Klicken Sie auf URL hinzufügen und geben Sie die URL einschließlich des Pfadpräfixes ein.
5. Speichern und zum Arbeitsbereich zurückkehren
6. Klicken Sie auf die Schaltfläche Vorschau, um eine neue Debug-Sitzung zu starten und eine Anfrage in einem separaten Tab zu senden.
7. Klicken Sie auf die gesendete Anfrage. Prüfen Sie, ob Ihr Kunde die eingehende Anfrage beansprucht hat.

Häufig auftretende Probleme beheben

1. In der Vorschau werden keine eingehenden Anfragen angezeigt
   1. Rufen Sie den Log Explorer Ihres Cloud-Projekts auf. Prüfen Sie, ob die Bereitstellung des serverseitigen Taggings Traffic empfängt. Ist das nicht der Fall, folge der Anleitung unter Schritt 1.
   2. Prüfen Sie, ob das CDN oder der Load Balancer Cookies weiterleitet.
   3. Prüfen Sie, ob Sie einen einzelnen Vorschauserver haben und ob die Tagging-Server PREVIEW_SERVER_URL festgelegt haben.
   4. Prüfen Sie, ob der Vorschauserver ausgeführt wird, indem Sie auf PREVIEW_SERVER_URL + /healthy klicken. Es sollte ok angezeigt werden.
2. Clients beanspruchen keine Anfragen: Aktualisieren Sie die URL in den Containereinstellungen, um den reservierten Pfad zu verwenden. Wenn die URL den Pfad nicht enthält oder sich von ihm unterscheidet, funktionieren die Clients nicht richtig.