Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Pfad für eigene Bereitstellung einrichten

Mit der Funktion „Pfad für eigene Bereitstellung“ können Sie die unmaskierte Nutzer-IP-Adresse wiederherstellen, indem Sie eine Anfrage über Ihr Content Delivery Network (CDN) oder Ihre Webinfrastruktur an Google-Ad-Server weiterleiten.

Bei Anfragen von Drittanbietern können Browser- und Betriebssystemfunktionen sowie Netzwerkkonfigurationen IP-Adressen maskieren. Diese Maskierung kann sich auf Ihre Werbeeinnahmen, das geografische Targeting und die Erkennung von ungültigem Traffic auswirken.

Ihr CDN empfängt bei allen eingehenden Anfragen an Ihre Domain die unmaskierte Client-IP-Adresse eines Nutzers. Diese Funktion bietet folgende Vorteile:

Keine clientseitigen Codeänderungen: Sie müssen weder JavaScript bearbeiten noch Parameter manuell übergeben. Das Google Publisher-Tag (GPT) liest den konfigurierten Pfad aus Ihren Google Ad Manager-Einstellungen und führt die Wiederherstellungsanfrage asynchron aus.
Weniger Aufwand: Die Anfrage ist einfach, wird lokal pro Seitenaufrufsitzung im Cache gespeichert und wird asynchron zusammen mit den Definitionen der Anzeigenflächen ausgeführt.
Verschlüsselte Nutzlast: Standardmäßig wird die IP-Adresse des Nutzers als verschlüsselte Nutzlast zurückgegeben.

Auf dieser Seite wird beschrieben, wie Sie den Pfad für eigene Bereitstellung für Ihr bevorzugtes CDN konfigurieren.

Vorbereitung

Führen Sie vor dem Konfigurieren des CDN die folgenden Schritte aus:

Geben Sie in Ihrem Ad Manager-Konto einen Bereitstellungspfad an, z. B. /adserver/. Folgen Sie der Anleitung unter Methode 1: Pfad für eigene Bereitstellung, um den Pfad anzugeben.
- Achten Sie darauf, dass der Bereitstellungspfad eindeutig ist und kein von Ihnen gesendeter Traffic diesen Pfad verwendet.
Sie benötigen Folgendes:
- Zielhost oder -ursprung: securepubads.g.doubleclick.net
- Zielpfad: /pagead/fpm
- Protokoll: HTTPS mit dem Standardport 443.
- Header: Legen Sie den Header auf Host: securepubads.g.doubleclick.net fest.
- Caching: Konfigurieren Sie Ihr CDN so, dass das Caching für eine Route umgangen wird. Legen Sie beispielsweise die Cache-Richtlinien so fest, dass der Cache oder der Header Cache-Control: no-store umgangen wird.
Wenn Sie Cloudflare als CDN verwenden, benötigen Sie eine Cloudflare Enterprise-Stufe, um eine Ursprungsregel zu erstellen.

CDN konfigurieren

Konfigurieren Sie Ihr CDN oder Ihren Reverse-Proxy so, dass Anfragen, die dem konfigurierten Pfad entsprechen, an Google-Ad-Server weitergeleitet werden. Wählen Sie das gewünschte CDN aus:

Cloudflare

Erstellen Sie im Dashboard eine Regel mit den folgenden Werten:
- Benutzerdefinierter Filterausdruck: Fügen Sie Folgendes hinzu:
  - Feld: URI Path
  - Operator: starts with
  - Wert: Ihr Pfad, z. B. /adserver/.
- Hostheader-Überschreibung: Wählen Sie Umschreiben zu aus und fügen Sie den Zielhost securepubads.g.doubleclick.net hinzu.
- DNS-Überschreibung: Wählen Sie Überschreiben mit aus und fügen Sie den Zielhost securepubads.g.doubleclick.net hinzu.
Erstellen Sie im Dashboard eine URL-Regel-Umschreibung mit den folgenden Werten:
- Benutzerdefinierter Filterausdruck: Fügen Sie Folgendes hinzu:
  - Feld: URI Path
  - Operator: starts with
  - Wert: Ihr Pfad, z. B. /adserver/.
