Ön hedefleme yapılandırmaları
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Teklif verenler, yalnızca hedefleme ölçütleriyle eşleşen gösterimler için teklif isteklerini almak üzere pretargetingConfigs kaynağını kullanabilir.Tek seferde en fazla 10 ön hedefleme yapılandırmanız olabilir.
Her ön hedefleme yapılandırması, teklif isteklerini tüm uç noktalar arasında dağıtır.
Teklif istekleri her zaman tüm uç noktalar arasında eşit olarak dağıtılmaz. Örneğin, belirli bir bölgedeki belirli coğrafi kimliklere yönelik bir ön hedefleme yapılandırması, söz konusu bölgeden daha uzaktaki alım satım konumlarında daha az eşleşme olabilir. Bu daha uzaktaki işlem konumlarının yakınındaki uç noktalar daha az teklif isteği alabilir.
En iyi uygulamalar
Teklif istekleri almak için en az bir ön hedefleme yapılandırması oluşturmanız gerekir. Aşağıda, ön hedefleme yapılandırmalarınızı yönetmeyle ilgili bazı ipuçları verilmiştir:
- Kapsam
Ön hedefleme, filtrelemeye benzer. Teklif isteklerini kullanım alanınızla alakalı isteklere göre filtrelemek için ön hedefleme ölçütlerini kullanmalısınız. Ön hedefleme ölçütü belirlemezseniz tüm gösterimler için teklif istekleri alabilirsiniz.
Belirli bir ön hedefleme yapılandırmasıyla ilgili yeterli teklif isteği almıyorsanız ön hedefleme ölçütlerinizi genişletmek isteyebilirsiniz.
- Mantık
Üst düzey hedefleme alanlarındaki değerler, mantıksal OR ile işlenir. Diğer bir deyişle, üst düzey alanda belirttiğiniz değerlerden en az birini içeren teklif istekleri alabilirsiniz. Örneğin, ön hedefleme yapılandırmanız en, de ve sv languageCodes değerlerine sahipse algılanan dil olarak en, de veya sv ile teklif istekleri alabilirsiniz.
Farklı alanlar mantıksal AND ile işlenir. Yalnızca ayarladığınız her ön hedefleme alanında en az bir değerle eşleşen teklif istekleri alırsınız. Örneğin, yapılandırmanızda languageCodes değerleri en,
de ve sv ve includedPlatforms değeri PERSONAL_COMPUTER varsa yalnızca algılanan dil en, de veya sv olan ve cihaz türü PERSONAL_COMPUTER olan teklif istekleri alırsınız.
Ön hedefleme alanlarında mantıksal AND olması nedeniyle çelişen ölçütleri ekleyemezsiniz. Örneğin, bir NumericTargetingDimensions ölçütüne includedIds ve excludedIds için aynı değerin dahil edilmesi hataya neden olur.
- Çakışma
Teklif istekleri, birden fazla ön hedefleme yapılandırması için uygun olabilir.
Farklı envanter türlerini hedeflemek için 10 adede kadar ön hedefleme yapılandırması oluşturabilirsiniz. Ön hedefleme yapılandırmaları çakışabilir. Bu nedenle tek bir teklif isteği, birden fazla ön hedefleme yapılandırması için uygun olabilir. Bu durumda, teklif isteğinin billing_id alanı geçerli her yapılandırmanın billingId değerini içerir. Teklif isteğinde birden fazla faturalandırma kimliği bulunursa teklif yanıtının billing_id alanında hangi faturalandırma kimliğine teklif verdiğinizi belirtmeniz gerekir.
Coğrafi kimlikler
Bazı coğrafi kimlikler, politikayla ilgili nedenlerle hedeflenemez. Örneğin, nüfusu az olan bazı bölgeler gizlilik politikamızı ihlal ettiği için hedeflenemez. Politikalarımız değiştirilebilir. Ön hedefleme yapılandırmanızın geoTargeting öğesinde daha sonra geçersiz hale gelen bir coğrafi kimlik belirtirseniz kimlik o anda invalidGeoIds alanının altında görünür. invalidGeoIds altındaki coğrafi kimliklerin hedefleme üzerinde etkisi yoktur. invalidGeoIds içindeki bir goegrafik kimlik geçerli hale gelirse ön hedefleme yapılandırmanızın geoTargeting alanına eklenir.
geo-table.csv dosyası, hedeflenebilir coğrafi kimlikleri listeler ve kimlikler eklenip kaldırıldıktan sonra düzenli olarak güncellenir.
Teklif isteği sayısı
Teklif veren uç noktalarınız için maksimum QPS'yi yapılandırmanız ve Açıklama Metni Kota Sisteminin, ön hedefleme yapılandırmalarınızın her biri için uç noktalarınıza gönderilen trafiği yönetmesine izin vermeniz gerekir.
maximumQps ile maksimum QPS'yi ön hedefleme yapılandırması düzeyinde yönetmenin yararlı olabileceği uç durumlar aşağıda verilmiştir:
- Çok fazla istek alıyorsunuz
- Açıklama Metni Kota Sistemi, belirli bir ön hedefleme yapılandırması için teklif veren uç noktalarına anormal derecede çok sayıda teklif isteği gönderiyorsa istek sayısını manuel olarak ayarlamak için
maximumQps kullanabilirsiniz.
- Yeni envanter için bir yapılandırmayı test etme
- Yeni bir reklam öğesi biçimi gibi yeni bir envanteri desteklemeye çalışıyorsanız yalnızca
maximumQps değeri düşük olan envanteri hedefleyen bir ön hedefleme yapılandırması uygulayabilirsiniz.
Birden fazla ön hedefleme yapılandırmasının hedeflediği envanterde, yapılandırmalardan en az biri maximumQps sınırına ulaşmadığı sürece teklif istekleri, her yapılandırma için billingId dahil olmak üzere teklif verenin uç noktalarına gönderilir.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-25 UTC.
[null,null,["Son güncelleme tarihi: 2025-07-25 UTC."],[[["\u003cp\u003eUse pretargeting configurations to filter bid requests and receive only relevant impressions, with the ability to create up to 10 configurations.\u003c/p\u003e\n"],["\u003cp\u003ePretargeting criteria use logical \u003ccode\u003eOR\u003c/code\u003e within fields and logical \u003ccode\u003eAND\u003c/code\u003e across fields, allowing for flexible but specific targeting.\u003c/p\u003e\n"],["\u003cp\u003eBid requests can match multiple pretargeting configurations, requiring bidders to specify the desired billing ID in their bid response.\u003c/p\u003e\n"],["\u003cp\u003eSome geographic IDs may be untargetable for policy reasons, and the \u003ccode\u003egeo-table.csv\u003c/code\u003e file provides a list of valid targetable IDs.\u003c/p\u003e\n"],["\u003cp\u003eManage bid request traffic using the Callout Quota System and \u003ccode\u003emaximumQps\u003c/code\u003e for specific pretargeting configurations when necessary.\u003c/p\u003e\n"]]],["Bidders use `pretargetingConfigs` to filter bid requests, receiving only those matching their criteria; up to 10 configurations are allowed. These configurations filter requests using logical `OR` within fields and logical `AND` across fields. Bid requests can match multiple configurations, identified by `billingId` in the request. Geographic targeting may have restrictions and invalid IDs are listed under `invalidGeoIds`. You can set `maximumQps` per configuration to manage traffic volume. At least one configuration is required to receive bid requests.\n"],null,["# Pretargeting configurations\n\nBidders can use the `pretargetingConfigs` resource to receive only bid\nrequests for impressions that match their targeting criteria.You can have up to\n10 pretargeting configurations at once.\n\nEach pretargeting configuration distributes bid requests across all endpoints.\nBid requests aren't always distributed evenly across all endpoints. For example,\na pretargeting configuration for specific geographic IDs in a given region might\nhave fewer matches in [trading\nlocations](/authorized-buyers/rtb/peer-guide#trading-locations) that are farther\nfrom that region. Endpoints near those farther trading locations might receive\nfewer bid requests.\n\nBest practices\n--------------\n\nIn order to receive bid requests, you must create at least one\npretargeting configuration. Here are some tips for managing your pretargeting\nconfigurations:\n\nScope\n\n: Pretargeting is like filtering. You should use pretargeting criteria to filter\n bid requests to those that are relevant to your use case. If you don't set any\n pretargeting criteria, you can receive bid requests for all impressions.\n\n If you aren't receiving enough bid requests related to a given pretargeting\n configuration, you might want to broaden your pretargeting criteria.\n\nLogic\n\n: Values in top-level targeting fields are processed with logical `OR`. This\n means you can receive bid requests that have at least one of the values you\n specify in the top-level field. For example, if your pretargeting\n configuration has `languageCodes` values `en`, `de`, and `sv`, you might receive\n bid requests with `en`, `de`, or `sv` as the detected language.\n\n Different fields are processed with logical `AND`. You only receive bid\n requests that have a match for at least one value in every pretargeting field\n you set. For example, if your configuration has `languageCodes` values `en`,\n `de`, and `sv`, and `includedPlatforms` value `PERSONAL_COMPUTER`, you receive\n only bid requests that have a detected language of `en`, `de`, or `sv` and a\n device type of `PERSONAL_COMPUTER`.\n\n Due to the logical `AND` across pretargeting fields, you can't include\n contradictory criteria. For example, including the same value in `includedIds`\n and `excludedIds` in a `NumericTargetingDimensions` criteria results in an\n error.\n\nOverlap\n\n: Bid requests can be eligible for multiple pretargeting configurations.\n\n You can create up to 10 pretargeting configurations to target different\n kinds of inventory. Pretargeting configurations can overlap, so a single bid\n request might be eligible for multiple pretargeting configurations. In this\n case, the bid request's `billing_id` field contains the `billingId` of\n each applicable configuration. If multiple billing IDs are found in the bid\n request, you must specify which billing ID you're bidding on in the bid\n response's `billing_id` field.\n\nGeographic IDs\n--------------\n\nSome geographic IDs aren't targetable for policy reasons. For example, some\nregions with small populations can't be targeted because it would violate our\nprivacy policy. Our policies are subject to change. If you specify\na geographic ID in your pretargeting configuration's `geoTargeting` that becomes\ninvalid at a later date, the ID appears under the `invalidGeoIds` field at that\ntime. Geographic IDs under `invalidGeoIds` have no impact on targeting. If a\ngoegraphic ID in `invalidGeoIds` becomes valid, it's added to your pretargeting\nconfiguration's `geoTargeting` field.\n\nThe\n[geo-table.csv](//storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv)\nfile lists targetable geographic IDs, and is updated periodically as IDs are\nadded and removed.\n\nBid request count\n-----------------\n\nYou should configure the maximum QPS for your bidder endpoints,\nand allow the [Callout Quota System](/authorized-buyers/rtb/callout-quota-system)\nto manage the traffic sent to your endpoints for each of your pretargeting\nconfigurations.\n\nHere are edge cases where managing maximum QPS at the\npretargeting configuration level with `maximumQps` might be useful:\n\nReceiving too many requests\n: If the Callout Quota System is sending an unusually large number of bid\n requests to bidder endpoints for a given pretargeting configuration, you can\n use `maximumQps` to manually adjust the number of requests.\n\nTesting a configuration for new inventory\n: If you're trying to support new inventory, like a new creative format,\n you can implement a pretargeting configuration targeting only that inventory\n with a low `maximumQps`.\n\nFor inventory that's targeted by multiple pretargeting configurations,\nbid requests are sent to the bidder's endpoints, including the `billingId`\nfor each configuration, as long as at least one of the configurations hasn't\nreached its `maximumQps` limit."]]
