Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Menyiapkan Jalur Penayangan Pihak Pertama

Fitur Jalur Penayangan Pihak Pertama memungkinkan Anda memulihkan alamat IP pengguna yang tidak disamarkan dengan mengarahkan permintaan melalui Jaringan Penayangan Konten (CDN) atau infrastruktur web Anda ke server iklan Google.

Pada permintaan pihak ketiga, fitur browser dan OS serta konfigurasi jaringan mungkin menyamarkan alamat IP. Penyamaran ini dapat memengaruhi pendapatan iklan, penargetan geografis, dan deteksi traffic tidak valid (IVT) Anda.

CDN Anda menerima IP klien pengguna yang tidak disamarkan pada semua permintaan masuk ke domain Anda. Fitur ini memberikan manfaat berikut:

Tidak ada perubahan kode sisi klien: Anda tidak mengedit JavaScript atau meneruskan parameter secara manual. Tag Penayang Google (GPT) membaca jalur yang dikonfigurasi dari setelan Google Ad Manager Anda dan menjalankan permintaan pemulihan secara asinkron.
Overhead lebih sedikit: Permintaan ini ringan, di-cache secara lokal per sesi tayangan halaman, dan berjalan secara asinkron bersama definisi slot iklan.
Payload terenkripsi: Secara default, fitur ini menampilkan alamat IP pengguna sebagai payload terenkripsi.

Halaman ini membahas cara mengonfigurasi Jalur Penayangan Pihak Pertama ke CDN pilihan Anda.

Prasyarat

Sebelum mengonfigurasi CDN, lakukan hal berikut:

Tentukan jalur penayangan di akun Ad Manager Anda, misalnya, /adserver/. Untuk menentukan jalur, ikuti langkah-langkah di Metode 1: Jalur penayangan pihak pertama.
- Pastikan jalur penayangan Anda unik, dan tidak ada traffic yang Anda kirim menggunakan jalur ini.
Miliki atau tetapkan item berikut:
- Host atau origin target: securepubads.g.doubleclick.net
- Target path: /pagead/fpm
- Protocol: HTTPS dengan port default 443.
- Headers: Tetapkan header sebagai Host: securepubads.g.doubleclick.net.
- Caching: Konfigurasi CDN Anda untuk mengabaikan caching untuk rute, misalnya, tetapkan kebijakan cache untuk mengabaikan cache atau header Cache-Control: no-store.
Jika CDN Anda adalah Cloudflare, Anda harus memiliki paket Cloudflare Enterprise untuk membuat aturan origin.

Mengonfigurasi CDN Anda

Konfigurasi CDN atau reverse proxy Anda untuk meneruskan permintaan yang cocok dengan jalur yang dikonfigurasi ke server iklan Google. Pilih CDN yang Anda inginkan:

Cloudflare

Buat aturan di dasbor dengan nilai berikut:
- Custom filter expression: Tambahkan kode berikut:
  - Kolom: URI Path
  - Operator: starts with
  - Value: jalur Anda, misalnya, /adserver/.
- Host Header Override: Pilih Rewrite to dan tambahkan host target securepubads.g.doubleclick.net.
- DNS Override: Pilih Override to dan tambahkan host target securepubads.g.doubleclick.net.
Buat penulisan ulang aturan URL di dasbor dengan nilai berikut:
- Custom filter expression: Tambahkan kode berikut:
  - Kolom: URI Path
  - Operator: starts with
  - Value: jalur Anda, misalnya, /adserver/.
- Path: Pilih Rewrite to > Static > dan tambahkan jalur target /pagead/fpm.
- Query: Pilih Preserve.

Amazon CloudFront

Ikuti langkah-langkah di Setelan origin dengan nilai berikut:
- Domain origin: securepubads.g.doubleclick.net
- Protocol: HTTPS
Ikuti Membuat fungsi dan tambahkan contoh berikut:
```
function handler(event) {
    var request = event.request;
    request.uri = '/pagead/fpm';
    return request;
}
```
Contoh ini mengambil peristiwa permintaan masuk, menetapkan URI ke jalur target, dan menampilkan permintaan.

