Privaten Vorschauserver einrichten

Dieser Leitfaden richtet sich an Entwickler, die Cloud Run für serverseitiges Tagging verwenden und einen privaten Vorschauserver einrichten möchten.

Beim serverseitigen Tagging können Sie sich eine Vorschau von Tagging-Änderungen im Vorschau- und Debug-Modus ansehen, bevor Sie sie anwenden. Dies ist ein wichtiger Teil des Entwicklungsworkflows, damit deine Tags wie vorgesehen funktionieren. Zum Aktivieren dieser Funktion sind zwei Cloud Run-Bereitstellungen erforderlich: eines für einen Tagging-Server und eine für einen Vorschauserver. Dieser Leitfaden enthält weitere Informationen zur Kommunikation der beiden Server und zur Konfiguration in einer Unternehmensumgebung.

Überblick

Wenn Sie serverseitiges Tagging in Cloud Run bereitstellen, können Sie es mit oder ohne Load-Balancer bereitstellen. Für multiregionale Bereitstellungen benötigen Sie einen Load-Balancer, der den Traffic zur nächsten Instanz weiterleitet.

Ohne Load-Balancer

Abbildung 1: Bereitstellung ohne Load-Balancer

Mit Load-Balancer

Abbildung 2: Bereitstellung mit einem Load-Balancer

In beiden Bereitstellungen ist der Einstiegspunkt für den Vorschauserver und die Tagging-Umgebung für die Produktionsumgebung dieselbe URL (z. B. sgtm.example.com). Der Tagging-Server wird mit einer Umgebungsvariable namens PREVIEW_SERVER_URL bereitgestellt, die die URL des Vorschauservers darstellt.

Wenn Sie tagmanager.google.com aufrufen und den Vorschaumodus öffnen, ruft Tag Manager sgtm.example.com?id=[gtm_server_id]&gtm_auth=[auth_id]&gtm_preview=[env_id] auf und setzt ein Cookie. Wenn Sie dann denselben Browser verwenden, um die Zielwebsite zu erkunden, wird das Cookie auch bei Anfragen, die an sgtm.example.com gesendet werden, weitergeleitet. Aufgrund des Cookies erkennt der Tagging-Server, dass es sich um Ihre Ereignisse handelt, und leitet sie daher nur an den Vorschauserver weiter, damit Sie sie ansehen und Fehler beheben können.

Der Tagging-Server leitet diese Ereignisse weiter, indem er HTTP-Anfragen an die URL sendet, die in der Umgebungsvariablen PREVIEW_SERVER_URL festgelegt ist.

Öffentliche Vorschauserver

Für dieses Standardverhalten muss der Vorschauserver öffentlich sein. Dies ist jedoch für einige Organisationen problematisch, da sie Einschränkungen hinsichtlich der öffentlichen Infrastruktur haben und in der Regel zusätzliche Sicherheitsmaßnahmen über einen Load-Balancer erzwingen. Ein Load-Balancer bietet Ihnen Folgendes:

• Mehr Kontrolle über Funktionen wie SSL-Richtlinien, um Chiffresammlungen einzuschränken.
• Native Einbindung in Cloud Armor für Web Application Firewall (WAF) oder Distributed Denial of Service (DDoS).
• Erweiterte Funktionen zur Traffic-Verwaltung

Vorschauserver über einen Load-Balancer weiterleiten

Wenn Sie einen privaten Vorschauserver erstellen möchten, verwenden Sie hostbasiertes Routing über den Load-Balancer mit einer zusätzlichen Subdomain. Im weiteren Verlauf dieser Anleitung wird erläutert, wie Sie Ihren Vorschauserver durch einen Load-Balancer leiten.

Voraussetzungen

• Der Tagging-Server wird in Cloud Run hinter einem Load-Balancer bereitgestellt.
• Zugriff auf das Google Cloud-Projekt.
• Zugriff auf eine neue Subdomain für den Vorschauserver, zum Beispiel preview.sgtm.example.com.

Schritt 1: Umgebungsvariable mit einer neuen Subdomain aktualisieren

Wenn Sie die neue Vorschauserverdomain verwenden möchten, aktualisieren Sie die Serverumgebungsvariable PREVIEW_SERVER_URL für das serverseitige Tagging:

