Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Birinci taraf reklam yayın yolunu ayarlama

Birinci taraf reklam yayın yolu özelliği, isteği içerik yayınlama ağınız (CDN) veya web altyapınız üzerinden Google reklam sunucularına yönlendirerek maskelenmemiş kullanıcı IP adresini kurtarmanıza olanak tanır.

Üçüncü taraf isteklerinde, tarayıcı ve OS özellikleri ile ağ yapılandırmaları IP adreslerini maskeleyebilir. Bu maskeleme, reklam gelirinizi, coğrafi hedeflemenizi ve geçersiz trafik (IVT) tespitini etkileyebilir.

CDN'niz, alanınıza gelen tüm isteklerde kullanıcının maskelenmemiş istemci IP'sini alır. Bu özellik aşağıdaki avantajları sağlar:

İstemci tarafı kod değişikliği yok: JavaScript'i düzenlemez veya parametreleri manuel olarak iletmezsiniz. Google Yayıncı Etiketi (GPT), Google Ad Manager ayarlarınızdan yapılandırılmış yolu okur ve kurtarma isteğini eşzamansız olarak çalıştırır.
Daha az ek yük: İstek hafiftir, sayfa görüntüleme oturumu başına yerel olarak önbelleğe alınır ve reklam alanı tanımlarıyla birlikte eşzamansız olarak çalışır.
Şifrelenmiş yük: Bu özellik, varsayılan olarak kullanıcının IP adresini şifrelenmiş yük olarak döndürür.

Bu sayfada, birinci taraf reklam yayın yolunu tercih ettiğiniz CDN'ye göre yapılandırma konusu ele alınmaktadır.

Ön koşullar

CDN'nizi yapılandırmadan önce aşağıdakileri yapın:

Ad Manager hesabınızda bir yayınlama yolu belirtin (ör. /adserver/). Yolu belirtmek için 1. yöntem: Birinci taraf reklam yayın yolu bölümündeki adımları uygulayın.
- Yayın yolunuzun benzersiz olduğundan ve gönderdiğiniz hiçbir trafiğin bu yolu kullanmadığından emin olun.
Aşağıdaki öğelere sahip olun veya bunları ayarlayın:
- Hedef ana makine veya kaynak: securepubads.g.doubleclick.net
- Hedef yol: /pagead/fpm
- Protokol: Varsayılan bağlantı noktası 443 olan HTTPS.
- Üstbilgiler: Üstbilgiyi Host: securepubads.g.doubleclick.net olarak ayarlayın.
- Önbelleğe alma: CDN'nizi bir rota için önbelleğe almayı atlayacak şekilde yapılandırın. Örneğin, önbellek politikalarını önbelleği veya Cache-Control: no-store başlığını atlayacak şekilde ayarlayın.
CDN'niz Cloudflare ise kaynak kuralı oluşturmak için Cloudflare Enterprise katmanına sahip olmanız gerekir.

CDN'nizi yapılandırma

CDN'nizi veya ters proxy'nizi, yapılandırılmış yolunuzla eşleşen istekleri Google reklam sunucularına yönlendirecek şekilde yapılandırın. Tercih ettiğiniz CDN'yi seçin:

Cloudflare

Aşağıdaki değerleri kullanarak kontrol panelinde bir kural oluşturun:
- Özel filtre ifadesi: Şunları ekleyin:
  - Alan: URI Path
  - Operatör: starts with
  - Değer: yolunuz (ör. /adserver/).
- Host Header Override (Ana Makine Başlığını Geçersiz Kılma): Rewrite to'yu (Şununla yeniden yaz:) seçin ve hedef ana makineyi securepubads.g.doubleclick.net ekleyin.
- DNS Geçersiz Kılma: Şununla geçersiz kıl'ı seçin ve hedef ana makineyi ekleyin securepubads.g.doubleclick.net.
Aşağıdaki değerleri kullanarak kontrol panelinde bir URL kuralı yeniden yazma işlemi oluşturun:
- Özel filtre ifadesi: Şunları ekleyin:
  - Alan: URI Path
  - Operatör: starts with
  - Değer: yolunuz (ör. /adserver/).
- Yol: Şuna yeniden yaz > Statik > seçeneğini belirleyin ve /pagead/fpm hedef yolunu ekleyin.
- Sorgu: Koru'yu seçin.

Amazon CloudFront

Kaynak ayarları bölümündeki adımları aşağıdaki değerlerle uygulayın:
- Kaynak alan adı: securepubads.g.doubleclick.net
- Protocol (Protokol): HTTPS
İşlev oluşturma bölümündeki adımları uygulayın ve aşağıdaki örneği ekleyin:
```
function handler(event) {
    var request = event.request;
    request.uri = '/pagead/fpm';
    return request;
}
```
Bu örnekte, gelen istek etkinliği alınır, URI hedef yola atanır ve istek döndürülür.

