Konfigurowanie przekazywania żądań reklamowych przez infrastrukturę wydawcy

Funkcja przekazywania żądań reklamowych przez infrastrukturę wydawcy umożliwia odzyskanie niezamaskowanego adresu IP użytkownika przez przekierowanie żądania przez sieć dostarczania treści (CDN) lub infrastrukturę internetową do serwerów reklamowych Google.

W przypadku żądań od innych firm funkcje przeglądarki i systemu operacyjnego oraz konfiguracje sieci mogą maskować adresy IP. Może to wpłynąć na przychody z reklam, kierowanie geograficzne i wykrywanie nieprawidłowego ruchu.

Sieć CDN otrzymuje nieukryty adres IP klienta we wszystkich żądaniach przychodzących do Twojej domeny. Ta funkcja zapewnia te korzyści:

  • Brak zmian w kodzie po stronie klienta: nie musisz edytować kodu JavaScript ani ręcznie przekazywać parametrów. Tag wydawcy Google (GPT) odczytuje skonfigurowaną ścieżkę z ustawień Google Ad Managera i asynchronicznie wysyła żądanie odzyskiwania.
  • Mniejsze obciążenie: żądanie jest lekkie, zapisywane lokalnie w pamięci podręcznej na sesję wyświetlenia strony i uruchamiane asynchronicznie wraz z definicjami boksów reklamowych.
  • Zaszyfrowany ładunek: domyślnie ta funkcja zwraca adres IP użytkownika jako zaszyfrowany ładunek.

Na tej stronie znajdziesz informacje o konfigurowaniu przekazywania żądań reklamowych przez infrastrukturę wydawcy do preferowanej sieci CDN.

Wymagania wstępne

Zanim skonfigurujesz sieć CDN, wykonaj te czynności:

  • Określ ścieżkę wyświetlania na koncie Ad Managera, np. /adserver/. Aby określić ścieżkę, wykonaj czynności opisane w sekcji Metoda 1. Przekazywanie żądań reklamowych przez infrastrukturę wydawcy.
    • Upewnij się, że ścieżka wyświetlania jest unikalna i nie jest używana przez żaden ruch, który wysyłasz.
  • Musisz mieć lub ustawić te elementy:
    • Docelowy host lub źródło: securepubads.g.doubleclick.net
    • Ścieżka docelowa: /pagead/fpm
    • Protokół: HTTPS z domyślnym portem 443.
    • Nagłówki: ustaw nagłówek jako Host: securepubads.g.doubleclick.net.
    • Zapisywanie w pamięci podręcznej: skonfiguruj sieć CDN tak, aby pomijała zapisywanie w pamięci podręcznej w przypadku danej trasy, np. ustaw zasady pamięci podręcznej na pomijanie pamięci podręcznej lub nagłówek Cache-Control: no-store.
  • Jeśli Twoją siecią CDN jest Cloudflare, musisz mieć poziom Cloudflare Enterprise, aby utworzyć regułę źródła.

Konfigurowanie sieci CDN

Skonfiguruj sieć CDN lub zwrotny serwer proxy, aby przekazywać żądania pasujące do skonfigurowanej ścieżki do serwerów reklam Google. Wybierz preferowaną sieć CDN:

Cloudflare

  1. Utwórz regułę w panelu z tymi wartościami:

    • Niestandardowe wyrażenie filtra: dodaj:
      • Pole: URI Path
      • Operator: starts with
      • Value (Wartość): Twoja ścieżka, na przykład /adserver/.
    • Host Header Override (Zastąp nagłówek hosta): wybierz Rewrite to (Przepisz na) i dodaj hosta docelowego securepubads.g.doubleclick.net.
    • DNS Override (Zastąpienie DNS): wybierz Override to (Zastąp przez) i dodaj hosta docelowego securepubads.g.doubleclick.net.

  2. Utwórz w panelu regułę przepisywania adresów URL z tymi wartościami:

    • Niestandardowe wyrażenie filtra: dodaj:
      • Pole: URI Path
      • Operator: starts with
      • Value (Wartość): Twoja ścieżka, na przykład /adserver/.
    • Ścieżka: wybierz Przepisz na > Statyczna > i dodaj ścieżkę docelową /pagead/fpm.
    • Zapytanie: wybierz Zachowaj.

