תצורות של מיקוד מראש
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
מגישי הצעות מחיר יכולים להשתמש במשאב pretargetingConfigs
כדי לקבל בקשות להצעות מחיר רק לחשיפות שתואמות לקריטריונים שלהם לטירגוט.אפשר להגדיר בו-זמנית עד 10 הגדרות של טירגוט מראש.
כל הגדרה של טירגוט מראש מפיצה בקשות להצעות מחיר בין כל נקודות הקצה.
הבקשות להצעת מחיר לא תמיד מחולקות באופן שווה בין כל נקודות הקצה. לדוגמה, בתצורה של טירגוט מראש למזהים גיאוגרפיים ספציפיים באזור נתון, ייתכן שיהיו פחות התאמות במיקומי מסחר שרחוקים יותר מהאזור הזה. נקודות קצה שקרובות למיקומי מסחר רחוקים יותר עשויות לקבל פחות בקשות להצעות מחיר.
שיטות מומלצות
כדי לקבל בקשות להצעות מחיר, עליך ליצור לפחות הגדרה אחת של מיקוד מראש. ריכזנו כאן כמה טיפים לניהול ההגדרות של הטירגוט מראש:
- היקף
טירגוט מראש הוא כמו סינון. עליך להשתמש בקריטריונים של מיקוד מראש כדי לסנן בקשות להצעות מחיר שרלוונטיות לתרחיש לדוגמה שלך. אם לא תגדירו קריטריונים כלשהם של מיקוד מראש, תוכלו לקבל בקשות להצעות מחיר לכל החשיפות.
אם לא מתקבלות מספיק בקשות להצעות מחיר שקשורות להגדרה מסוימת של טירגוט מראש, מומלץ להרחיב את הקריטריונים של הטירגוט מראש.
- לוגיקה
ערכים בשדות הטירגוט ברמה העליונה מעובדים באמצעות OR
לוגי. המשמעות היא שתוכלו לקבל בקשות להצעות מחיר שכוללות לפחות אחד מהערכים שאתם מציינים בשדה ברמה העליונה. לדוגמה, אם בתצורת הטירגוט מראש יש ערכי languageCodes
en
, de
ו-sv
, יכול להיות שתקבלו בקשות להצעות מחיר עם השפה שזוהתה: en
, de
או sv
.
שדות שונים מעובדים באמצעות AND
לוגי. יתקבלו רק בקשות להצעות מחיר עם התאמה לערך אחד לפחות בכל שדה של מיקוד מראש שהגדרתם. לדוגמה, אם בהגדרות האישיות שלך יש ערכי languageCodes
en
, de
ו-sv
והערך PERSONAL_COMPUTER
הוא includedPlatforms
, יתקבלו רק בקשות להצעות מחיר שזוהתה בהן השפה en
, de
או sv
וסוג המכשיר PERSONAL_COMPUTER
.
בגלל הערך הלוגי AND
בשדות של טירגוט מראש, אי אפשר לכלול קריטריונים סותרים. לדוגמה, אם מוסיפים את אותו הערך ב-includedIds
וב-excludedIds
בקריטריונים של NumericTargetingDimensions
, תתקבל שגיאה.
- חפיפה
בקשות להצעות מחיר יכולות להיות כשירות לכמה הגדרות של טירגוט מראש.
אפשר ליצור עד 10 הגדרות של טירגוט מראש כדי לטרגט סוגים שונים של מלאי. יכולות להיות חפיפה בין הגדרות הטירגוט מראש, כך שבקשה יחידה להצעת מחיר עשויה להתאים לכמה תצורות של טירגוט מראש. במקרה כזה, השדה billing_id
של הבקשה להצעת מחיר מכיל את billingId
של כל אחת מההגדרות הרלוונטיות. אם הבקשה מכילה כמה מזהי חיוב, צריך לציין בשדה billing_id
של התגובה להצעת המחיר את מזהה החיוב שעליו רוצים להגיש הצעות מחיר.
מזהים גיאוגרפיים
יש מזהים גיאוגרפיים שלא ניתן לטרגט מסיבות הקשורות למדיניות. לדוגמה, לא ניתן לטרגט לאזורים מסוימים עם אוכלוסיות קטנות כי זה יפר את מדיניות הפרטיות שלנו. המדיניות שלנו עשויה להשתנות. אם תציינו מזהה גיאוגרפי ב-geoTargeting
של ההגדרה של הטירגוט מראש, שיהפוך ללא חוקי במועד מאוחר יותר, המזהה יופיע בשדה invalidGeoIds
באותו הזמן. למזהים גיאוגרפיים מתחת ל-invalidGeoIds
אין השפעה על הטירגוט. אם מזהה גרפי ב-invalidGeoIds
מקבל תוקף, הוא מתווסף לשדה geoTargeting
של הגדרת הטירגוט מראש.
בקובץ geo-table.csv מופיעים המזהים הגיאוגרפיים שניתן למקד אליהם, ומתעדכן מדי פעם תוך כדי הוספה והסרה של מזהים.
מספר הבקשות להצעת מחיר
עליכם להגדיר את מספר ה-QPS המקסימלי של נקודות הקצה של מגישי הצעות המחיר, ולאפשר למערכת מכסת היתרונות המרכזיים לנהל את התנועה שנשלחת לנקודות הקצה שלכם לכל אחת מההגדרות של הטירגוט מראש.
הנה תרחישי קצה שבהם כדאי לנהל את מספר QPS מקסימלי ברמת הגדרת הטירגוט מראש באמצעות maximumQps
:
- מתקבלות יותר מדי בקשות
- אם מערכת מכסות היתרונות המרכזיים שולחת מספר חריג של בקשות להצעות מחיר לנקודות הקצה של מגישי הצעות המחיר, בהתאם להגדרה מסוימת של טירגוט מראש, אפשר להשתמש ב-
maximumQps
כדי לשנות את מספר הבקשות באופן ידני.
- בדיקת הגדרות של מלאי חדש
- אם אתם מנסים לתמוך במלאי חדש של שטחי פרסום, כמו פורמט חדש של קריאייטיב, תוכלו להטמיע הגדרה של טירגוט מראש שמטרגטת רק את המלאי הזה עם ערך נמוך של
maximumQps
.
במלאי שטחי פרסום שמטורגט באמצעות כמה הגדרות של טירגוט מראש, הבקשות להצעות מחיר נשלחות לנקודות הקצה של מגיש הצעות המחיר, כולל billingId
של כל הגדרה, כל עוד לפחות אחת מההגדרות לא הגיעה למגבלה של maximumQps
.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 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."]]