Save changes'ı (Değişiklikleri kaydet) tıklayın, Publish (Yayınla) sekmesine gidin ve Publish function'ı (İşlevi yayınla) tıklayın.
Aşağıdaki değerleri kullanarak Konsolda dağıtımı güncelleme adımlarını uygulayın:
- Yol deseni: Yolunuz (ör. /adserver/*).
- Kaynak ve kaynak grupları: Hedef ana makine, securepubads.g.doubleclick.net.
- Önbellek politikası: CachingDisabled seçeneğini belirleyin.
- Origin request policy (Kaynak isteği politikası): AllViewerExceptHostHeader seçeneğini belirleyin.
- İşlev ilişkilendirmeleri:
  - Viewer request (Görüntüleyici isteği): CloudFront Function'ı (CloudFront İşlevi) seçin ve işlevinizin adını ekleyin.

Fastly

Aşağıdaki değerleri kullanarak Ana makine ekleme adımlarını uygulayın:
- Address (Adres): Hedef ana makine, securepubads.g.doubleclick.net
- Port (Bağlantı noktası): Varsayılan bağlantı noktası, 443.
- TLS etkinleştirilsin mi?: Evet
  - Sertifika ana makine adı: securepubads.g.doubleclick.net
    - Match the SNI hostname to the Certificate Name (SNI ana makine adını Sertifika Adı ile eşleştir) seçeneğini belirleyin.
  - SNI ana makine adı: securepubads.g.doubleclick.net
  - Geçersiz kılma ana makinesi: securepubads.g.doubleclick.net
Aşağıdaki örneği kullanarak VCL snippet'leri oluşturma adımlarını uygulayın:
```
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);
}
```
Aşağıdakini değiştirin:
- NAME: Ana makinenin adı (ör. Google_GAM_FPM_Backend).
- PATH: yolunuz, örneğin, /adserver/.

Google Cloud

Aşağıdaki değerleri kullanarak NEG ve internet uç noktası oluşturma adımlarını uygulayın:
- Network endpoint group type (Ağ uç noktası grubu türü): Internet NEG (Global) (İnternet NEG (Global)) seçeneğini belirleyin.
- Varsayılan bağlantı noktası: 443
- New network endpoint (Yeni ağ uç noktası): Fully qualified domain name (FQDN) and port'u (Tam etki alan adı (FQDN) ve bağlantı noktası) seçin.
- FQDN: Hedef ana makineyi (securepubads.g.doubleclick.net) ekleyin.
Global arka uç hizmetinizi oluşturun ve aşağıdaki değerlerle özel istek başlıklarını yapılandırın:
- Backend type (Arka uç türü): Internet network endpoint group'u (İnternet ağ uç noktası grubu) seçin.
- Protocol (Protokol): HTTPS'yi seçin.
  - Üstbilgi adı: Host
  - Üstbilgi değeri: Hedef ana makineyi ekleyin, securepubads.g.doubleclick.net.
URL eşlemelerini yapılandırma bölümündeki adımları uygulayın.
Yönlendirme kuralları bölümünde, alt alan adınızla eşleşen üretim ana makinesi kuralınızı bulun.

Yol eşleştiricileri routeRules yapılandırmasıyla güncelleyin:
```
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
```
Aşağıdakini değiştirin:
- BACKEND_NAME: 2. adımda oluşturduğunuz arka uç hizmetinin adı (ör. gam-fpm-backend-service).
- DEFAULT_BACKEND: Web sitenizi barındıran varsayılan arka uç hizmeti.
  - Web sitenizi Cloud Storage'da barındırıyorsanız defaultService alanının kaynak yolundaki backendServices değerini backendBuckets parametresiyle değiştirin.
- NAME: Yol eşleştiricinin adı (ör. gam-fpm-matcher).
- PATH: yolunuz, örneğin, /adserver/.
- PROJECT_ID: Proje kimliğiniz.

Uygulamanızı test etme

CDN'nizin isteği proxy'ye ilettiğini ve IP adresini aktardığını doğrulamak için curl komutunu kullanarak bir test çalıştırın:

curl -i https://example.comPATH

PATH ifadesini kendi yolunuzla (ör. /adserver/) değiştirin.

İşlem başarılı olursa aşağıdaki çıkışı alırsınız:

HTTP durumu: 200 OK
Yanıt içeriği: Google arka uç sunucularından gelen ve varsayılan olarak şifrelenmiş bir IP jetonu içeren yük.

Uygulamanızla ilgili sorunları giderme

Bu bölümde, CDN'nizdeki birinci taraf reklam yayın yolu uygulamanızla ilgili sorunları gidermeye yönelik iş akışları ele alınmaktadır.

Aşağıdaki tabloda sorunlar, nedenleri ve sorun giderme çözümleri ayrıntılı olarak açıklanmıştır:

Sorun	Neden	Çözüm
CDN'nizden HTTP 404 veya 502 durum kodunu alıyorsunuz	Yol yeniden yazma etkin değil veya `Host` üstbilgisi eksik.	Yeniden yazma eşlemelerinizin `/pagead/fpm` hedef yoluna yönlendirdiğini ve `Host` üstbilgisinin hedef ana makineye (`securepubads.g.doubleclick.net`) geçersiz kılındığını doğrulayın.
IP adresi, reklam isteklerinde güncellenmez.	CDN proxy'sinde önbelleğe alma etkinleştirildi	Rotadaki önbellek politikasını `CachingDisabled` politikasına veya `Cache-Control: no-store` üstbilgisine ayarladığınızdan emin olun. Her istemcinin, kendi IP adresini değerlendirmek için arka uç hizmetine ulaşması gerekir.
SSL veya TLS el sıkışma hatası	Arka uç kaynak bağlantısında SNI uyuşmazlığı	CDN'nizi, TLS SNI uzantısında hedef ana makineyi (`securepubads.g.doubleclick.net`) gönderecek şekilde yapılandırdığınızdan emin olun.
Reklam isteğinde `ips` parametresi eksik.	Ad Manager yolu, CDN yoluyla eşleşmiyor	Ad Manager kullanıcı arayüzündeki Genel Ayarlar sayfasına girilen yolun, CDN'nizde yapılandırılan yolla eşleştiğini doğrulayın. Ayrıntılar için Maskelenmemiş yayıncı tarafından verilen IP'yi iletme (Beta) başlıklı makaleyi inceleyin.