- Pfad: Wählen Sie Umschreiben in > Statisch > aus und fügen Sie den Zielpfad /pagead/fpm hinzu.
- Abfrage: Wählen Sie Aufbewahren aus.

Amazon CloudFront

Folgen Sie der Anleitung unter Ursprungseinstellungen mit den folgenden Werten:
- Ursprungsdomain: securepubads.g.doubleclick.net
- Protokoll: HTTPS
Folgen Sie der Anleitung unter Funktionen erstellen und fügen Sie das folgende Beispiel hinzu:
```
function handler(event) {
    var request = event.request;
    request.uri = '/pagead/fpm';
    return request;
}
```
In diesem Beispiel wird das eingehende Anfrageereignis verwendet, der URI dem Zielpfad zugewiesen und die Anfrage zurückgegeben.

Klicken Sie auf Änderungen speichern, rufen Sie den Tab Veröffentlichen auf und klicken Sie auf Funktion veröffentlichen.
Folgen Sie der Anleitung unter Distribution in der Console aktualisieren mit den folgenden Werten:
- Pfadmuster: Ihr Pfad, z. B. /adserver/*.
- Ursprung und Ursprungsgruppen: der Zielhost, securepubads.g.doubleclick.net.
- Cache-Richtlinie: Wählen Sie CachingDisabled aus.
- Ursprungsanforderungsrichtlinie: Wählen Sie AllViewerExceptHostHeader aus.
- Funktionszuordnungen:
  - Betrachteranfrage: Wählen Sie CloudFront-Funktion aus und fügen Sie den Namen Ihrer Funktion hinzu.

Fastly

Folgen Sie der Anleitung unter Host hinzufügen und verwenden Sie die folgenden Werte:
- Adresse: der Zielhost, securepubads.g.doubleclick.net
- Port: der Standardport, 443.
- TLS aktivieren?: Ja
  - Zertifikat-Hostname: securepubads.g.doubleclick.net
    - Wählen Sie SNI-Hostnamen mit dem Zertifikatsnamen abgleichen aus.
  - SNI-Hostname: securepubads.g.doubleclick.net
  - Host überschreiben: securepubads.g.doubleclick.net
Folgen Sie der Anleitung unter VCL-Snippets erstellen und verwenden Sie das folgende Beispiel:
```
if (req.url ~ "^PATH") {
    set req.backend = F_NAME;
    set req.http.Host = "securepubads.g.doubleclick.net";
    set req.url = regsub(req.url, "^PATH", "/pagead/fpm");
    return(pass);
}
```
Ersetzen Sie Folgendes:
- NAME: der Name des Hosts, z. B. Google_GAM_FPM_Backend.
- PATH: Ihr Pfad, z. B. /adserver/.

Google Cloud

Folgen Sie der Anleitung unter NEG und Internetendpunkt erstellen mit den folgenden Werten:
- Typ der Netzwerk-Endpunktgruppe: Wählen Sie Internet-NEG (global) aus.
- Standardport: 443
- Neuer Netzwerkendpunkt: Wählen Sie Voll qualifizierter Domainname (FQDN) und Port aus.
- FQDN: Fügen Sie den Zielhost securepubads.g.doubleclick.net hinzu.
Erstellen Sie Ihren globalen Backend-Dienst und konfigurieren Sie benutzerdefinierte Anfrageheader mit den folgenden Werten:
- Backend-Typ: Wählen Sie Internetnetzwerk-Endpunktgruppe aus.
- Protokoll: Wählen Sie HTTPS aus.
  - Header name: Host
  - Headerwert: Fügen Sie den Zielhost securepubads.g.doubleclick.net hinzu.
Folgen Sie der Anleitung unter URL-Zuordnungen konfigurieren.
Suchen Sie unter Routingregeln die Hostregel für die Produktion, die Ihrer Subdomain entspricht.

Aktualisieren Sie die Pfad-Matcher mit der routeRules-Konfiguration:
```
name: NAME
defaultService: projects/PROJECT_ID/global/backendServices/DEFAULT_BACKEND
routeRules:
  - priority: 1
    matchRules:
      - prefixMatch: PATH
    service: projects/PROJECT_ID/global/backendServices/BACKEND_NAME
    routeAction:
      urlRewrite:
        pathPrefixRewrite: /pagead/fpm
```
Ersetzen Sie Folgendes:
- BACKEND_NAME: der Name des Backend-Dienstes, den Sie in Schritt 2 erstellt haben, z. B. gam-fpm-backend-service.
- DEFAULT_BACKEND: der Standard-Backend-Dienst, der Ihre Website hostet.
  - Wenn Sie Ihre Website in Cloud Storage hosten, ersetzen Sie backendServices durch den Parameter backendBuckets im Ressourcenpfad des Felds defaultService.
- NAME: der Name des Pfad-Matchers, z. B. gam-fpm-matcher.
- PATH: Ihr Pfad, z. B. /adserver/.
- PROJECT_ID: Ihre Projekt-ID.

Die Implementierung testen

Führen Sie einen Test mit dem Befehl curl aus, um zu prüfen, ob Ihr CDN die Anfrage weiterleitet und die IP-Adresse übergibt:

curl -i https://example.comPATH

Ersetzen Sie PATH durch Ihren Pfad, z. B. /adserver/.

Bei erfolgreicher Ausführung erhalten Sie die folgende Ausgabe:

HTTP-Status: 200 OK
Antwortinhalt: Eine Nutzlast von Google-Backend-Servern, die standardmäßig ein verschlüsseltes IP-Token enthält.

Probleme mit der Implementierung beheben

In diesem Abschnitt werden Workflows zur Fehlerbehebung bei der Implementierung des Pfads für eigene Bereitstellung in Ihrem CDN beschrieben.

In der folgenden Tabelle sind Probleme, Ursachen und Lösungen zur Fehlerbehebung aufgeführt:

Problem	Ursache	Lösung
Sie erhalten den HTTP-Status 404 oder 502 von Ihrem CDN	Die Pfadumschreibung ist nicht aktiv oder der Header `Host` fehlt.	Prüfen Sie, ob die Rewrite-Zuordnungen zum Zielpfad `/pagead/fpm` und der Header `Host` mit dem Zielhost `securepubads.g.doubleclick.net` überschrieben werden.
Die IP-Adresse wird bei Anzeigenanfragen nicht aktualisiert.	Caching auf CDN-Proxy aktiviert	Achten Sie darauf, dass Sie die Cache-Richtlinie für die Route auf die Richtlinie `CachingDisabled` oder den Header `Cache-Control: no-store` festlegen. Jeder Client muss den Backend-Dienst erreichen, um seine spezifische IP-Adresse auszuwerten.
SSL- oder TLS-Handshake-Fehler	SNI-Abweichung bei der Backend-Ursprungsverbindung	Achten Sie darauf, dass Ihr CDN so konfiguriert ist, dass der Zielhost `securepubads.g.doubleclick.net` in der TLS-SNI-Erweiterung gesendet wird.
Der Parameter `ips` fehlt in der Anzeigenanfrage.	Ad Manager-Pfad stimmt nicht mit CDN-Pfad überein	Prüfen Sie, ob der Pfad, den Sie in der Ad Manager-Benutzeroberfläche auf der Seite Globale Einstellungen eingegeben haben, mit dem Pfad übereinstimmt, der in Ihrem CDN konfiguriert ist. Weitere Informationen finden Sie unter Nicht maskierte vom Publisher bereitgestellte IP-Adresse übergeben (Beta).