Konfigurasi pra-penargetan
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Bidder dapat menggunakan resource pretargetingConfigs hanya untuk menerima permintaan
bid untuk tayangan yang cocok dengan kriteria penargetannya.Anda dapat memiliki hingga
10 konfigurasi pra-penargetan sekaligus.
Setiap konfigurasi pra-penargetan mendistribusikan permintaan bid di semua endpoint.
Permintaan bid tidak selalu didistribusikan secara merata di semua endpoint. Misalnya, konfigurasi pra-penargetan untuk ID geografis tertentu di region tertentu mungkin memiliki lebih sedikit kecocokan di lokasi perdagangan yang lebih jauh dari region tersebut. Endpoint di dekat lokasi perdagangan yang lebih jauh tersebut mungkin menerima
lebih sedikit permintaan bid.
Praktik terbaik
Untuk menerima permintaan bid, Anda harus membuat setidaknya satu konfigurasi pra-penargetan. Berikut beberapa tips untuk mengelola konfigurasi pra-penargetan:
- Cakupan
Pra-penargetan itu seperti pemfilteran. Anda harus menggunakan kriteria pra-penargetan untuk memfilter
permintaan bid ke permintaan yang relevan dengan kasus penggunaan Anda. Jika tidak menetapkan kriteria pra-penargetan, Anda dapat menerima permintaan bid untuk semua tayangan.
Jika tidak menerima cukup permintaan bid yang terkait dengan konfigurasi pra-penargetan yang
ditentukan, sebaiknya perluas kriteria pra-penargetan.
- Logika
Nilai di kolom penargetan tingkat teratas diproses dengan OR yang logis. Artinya,
Anda dapat menerima permintaan bid yang memiliki setidaknya salah satu nilai yang
Anda tentukan di kolom tingkat teratas. Misalnya, jika konfigurasi pra-penargetan Anda memiliki languageCodes nilai en, de, dan sv, Anda mungkin menerima permintaan bid dengan en, de, atau sv sebagai bahasa yang terdeteksi.
Kolom yang berbeda diproses dengan AND yang logis. Anda hanya menerima permintaan bid yang memiliki kecocokan untuk setidaknya satu nilai di setiap kolom pra-penargetan yang Anda tetapkan. Misalnya, jika konfigurasi Anda memiliki languageCodes nilai en,
de, dan sv, serta nilai includedPlatforms PERSONAL_COMPUTER, Anda hanya akan menerima
permintaan bid yang memiliki bahasa terdeteksi dari en, de, atau sv dan
jenis perangkat PERSONAL_COMPUTER.
Karena AND yang logis di seluruh kolom pra-penargetan, Anda tidak dapat menyertakan kriteria yang bertentangan. Misalnya, menyertakan nilai yang sama dalam includedIds
dan excludedIds dalam kriteria NumericTargetingDimensions akan menghasilkan
error.
- Tumpang-tindih
Permintaan bid dapat memenuhi syarat untuk beberapa konfigurasi pra-penargetan.
Anda dapat membuat hingga 10 konfigurasi pra-penargetan untuk menargetkan berbagai
jenis inventaris. Konfigurasi pra-penargetan bisa tumpang-tindih, sehingga satu permintaan bid
mungkin memenuhi syarat untuk beberapa konfigurasi pra-penargetan. Dalam hal
ini, kolom billing_id permintaan bid berisi billingId dari
setiap konfigurasi yang berlaku. Jika beberapa ID penagihan ditemukan dalam permintaan
bid, Anda harus menentukan ID penagihan yang digunakan untuk mengajukan bid di kolom
billing_id respons bid.
ID geografis
Beberapa ID geografis tidak dapat ditargetkan karena alasan kebijakan. Misalnya, beberapa
wilayah dengan populasi kecil tidak dapat ditargetkan karena akan melanggar
kebijakan privasi kami. Kebijakan kami dapat berubah sewaktu-waktu. Jika Anda menentukan ID geografis dalam geoTargeting konfigurasi pra-penargetan yang menjadi tidak valid di lain waktu, ID tersebut akan muncul di kolom invalidGeoIds pada saat itu. ID geografis di bawah invalidGeoIds tidak memengaruhi penargetan. Jika
ID visual di invalidGeoIds menjadi valid, ID tersebut akan ditambahkan ke kolom geoTargeting konfigurasi pra-penargetan Anda.
File geo-table.csv mencantumkan ID geografis yang dapat ditargetkan, dan diperbarui secara berkala saat ID ditambahkan dan dihapus.
Jumlah permintaan bid
Anda harus mengonfigurasi QPS maksimum untuk endpoint bidder, dan mengizinkan Sistem Kuota Pemanggilan untuk mengelola traffic yang dikirim ke endpoint Anda untuk setiap konfigurasi pra-penargetan.
Berikut adalah kasus ekstrem yang mungkin akan berguna jika mengelola QPS maksimum di
tingkat konfigurasi pra-penargetan dengan maximumQps:
- Menerima terlalu banyak permintaan
- Jika Sistem Kuota Pemanggilan mengirimkan jumlah permintaan bid
yang sangat besar ke endpoint bidder untuk konfigurasi pra-penargetan tertentu, Anda dapat
menggunakan
maximumQps untuk menyesuaikan jumlah permintaan secara manual.
- Menguji konfigurasi untuk inventaris baru
- Jika mencoba mendukung inventaris baru, seperti format materi iklan baru,
Anda dapat menerapkan konfigurasi pra-penargetan yang hanya menargetkan inventaris tersebut
dengan
maximumQps yang rendah.
Untuk inventaris yang ditargetkan oleh beberapa konfigurasi pra-penargetan,
permintaan bid dikirim ke endpoint bidder, termasuk billingId
untuk setiap konfigurasi, selama setidaknya salah satu konfigurasi belum
mencapai batas maximumQps.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-25 UTC.
[null,null,["Terakhir diperbarui pada 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."]]
