تنظیمات پیش هدف گذاری
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
مناقصه‌گران می‌توانند از منبع pretargetingConfigs استفاده کنند تا فقط درخواست‌های پیشنهادی را برای نمایش‌هایی دریافت کنند که با معیارهای هدف‌یابی آنها مطابقت دارد.
هر پیکربندی پیش هدف‌یابی، درخواست‌های پیشنهادی را در تمام نقاط پایانی توزیع می‌کند. درخواست های پیشنهادی همیشه به طور مساوی در تمام نقاط پایانی توزیع نمی شوند. برای مثال، یک پیکربندی پیش‌هدف‌یابی برای شناسه‌های جغرافیایی خاص در یک منطقه خاص ممکن است در مکان‌های تجاری دورتر از آن منطقه، مطابقت کمتری داشته باشد. نقاط پایانی نزدیک به آن مکان‌های تجاری دورتر ممکن است درخواست‌های پیشنهادی کمتری دریافت کنند.
بهترین شیوه ها
برای دریافت درخواست های مناقصه، باید حداقل یک پیکربندی پیش هدف گذاری ایجاد کنید. در اینجا چند نکته برای مدیریت تنظیمات پیش هدف گذاری شما وجود دارد:
- محدوده
پیش هدف گذاری مانند فیلتر کردن است. شما باید از معیارهای پیش‌هدف‌گذاری برای فیلتر کردن درخواست‌های مناقصه به موارد مرتبط با مورد استفاده شما استفاده کنید. اگر هیچ معیاری برای پیش‌هدف‌گذاری تعیین نکرده‌اید، می‌توانید درخواست‌های پیشنهادی را برای همه نمایش‌ها دریافت کنید.
اگر درخواست‌های پیشنهادی کافی در رابطه با پیکربندی پیش‌هدف‌گذاری معین دریافت نمی‌کنید، ممکن است بخواهید معیارهای پیش‌هدف‌یابی خود را گسترش دهید.
- منطق
مقادیر در فیلدهای هدف سطح بالا با OR منطقی پردازش می شوند. این بدان معناست که می توانید درخواست های پیشنهادی را دریافت کنید که حداقل یکی از مقادیری را که در فیلد سطح بالا مشخص کرده اید داشته باشد. برای مثال، اگر پیکربندی پیش‌هدف شما دارای مقادیر languageCodes en , de , و sv باشد، ممکن است درخواست‌های پیشنهادی را با en , de , یا sv به عنوان زبان شناسایی شده دریافت کنید.
فیلدهای مختلف با AND منطقی پردازش می شوند. شما فقط درخواست‌های پیشنهادی را دریافت می‌کنید که حداقل برای یک مقدار در هر فیلد پیش‌هدف‌گذاری که تعیین کرده‌اید مطابقت داشته باشند. به عنوان مثال، اگر پیکربندی شما دارای مقادیر languageCodes en , de , و sv و دارای مقدار includedPlatforms PERSONAL_COMPUTER باشد، شما فقط درخواست های پیشنهادی را دریافت می کنید که دارای زبان شناسایی شده en , de , یا sv و نوع دستگاه PERSONAL_COMPUTER هستند.
با توجه به AND منطقی در زمینه های پیش هدف گذاری، نمی توانید معیارهای متناقضی را لحاظ کنید. برای مثال، گنجاندن همان مقدار در includedIds و excludedIds در معیار NumericTargetingDimensions منجر به خطا می شود.
- همپوشانی
درخواست‌های مناقصه می‌توانند برای پیکربندی‌های پیش‌هدف چندگانه واجد شرایط باشند.
شما می توانید حداکثر 10 پیکربندی پیش هدف گذاری برای هدف قرار دادن انواع مختلف موجودی ایجاد کنید. پیکربندی‌های پیش‌هدف‌یابی می‌توانند همپوشانی داشته باشند، بنابراین یک درخواست پیشنهاد ممکن است برای چندین پیکربندی پیش‌هدف‌یابی واجد شرایط باشد. در این مورد، فیلد billing_id درخواست پیشنهاد شامل billingId هر پیکربندی قابل اجرا است. اگر چندین شناسه صورت‌حساب در درخواست مناقصه یافت شد، باید در قسمت billing_id پاسخ پیشنهاد قیمت مشخص کنید.
شناسه های جغرافیایی
برخی از شناسه های جغرافیایی به دلایل خط مشی قابل هدف نیستند. به عنوان مثال، برخی از مناطق با جمعیت کم را نمی توان هدف قرار داد زیرا این امر خط مشی حفظ حریم خصوصی ما را نقض می کند. سیاست های ما در معرض تغییر است. اگر یک شناسه جغرافیایی را در تنظیمات geoTargeting پیش‌هدف‌یابی خود مشخص کنید که در تاریخ دیگری نامعتبر شود، شناسه در آن زمان در قسمت invalidGeoIds ظاهر می‌شود. شناسه‌های جغرافیایی تحت invalidGeoIds هیچ تأثیری بر هدف‌یابی ندارند. اگر شناسه جغرافیایی در invalidGeoIds معتبر شود، به فیلد geoTargeting پیکربندی پیش‌هدف شما اضافه می‌شود.
فایل geo-table.csv شناسه های جغرافیایی قابل هدف را فهرست می کند و به صورت دوره ای با افزودن و حذف شناسه ها به روز می شود.
تعداد درخواست های پیشنهادی
شما باید حداکثر QPS را برای نقاط پایانی پیشنهاد دهنده خود پیکربندی کنید و به سیستم Callout Quota اجازه دهید ترافیک ارسال شده به نقاط پایانی شما را برای هر یک از پیکربندی های پیش هدف گذاری شما مدیریت کند.
در اینجا موارد لبه ای وجود دارد که مدیریت حداکثر QPS در سطح پیکربندی پیش هدف با maximumQps ممکن است مفید باشد:
- دریافت درخواست های بسیار زیاد
- اگر سیستم Callout Quota تعداد غیرعادی زیادی از درخواست‌های پیشنهادی را برای یک پیکربندی پیش‌هدف‌گذاری معین به نقاط پایانی پیشنهاددهنده ارسال می‌کند، می‌توانید از
maximumQps برای تنظیم دستی تعداد درخواست‌ها استفاده کنید. - آزمایش یک پیکربندی برای موجودی جدید
- اگر می‌خواهید از موجودی جدید، مانند یک قالب خلاقانه جدید، پشتیبانی کنید، می‌توانید یک پیکربندی پیش‌هدف‌یابی را که فقط آن موجودی را با
maximumQps پایین هدف قرار می‌دهد، پیاده‌سازی کنید.
برای موجودی‌هایی که توسط پیکربندی‌های پیش‌هدف‌یابی چندگانه هدف‌گذاری شده‌اند، تا زمانی که حداقل یکی از پیکربندی‌ها به maximumQps حد Qps خود نرسیده باشد، درخواست‌های پیشنهاد به نقاط پایانی پیشنهاددهنده از جمله billingId برای هر پیکربندی ارسال می‌شود.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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."]]