1. Öffnen Sie Cloud Run.
2. Wählen Sie den Tagging-Server aus.
3. Klicken Sie auf Bearbeiten und Neue Überarbeitung bereitstellen.
4. Ändern Sie auf dem Tab Variablen und Secrets im Abschnitt Container den PREVIEW_SERVER_URL in die neue Domain. Beispiel: preview.sgtm.example.com.

Schritt 2: Vorhandenen Load-Balancer für hostbasiertes Routing konfigurieren

Verwenden Sie zum Konfigurieren des vorhandenen Load-Balancers hostbasiertes Routing und senden Sie Traffic an den richtigen Server:

1. Öffnen Sie in Cloud Run die Seite Load-Balancing und klicken Sie auf den Namen des Load-Balancers.
2. Klicken Sie auf die Schaltfläche Bearbeiten.
3. Klicken Sie auf die Seite Back-End-Konfiguration und öffnen Sie das Drop-down-Menü für Back-End-Dienste und Back-End-Buckets.
4. Klicken Sie auf Back-End-Dienst erstellen und führen Sie die folgenden Schritte aus:
   1. Geben Sie einen geeigneten Namen ein, z. B. preview-backend-service.
   2. Wählen Sie den Back-End-Typ Serverlose Netzwerk-Endpunktgruppe aus.
5. Erstellen Sie im Bereich Back-End eine neue serverlose Netzwerk-Endpunktgruppe und führen Sie die folgenden Schritte aus:
   1. Geben Sie einen Namen ein und wählen Sie die Region aus, in der der Vorschauserver gehostet wird.
   2. Wählen Sie als Servergruppentyp für serverloses Netzwerk Cloud Run und als Dienst den Vorschauserver aus.
   3. Klicken Sie auf Erstellen.
6. Ändern Sie bei Bedarf andere Einstellungen oder behalten Sie die Standardeinstellungen bei und klicken Sie auf Erstellen.

Schritt 3: Neue Regel hinzufügen und Steuerung für eingehenden Traffic aktualisieren

So fügen Sie eine Regel für die neue Host-URL hinzu und aktualisieren die Steuerung für eingehenden Traffic:

1. Öffnen Sie die Seite Host- und Pfadregeln.
2. Fügen Sie eine neue Regel hinzu. Dabei gilt:
   • Der Host ist die neue URL: preview.sgtm.example.com
   • Der Pfad lautet: /*
   • Das Back-End ist: preview-backend-service
3. Klicken Sie auf die Schaltfläche Aktualisieren, um den Load-Balancer noch einmal bereitzustellen.
4. Öffnen Sie in Cloud Run den Vorschauserver und wählen Sie den Tab Netzwerk aus.
5. Ändern Sie die Steuerung für eingehenden Traffic in Intern und aktivieren Sie Traffic von externen Anwendungs-Load-Balancern zulassen, damit sie nicht öffentlich zugänglich ist.

Ergebnis: Ihre Serverarchitektur sollte jetzt wie in Abbildung 3 aussehen. Hier werden alle Trafficanfragen an den Tagging-Server gerichtet und der Tagging-Server kann Anfragen an den Vorschauserver weiterleiten.

Abbildung 3: Hostbasiertes Routing verwenden

Hinweis: Sie können kein pfadbasiertes Routing verwenden, z. B. die Zuordnung von /gtm/debug zu preview-backend-service. Mit dieser Methode können Sie das Debug-Fenster aufrufen, aber die Ereignisse sehen nicht. Das liegt daran, dass der Tagging-Server Ereignisse an andere Pfade weiterleitet und diese nicht zum richtigen Ziel gelangen können. Der Host sorgt für eine klare Trennung zwischen den beiden Zielen.

Konfiguration überprüfen

So prüfen Sie Ihre Konfiguration:

1. Öffnen Sie Google Tag Manager.
2. Öffnen Sie den Servercontainer.
3. Klicken Sie auf Verwaltung > Containereinstellungen und legen Sie als Servercontainer-URL die URL des Vorschauservers fest.
4. Schließen Sie das Fenster und sehen Sie sich eine Vorschau des Arbeitsbereichs an. Das Debug-Fenster wird geöffnet. Während Sie auf Ihrer Website navigieren, sollten die Ereignisse im Debug-Fenster angezeigt werden.

Weitere Informationen

• Serverseitiges Tagging mit Cloud Run einrichten
• Regionsspezifisches Verhalten beim serverseitigen Tagging aktivieren