Amazon CloudFront

  1. Wykonaj czynności opisane w sekcji Ustawienia źródła, używając tych wartości:

    • Domena źródła: securepubads.g.doubleclick.net
    • Protokół: HTTPS

  2. Wykonaj czynności opisane w sekcji Tworzenie funkcji i dodaj ten przykład:

    function handler(event) {
    var request = event.request;
    request.uri = '/pagead/fpm';
    return request;
}

    W tym przykładzie zdarzenie żądania przychodzącego jest pobierane, identyfikator URI jest przypisywany do ścieżki docelowej, a żądanie jest zwracane.

    Kliknij Zapisz zmiany, przejdź na kartę Publikowanie i kliknij Opublikuj funkcję.

  3. Wykonaj czynności opisane w sekcji Aktualizowanie dystrybucji w konsoli, używając tych wartości:

    • Path pattern (Wzorzec ścieżki): Twoja ścieżka, na przykład /adserver/*.
    • Źródło i grupy źródeł: host docelowy, securepubads.g.doubleclick.net.
    • Zasada pamięci podręcznej: wybierz CachingDisabled.
    • Origin request policy (Zasada żądania pochodzenia): wybierz AllViewerExceptHostHeader.
    • Powiązania funkcji:
      • Viewer request (Żądanie przeglądającego): wybierz CloudFront Function (Funkcja CloudFront) i dodaj nazwę funkcji.

Fastly

  1. Wykonaj czynności opisane w sekcji Dodawanie hosta, używając tych wartości:

    • Address (Adres): host docelowy, securepubads.g.doubleclick.net
    • Port: domyślny port, 443.
    • Włączyć TLS?: Tak
      • Nazwa hosta certyfikatu: securepubads.g.doubleclick.net
        • Wybierz Dopasuj nazwę hosta SNI do nazwy certyfikatu.
      • Nazwa hosta SNI: securepubads.g.doubleclick.net
      • Zastąp hosta: securepubads.g.doubleclick.net

  2. Wykonaj czynności opisane w artykule Tworzenie fragmentów kodu VCL, korzystając z tego przykładu:

    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);
}

    Zastąp te elementy:

    • NAME: nazwa hosta, na przykład Google_GAM_FPM_Backend.
    • PATH: Twoja ścieżka, na przykład /adserver/.

Google Cloud

  1. Wykonaj czynności opisane w sekcji Tworzenie grupy punktów końcowych sieci i internetowego punktu końcowego, używając tych wartości:

    • Typ grupy punktów końcowych sieci: wybierz Internetowa grupa punktów końcowych sieci (globalna).
    • Domyślny port: 443
    • Nowy punkt końcowy sieci: wybierz Pełna i jednoznaczna nazwa domeny i port.
    • FQDN: dodaj hosta docelowego securepubads.g.doubleclick.net.

  2. Utwórz globalną usługę backendu i skonfiguruj niestandardowe nagłówki żądań z tymi wartościami:

    • Typ backendu: wybierz Internetowa grupa punktów końcowych sieci.
    • Protokół: wybierz HTTPS.
      • Nazwa nagłówka: Host
      • Wartość nagłówka: dodaj hosta docelowego, securepubads.g.doubleclick.net.

  3. Wykonaj czynności opisane w artykule Konfigurowanie map URL.

  4. W sekcji Reguły routingu znajdź regułę hosta produkcyjnego, która pasuje do Twojej subdomeny.

    Zaktualizuj dopasowania ścieżek za pomocą konfiguracji routeRules:

    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

    Zastąp te elementy:

    • BACKEND_NAME: nazwa usługi backendu utworzonej w kroku 2, np. gam-fpm-backend-service.
    • DEFAULT_BACKEND: domyślna usługa backendu, która hostuje Twoją witrynę.
      • Jeśli hostujesz witrynę w Cloud Storage, zastąp backendServices parametrem backendBuckets w ścieżce zasobu w polu defaultService.
    • NAME: nazwa dopasowania ścieżki, na przykład gam-fpm-matcher.
    • PATH: Twoja ścieżka, na przykład /adserver/.
    • PROJECT_ID: identyfikator Twojego projektu.

Testowanie implementacji

Aby sprawdzić, czy sieć CDN przekazuje żądanie i adres IP, przeprowadź test za pomocą polecenia curl:

curl -i https://example.comPATH

Zastąp PATH swoją ścieżką, na przykład /adserver/.

Jeśli wykonanie polecenia się powiedzie, zobaczysz ten komunikat:

  • Stan HTTP: 200 OK
  • Treść odpowiedzi: ładunek z serwerów backendu Google, który domyślnie zawiera zaszyfrowany token IP.

Rozwiązywanie problemów z implementacją

W tej sekcji opisujemy przepływy pracy, które pomogą Ci rozwiązać problemy z wdrożeniem przekazywania żądań reklamowych przez infrastrukturę wydawcy w sieci CDN.

W poniższej tabeli szczegółowo opisano problemy, przyczyny i rozwiązania dotyczące rozwiązywania problemów:

Problem Przyczyna Rozwiązanie
Otrzymujesz z sieci CDN kod stanu HTTP 404 lub 502 Przepisywanie ścieżki jest nieaktywne lub brakuje nagłówka Host. Sprawdź, czy mapy przepisywania są mapowane na ścieżkę docelową /pagead/fpm, a nagłówek Host jest zastępowany hostem docelowym securepubads.g.doubleclick.net.
Adres IP nie jest aktualizowany w żądaniach reklamy. Włączono buforowanie na serwerze proxy CDN Ustaw zasadę pamięci podręcznej na trasie na zasadę CachingDisabled lub nagłówek Cache-Control: no-store. Każdy klient musi dotrzeć do usługi backendu, aby ocenić swój konkretny adres IP.
Niepowodzenie uzgadniania połączenia SSL lub TLS Niezgodność SNI w połączeniu ze źródłem backendu Upewnij się, że sieć CDN jest skonfigurowana tak, aby wysyłać hosta docelowego securepubads.g.doubleclick.net w rozszerzeniu TLS SNI.
W żądaniu reklamy brakuje parametru ips. Ścieżka Ad Managera nie pasuje do ścieżki CDN Sprawdź, czy ścieżka wpisana na stronie Ustawienia globalne w interfejsie Ad Managera jest zgodna ze ścieżką skonfigurowaną w sieci CDN. Więcej informacji znajdziesz w artykule Przekazywanie nieukrytego adresu IP (użytkownika) przekazywanego przez wydawcę (beta).