تكوينات الاستهداف
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكن لأنظمة عروض الأسعار استخدام المورد pretargetingConfigs لتلقي طلبات عروض الأسعار لمرات الظهور التي تتطابق مع معايير الاستهداف لديهم فقط.يمكن أن يكون لديك ما يصل إلى 10 إعدادات للاستهداف المسبق في الوقت نفسه.
تعمل كل إعدادات استهداف مسبق على توزيع طلبات عروض الأسعار على جميع نقاط النهاية.
لا يتم دائمًا توزيع طلبات عروض الأسعار بالتساوي على جميع نقاط النهاية. على سبيل المثال، قد تحتوي إعدادات الاستهداف المُسبَق لأرقام تعريف جغرافية معيّنة في منطقة معيّنة على عدد أقل من التطابقات في المواقع
التجارية الأبعد
عن تلك المنطقة. قد تتلقى نقاط النهاية القريبة من مواقع التداول الأبعد
طلبات عروض أسعار أقل.
أفضل الممارسات
لتلقّي طلبات عروض الأسعار، يجب إنشاء إعداد استهداف مسبق واحد على الأقل. في ما يلي بعض النصائح لإدارة عمليات ضبط الاستهداف المسبَق:
- النطاق
يشبه الاستهداف المُسبَق الفلترة. عليك استخدام معايير الاستهداف المُسبَق لفلترة طلبات عروض الأسعار حسب تلك ذات الصلة بحالة استخدامك. في حالة عدم تعيين أي معايير استهداف مسبق، يمكنك تلقي طلبات عروض الأسعار لجميع مرات الظهور.
إذا كنت لا تتلقّى ما يكفي من طلبات عروض الأسعار ذات الصلة بتهيئة استهداف مسبق، فقد تحتاج إلى توسيع معايير الاستهداف المسبق.
- منطق
تتم معالجة القيم في حقول استهداف المستوى الأعلى باستخدام 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) لنقاط نهاية نظام عروض الأسعار،
والسماح لنظام حصة وسائل الشرح
بإدارة عدد الزيارات المُرسَلة إلى نقاط النهاية لكل عملية من إعدادات
الاستهداف المُسبَق.
في ما يلي الحالات الهامشية التي قد تكون فيها إدارة الحد الأقصى لعدد الطلبات في الثانية (QPS) على مستوى ضبط الاستهداف المسبق باستخدام maximumQps مفيدًا:
- تلقّي عدد كبير جدًا من الطلبات
- إذا كان "نظام حصص وسائل الشرح" يرسل عددًا كبيرًا غير معتاد من طلبات عروض الأسعار إلى نقاط نهاية مقدِّمي عروض الأسعار لضبط استهداف مسبق، يمكنك استخدام
maximumQps لتعديل عدد الطلبات يدويًا.
- اختبار إعدادات لمستودع جديد
- إذا كنت تحاول إتاحة مستودع إعلاني جديد، مثل تنسيق جديد لتصميم الإعلان، يمكنك تنفيذ إعدادات استهداف مسبق تستهدف هذا المستودع الإعلاني فقط مع قيمة
maximumQps منخفضة.
بالنسبة إلى المستودع الإعلاني الذي يتم استهدافه من خلال عدة إعدادات للاستهداف المُسبَق،
يتم إرسال طلبات عروض الأسعار إلى نقاط النهاية الخاصة بمقدِّم عرض السعر، بما في ذلك billingId
لكلّ إعداد، ما دامت إحدى الإعدادات على الأقل
لم تبلغ الحدّ الأقصى المسموح به وهو maximumQps.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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."]]
