Privaten Vorschauserver einrichten

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

Mit serverseitigem Tagging können Sie Tagging-Änderungen im Vorschau- und Debug-Modus in der Vorschau ansehen, bevor Sie sie anwenden. Dies ist ein wichtiger Teil des Entwicklungsablaufs, um sicherzustellen, dass sich Ihre Tags wie vorgesehen verhalten. Für diese Funktion sind zwei Cloud Run-Bereitstellungen erforderlich: eine für einen Tagging-Server und eine für einen Vorschauserver. In diesem Leitfaden finden Sie weitere Informationen zur Kommunikation zwischen den beiden Servern und zur Konfiguration in einer Unternehmensumgebung.

Übersicht

Wenn Sie serverseitiges Tagging in Cloud Run bereitstellen, können Sie es mit oder ohne Load Balancer bereitstellen. Für Bereitstellungen in mehreren Regionen benötigen Sie einen Load-Balancer, um den Traffic an die nächstgelegene Instanz weiterzuleiten.

Ohne Load-Balancer

Ohne Load Balancer

Abbildung 1: Bereitstellung ohne Load-Balancer.

Mit Load-Balancer

Mit einem Load Balancer

Abbildung 2: Bereitstellung mit einem Load-Balancer.

In beiden Bereitstellungen ist der Einstiegspunkt für den Vorschauserver und die Produktions-Tagging-Umgebung 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, wird in Tag Manager sgtm.example.com?id=[gtm_server_id]&gtm_auth=[auth_id]&gtm_preview=[env_id] aufgerufen und ein Cookie gesetzt. Wenn Sie dann mit demselben Browser die Zielwebsite aufrufen, wird das Cookie auch bei Anfragen an sgtm.example.com weitergeleitet. Aufgrund des Cookies weiß der Tagging-Server, dass es sich um Ihre Ereignisse handelt. Er 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.

Öffentlich zugängliche Vorschau-Server

Für dieses Standardverhalten muss Ihr Vorschauserver öffentlich sein. Für einige Organisationen ist dies jedoch problematisch, da sie Einschränkungen hinsichtlich der Infrastruktur haben, die öffentlich zugänglich sein darf, 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 zum Einschränken von Chiffresammlungen.
  • Native Integration mit Cloud Armor für Web Application Firewall (WAF) oder Distributed Denial of Service (DDoS).
  • Erweiterte Funktionen zur Traffic-Verwaltung

Vorschau-Server über einen Load Balancer weiterleiten

Wenn Sie einen Vorschauserver für die private Vorschau erstellen möchten, verwenden Sie das hostbasierte Routing über den Load Balancer mit einer zusätzlichen Subdomain. Im weiteren Verlauf dieses Leitfadens wird beschrieben, wie Sie Ihren Vorschauserver über einen Load Balancer weiterleiten.

Vorbereitung

  • 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, z. B. preview.sgtm.example.com.

Schritt 1: Umgebungsvariable mit einer neuen Subdomain aktualisieren

Wenn Sie die neue Vorschau-Serverdomain verwenden möchten, aktualisieren Sie die Umgebungsvariable PREVIEW_SERVER_URL für den serverseitigen Tagging-Server:

  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 die PREVIEW_SERVER_URL in die neue Domain. Beispiel: preview.sgtm.example.com.

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

So konfigurieren Sie den vorhandenen Load-Balancer mit hostbasiertem Routing und leiten Traffic an den richtigen Server weiter:

  1. Öffnen Sie in Cloud Run die Seite Load-Balancing und klicken Sie auf den Namen des Load-Balancers.
  2. Klicken Sie auf 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 Backend-Dienst erstellen und führen Sie die folgenden Schritte aus:
    1. Geben Sie ihm einen geeigneten Namen, z. B. preview-backend-service.
    2. Wählen Sie als Backend-Typ Endpunktgruppe in serverlosem Netzwerk aus.
  5. Erstellen Sie im Bereich Backend 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 Cloud Run als Typ der Endpunktgruppe für ein serverloses Netzwerk und den Vorschauserver als Dienst aus.
    3. Klicken Sie auf Erstellen.
  6. Ändern Sie die anderen Einstellungen nach Bedarf oder übernehmen Sie die Standardeinstellungen 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, in der gilt:
    • Der Host ist die neue URL: preview.sgtm.example.com
    • Der Pfad lautet: /*
    • Das Backend ist: preview-backend-service
  3. Klicken Sie auf die Schaltfläche Aktualisieren, um den Load-Balancer neu 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 Application Load Balancern zulassen, damit der Zugriff nicht öffentlich möglich ist.

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

Hostbasiertes Routing

Abbildung 3: Hostbasiertes Routing

Konfiguration prüfen

So prüfen Sie Ihre Konfiguration:

  1. Öffnen Sie Google Tag Manager.
  2. Öffnen Sie Ihren Servercontainer.
  3. Klicken Sie auf Verwaltung > Containereinstellungen und legen Sie die Servercontainer-URL auf die Tagging-Server-URL fest.
  4. Schließen Sie das Fenster und sehen Sie sich eine Vorschau des Arbeitsbereichs an. Das Debug-Fenster wird geöffnet. Wenn Sie Ihre Website aufrufen, sollten Ihre Ereignisse im Debug-Fenster angezeigt werden.