プレターゲティング設定
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
ビッダーは pretargetingConfigs
リソースを使用して、ターゲティング条件と一致するインプレッションに対する入札リクエストのみを受信できます。一度に最大 10 個のプレターゲティング設定を作成できます。
各プレターゲティング設定では、入札リクエストがすべてのエンドポイントに分配されます。
入札リクエストは、すべてのエンドポイントに均等に割り当てられるとは限りません。たとえば、特定の地域で特定の地域 ID に対するプレターゲティング設定を使用する場合、その地域から遠く離れた取引ロケーションでの一致数が少なくなる場合があります。そう遠く離れた取引ロケーションに近いエンドポイントは、受信する入札リクエストの数が少なくなる可能性があります。
ベスト プラクティス
入札リクエストを受信するには、少なくとも 1 つのプレターゲティング設定を作成する必要があります。プレターゲティング設定を管理する際のヒントをいくつか紹介します。
- 範囲
プレターゲティングはフィルタリングのようなものです。プレターゲティング条件を使用して、入札リクエストをユースケースに関連するものだけに絞り込みます。プレターゲティング条件を設定しない場合は、すべてのインプレッションの入札リクエストを受信できます。
特定のプレターゲティング設定に関連する入札リクエストが十分でない場合は、プレターゲティング条件の範囲を広げることをおすすめします。
- ロジック
トップレベルのターゲティング フィールドの値は、論理 OR
で処理されます。つまり、最上位のフィールドで指定した値を少なくとも 1 つ含む入札リクエストを受信できます。たとえば、プレターゲティング設定に languageCodes
の値 en
、de
、sv
が含まれている場合、検出された言語として en
、de
、sv
の入札リクエストを受け取ることがあります。
さまざまなフィールドが論理 AND
で処理されます。設定したすべてのプレターゲティング フィールドで、1 つ以上の値に一致する入札リクエストのみが受信されます。たとえば、languageCodes
の値が en
、de
、sv
で、includedPlatforms
の値が PERSONAL_COMPUTER
の場合、言語が en
、de
、または sv
で、デバイスタイプが PERSONAL_COMPUTER
の入札リクエストのみを受け取ります。
プレターゲティング フィールド全体で論理 AND
が使用されるため、矛盾する条件を含めることはできません。たとえば、NumericTargetingDimensions
条件の includedIds
と excludedIds
に同じ値を指定すると、エラーが発生します。
- 重複撮影
入札リクエストは、複数のプレターゲティング設定に使用できます。
最大 10 個のプレターゲティング設定を作成して、さまざまな種類の広告枠をターゲットに設定できます。プレターゲティング設定が重複する可能性があるため、1 つの入札リクエストが複数のプレターゲティング設定の対象となる場合があります。この場合、入札リクエストの billing_id
フィールドに該当する各設定の billingId
が含まれます。入札リクエストで複数の請求 ID が見つかった場合は、入札する請求 ID を入札レスポンスの billing_id
フィールドに指定する必要があります。
地域 ID
ポリシー上の理由により、一部の地域 ID はターゲットに設定できません。たとえば人口の少ない地域は、Google のプライバシー ポリシーに違反するため、ターゲットに設定することはできません。ポリシーは変更されることがあります。プレターゲティング設定の geoTargeting
で指定した地域 ID が後で無効になっても、その ID はその時点で invalidGeoIds
フィールドに表示されます。invalidGeoIds
未満の地域 ID はターゲティングに影響しません。invalidGeoIds
の Goegraphic ID が有効になると、プレターゲティング設定の geoTargeting
フィールドに追加されます。
geo-table.csv ファイルは、ターゲットに設定可能な地域 ID をリストアップします。また、ID が追加または削除されるたびに更新されます。
入札リクエスト数
ビッダーのエンドポイントの最大 QPS を設定し、プレターゲティング設定ごとにエンドポイントに送信されるトラフィックをコールアウト割り当てシステムで管理できるようにする必要があります。
次のような場合は、maximumQps
を使用してプレターゲティング設定レベルで最大 QPS を管理すると便利な場合があります。
- 受信するリクエストが多すぎる
- 特定のプレターゲティング設定で、コールアウト割り当てシステムからビッダーのエンドポイントに大量の入札リクエストが送信されている場合は、
maximumQps
を使ってリクエスト数を手動で調整できます。
- 新しいインベントリの構成をテストする
- 新しいクリエイティブ フォーマットなど新しい広告枠をサポートする場合は、
maximumQps
を小さくして、その広告枠のみをターゲットとするプレターゲティング設定を実装できます。
複数のプレターゲティング設定の対象となっている広告枠の場合、入札リクエストはビッダーのエンドポイント(各設定の billingId
を含む)に送信されます。ただし、設定の少なくとも 1 つが maximumQps
の上限に達していない場合に限ります。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 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."]]