사전 타겟팅 설정
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
입찰자는 pretargetingConfigs 리소스를 사용하여 타겟팅 기준과 일치하는 노출에 대한 입찰 요청만 수신할 수 있습니다.한 번에 최대 10개의 사전 타겟팅 구성을 설정할 수 있습니다.
각 사전 타겟팅 구성은 모든 엔드포인트에 입찰 요청을 분배합니다.
입찰 요청이 항상 모든 엔드포인트에 균등하게 분산되는 것은 아닙니다. 예를 들어 특정 지역에서 특정 지리적 ID에 대한 사전 타겟팅 구성은 해당 지역에서 더 먼 거래 위치에서 일치하는 항목이 더 적을 수 있습니다. 더 먼 거래 위치 근처의 엔드포인트는 더 적은 입찰 요청을 받을 수 있습니다.
권장사항
입찰 요청을 받으려면 사전 타겟팅 구성을 하나 이상 만들어야 합니다. 다음은 사전 타겟팅 구성을 관리하는 방법에 대한 팁입니다.
- 범위
사전 타겟팅은 필터링과 같습니다. 사전 타겟팅 기준을 사용하여 사용 사례와 관련된 입찰 요청을 필터링해야 합니다. 사전 타겟팅 기준을 설정하지 않으면 모든 노출에 대해 입찰 요청을 받을 수 있습니다.
특정 사전 타겟팅 구성과 관련된 입찰 요청을 충분히 받지 못하는 경우 사전 타겟팅 기준을 넓히는 것이 좋습니다.
- 로직
최상위 타겟팅 필드의 값은 논리적 OR로 처리됩니다. 즉, 최상위 필드에 지정한 값이 하나 이상 포함된 입찰 요청을 수신할 수 있습니다. 예를 들어 사전 타겟팅 구성에 languageCodes 값 en, de, sv이 있으면 감지된 언어로 en, de 또는 sv가 포함된 입찰 요청을 수신할 수 있습니다.
서로 다른 필드가 논리적 AND로 처리됩니다. 설정한 모든 사전 타겟팅 필드에서 하나 이상의 값과 일치하는 입찰 요청만 수신합니다. 예를 들어 구성에 languageCodes 값 en, de, sv와 includedPlatforms 값 PERSONAL_COMPUTER가 있으면 감지된 언어가 en, de 또는 sv이고 기기 유형이 PERSONAL_COMPUTER인 입찰 요청만 수신합니다.
사전 타겟팅 필드 간의 논리적 AND로 인해 상충되는 기준을 포함할 수 없습니다. 예를 들어 NumericTargetingDimensions 기준의 includedIds와 excludedIds에 동일한 값을 포함하면 오류가 발생합니다.
- 중복
입찰 요청은 여러 개의 사전 타겟팅 구성에 적용될 수 있습니다.
최대 10개의 사전 타겟팅 구성을 만들어 다양한 종류의 인벤토리를 타겟팅할 수 있습니다. 사전 타겟팅 구성은 중복될 수 있으므로 단일 입찰 요청이 여러 사전 타겟팅 구성에 적합할 수 있습니다. 이 경우 입찰 요청의 billing_id 필드에는 적용 가능한 각 구성의 billingId가 포함됩니다. 입찰 요청에 여러 결제 ID가 있으면 입찰 응답의 billing_id 필드에서 입찰할 결제 ID를 지정해야 합니다.
지역 ID
일부 지역 ID는 정책상의 이유로 타겟팅할 수 없습니다. 예를 들어 인구가 적은 일부 지역은 Google의 개인정보처리방침을 위반하므로 타겟팅할 수 없습니다. Google 정책은 변경될 수 있습니다. 사전 타겟팅 구성의 geoTargeting에 지정한 지리적 ID가 나중에 무효화되는 경우 해당 ID가 invalidGeoIds 필드 아래에 표시됩니다. invalidGeoIds 아래에 있는 지역 ID는 타겟팅에 영향을 주지 않습니다. invalidGeoIds의
goegraphic ID가 유효해지면 사전 타겟팅 구성의 geoTargeting 필드에
추가됩니다.
geo-table.csv 파일은 타겟팅할 수 있는 지역 ID 목록을 제공하며 ID가 추가 및 삭제될 때마다 주기적으로 업데이트됩니다.
입찰 요청 수
입찰자 엔드포인트의 최대 QPS를 구성하고
콜아웃 할당량 시스템이 각 사전 타겟팅
구성에서 엔드포인트로 전송되는 트래픽을 관리할 수 있도록
허용해야 합니다.
다음은 maximumQps를 사용하여 사전 타겟팅 구성 수준에서 최대 QPS를 관리하는 것이 유용할 수 있는 특이 사례입니다.
- 너무 많은 요청을 받음
- 콜아웃 할당량 시스템이 지정된 사전 타겟팅 구성에 대해 비정상적으로 많은 수의 입찰 요청을 입찰자 엔드포인트에 전송하는 경우
maximumQps를 사용하여 요청 수를 수동으로 조정할 수 있습니다.
- 새 인벤토리의 구성 테스트
- 새 광고 소재 형식과 같은 새 인벤토리를 지원하려는 경우
maximumQps이 낮은 인벤토리만 타겟팅하는 사전 타겟팅 구성을 구현할 수 있습니다.
여러 사전 타겟팅 구성으로 타겟팅된 인벤토리의 경우 하나 이상의 구성이 maximumQps 한도에 도달하지 않았다면 각 구성의 billingId를 포함한 입찰 요청이 입찰자의 엔드포인트로 전송됩니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 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."]]