Klik Save changes, buka tab Publish, lalu klik Publish function.
Ikuti Memperbarui distribusi di konsol dengan nilai berikut:
- Pola jalur: jalur Anda, misalnya, /adserver/*.
- Origin and Origin Groups: host target, securepubads.g.doubleclick.net.
- Cache policy: Pilih CachingDisabled.
- Origin request policy: Pilih AllViewerExceptHostHeader.
- Pengaitan fungsi:
  - Viewer request: Pilih CloudFront Function dan tambahkan nama fungsi Anda.

Fastly

Ikuti Menambahkan host dengan nilai berikut:
- Address: host target, securepubads.g.doubleclick.net
- Port: port default, 443.
- Enable TLS?: Ya
  - Nama host sertifikat: securepubads.g.doubleclick.net
    - Pilih Match the SNI hostname to the Certificate Name.
  - Nama host SNI: securepubads.g.doubleclick.net
  - Ganti host: securepubads.g.doubleclick.net

Ikuti Membuat cuplikan VCL dengan contoh berikut:

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

Ganti kode berikut:

NAME: nama host, misalnya, Google_GAM_FPM_Backend.
PATH: jalur Anda, misalnya, /adserver/.

Google Cloud

Ikuti Membuat NEG dan endpoint internet dengan nilai berikut:
- Network endpoint group type: Pilih Internet NEG (Global)
- Port default: 443
- New network endpoint: Pilih Fully qualified domain name (FQDN) and port.
- FQDN: tambahkan host target, securepubads.g.doubleclick.net.
Buat layanan backend global dan konfigurasikan header permintaan kustom dengan nilai berikut:
- Backend type: Pilih Internet network endpoint group.
- Protocol: Pilih HTTPS.
  - Nama header: Host
  - Nilai header: tambahkan host target, securepubads.g.doubleclick.net.
Ikuti langkah-langkah di Mengonfigurasi peta URL.
Di Routing rules, temukan aturan host produksi yang cocok dengan subdomain Anda.

Perbarui pencocok jalur dengan konfigurasi 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
```
Ganti kode berikut:
- BACKEND_NAME: nama layanan backend yang Anda buat di langkah 2, misalnya, gam-fpm-backend-service.
- DEFAULT_BACKEND: layanan backend default yang menghosting situs Anda.
  - Jika Anda menghosting situs di Cloud Storage, ganti backendServices dengan parameter backendBuckets di jalur resource kolom defaultService.
- NAME: nama pencocok jalur, misalnya, gam-fpm-matcher.
- PATH: jalur Anda, misalnya, /adserver/.
- PROJECT_ID: project ID Anda.

Menguji implementasi Anda

Untuk memverifikasi bahwa CDN Anda mem-proxy permintaan dan meneruskan alamat IP, jalankan pengujian menggunakan perintah curl:

curl -i https://example.comPATH

Ganti PATH dengan jalur Anda, misalnya, /adserver/.

Jika berhasil, Anda akan menerima output berikut:

Status HTTP: 200 OK
Konten respons: Payload dari server backend Google yang berisi token IP terenkripsi secara default.

Memecahkan masalah penerapan Anda

Bagian ini membahas alur kerja untuk memecahkan masalah penerapan Jalur Penayangan Pihak Pertama di CDN Anda.

Tabel berikut menjelaskan masalah, penyebab, dan solusi untuk memecahkan masalah:

Masalah	Penyebab	Solusi
Anda menerima status HTTP 404 atau 502 dari CDN	Penulisan ulang jalur tidak aktif atau header `Host` tidak ada.	Pastikan penulisan ulang Anda dipetakan ke jalur target `/pagead/fpm` dan header `Host` diganti ke host target, `securepubads.g.doubleclick.net`.
Alamat IP tidak diperbarui pada panggilan iklan.	Caching diaktifkan di proxy CDN	Pastikan Anda menetapkan kebijakan cache pada rute ke kebijakan `CachingDisabled` atau header `Cache-Control: no-store`. Setiap klien harus menjangkau layanan backend untuk mengevaluasi alamat IP spesifiknya.
Kegagalan handshake SSL atau TLS	Ketidakcocokan SNI pada koneksi origin backend	Pastikan Anda mengonfigurasi CDN untuk mengirim host target `securepubads.g.doubleclick.net` di ekstensi TLS SNI.
Parameter `ips` tidak ada dalam permintaan iklan.	Jalur Ad Manager tidak cocok dengan jalur CDN	Pastikan jalur yang dimasukkan di halaman Setelan Global UI Ad Manager cocok dengan jalur yang dikonfigurasi di CDN Anda. Untuk mengetahui detailnya, lihat Meneruskan IP yang diberikan penayang tanpa disamarkan (Beta).