تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Protected Audience API (المعروفة سابقًا باسم FLEDGE)

في إطار مبادرة حماية الخصوصية، اقترح Chrome واجهة برمجة التطبيقات Protected Audience API، وهي واجهة برمجة تطبيقات داخل المتصفّح تتيح للمعلِنين وشركات تكنولوجيا الإعلان عرض إعلانات تستهدف مجموعات الاهتمامات بدون الاعتماد على ملفات تعريف الارتباط التابعة لجهات خارجية، مع حماية المستخدمين من تتبُّع إجراءاتهم على مواقع إلكترونية متعددة.

يُجري Chrome تجربة وتقييم لواجهة Protected Audience API. يكون المشترون المعتمَدون مؤهّلين للمشاركة في اختبار واجهة برمجة التطبيقات Protected Audience على المساحة الإعلانية المتاحة لدى الناشرين في "مدير إعلانات Google". يمكن مقدّمي عروض الأسعار تحقيق ما يلي من خلال اختبار Protected Audience API:

تكرار عمليات Protected Audience API والتعرّف على فعاليتها
تقديم ملاحظات حول التحسينات المحتملة على واجهة برمجة التطبيقات في المنتديات العامة، مثل GitHub
الاستعداد لإتاحة عرض الإعلانات المخصّصة من خلال واجهة برمجة التطبيقات بدون الاعتماد على ملفات تعريف الارتباط التابعة لجهات خارجية

على "المشترين المعتمَدين" المهتمّين بتجربة هذه الميزة الاطّلاع على قسم منح إمكانية الوصول للحصول على التفاصيل.

ملخّص عملية العرض

في ما يلي ملخّص لعملية عرض الإعلانات في Protected Audience لشركاء "الشراة المعتمَدون":

مخطط انسيابي

يعمل مقدّم عروض الأسعار مع المعلِنين للحفاظ على مجموعات الاهتمامات لكل معلِن. في كثير من الأحيان، يضيف المعلنون علامة مقدّم عروض إلى صفحة المعلِن لإضافة متصفّح إلى مجموعات الاهتمامات.
يزور أحد المستخدِمين صفحة أحد المعلِنين. قد تحتوي الصفحة على علامة مقدّم العروض.
يستدعي رمز المعلِن Protected Audience API joinAdInterestGroup(). يطلب هذا الاستدعاء من المتصفّح إضافة المستخدم إلى مجموعة باهتمامات مشتركة.
يزور المستخدِم النهائي صفحة ويب تابعة للناشر. يرسل متصفّح المستخدِم طلبًا إلى علامة إعلان الناشر من Google.
تُرسِل علامة إعلان الناشر من Google طلب إعلان مستند إلى السياق إلى أحد خوادم Google.
ترسل Google طلبات عروض الأسعار السياقية إلى مقدّمي عروض الأسعار المشاركين. اطّلِع على قسم التغييرات في طلب عروض الأسعار للحصول على مزيد من المعلومات.
يعرض مقدّم عروض الأسعار استجابة لعرض السعر تتضمّن الرسالة InterestGroupBidding، وهي مطلوبة للمشاركة في مزاد مجموعة الاهتمامات. في OpenRTB، يتم تحديد ذلك باستخدام الحقل BidResponse.ext.igbid، وفي بروتوكول عرض الأسعار في الوقت الفعلي (RTB) من Google الذي تم إيقافه نهائيًا، يتم تحديد ذلك باستخدام الحقل BidResponse.interest_group_bidding. إذا لم يحدّد مقدّم عرض الأسعار هذه المعلومات، لن تدرج Google مصدر مقدّم عرض الأسعار في interestGroupBuyers ضمن إعدادات المزاد. يمكن أن تحتوي InterestGroupBidding أيضًا على إشارات اختيارية خاصة بالمشتري سيتم نقلها إلى وظيفة تقديم العروض الخاصة مقدّم العرض أثناء المزاد داخل المتصفّح. في OpenRTB، يتم تحديد ذلك باستخدام الحقل BidResponse.ext.igbid.igbuyer.buyerdata، وفي بروتوكول عرض الأسعار في الوقت الفعلي (RTB) من Google المتوقّف نهائيًا، يتم تحديد ذلك باستخدام الحقل BidResponse.interest_group_bidding.interest_group_buyers.per_buyer_signals. راجِع قسم التغييرات في ردود عروض الأسعار للحصول على مزيد من المعلومات.
تُجري Google المزاد من جهة الخادم وتعرض استجابة عرض السعر على المتصفّح. يأخذ المزاد من جهة الخادم في الاعتبار عروض الأسعار التقليدية من جهة الخادم. يمكن أن يحتوي ردّ عروض الأسعار على معلومات حول عرض سعر فائز سياقي (إن وُجد).
يتضمّن ردّ عرض السعر إعدادات مزاد للمزاد الذي يتم إجراؤه داخل المتصفّح. ويمكن أن يشمل ذلك الإشارات السياقية من كل مشترِك (التي تم إرسالها من خلال buyerdata في OpenRTB أو per_buyer_signals في بروتوكول Google RTB المتوقّف نهائيًا سابقًا)، ومعلومات الفائز السياقي، وإعدادات أهلية تقديم عروض الأسعار.
تستدعي علامة الناشر من Google واجهة Protected Audience API runAdAuction() لبدء مزاد المجموعات ذات الاهتمامات المشتركة على الجهاز. لا تضمّن Google سوى المشترين الذين تم تضمينهم كـ InterestGroupBuyer في InterestGroupBidding أثناء إعداد المزاد.
تنقل Google إشارات اختيارية خاصة بالمشتري إلى إعدادات مزاد Protected Audience لكل مقدّم عرض مؤهّل.
إذا حدّدت المجموعات ذات الاهتمامات المشتركة التابعة لأحد مقدّمي عروض الأسعار trustedBiddingSignalsUrl، يرسل المتصفّح طلبًا إلى trustedBiddingSignalsUrl كل مجموعة لجلب الإشارات في الوقت الفعلي لكل مجموعة. يمكنك الاطّلاع على التفاصيل في مواصفات Protected Audience API.
يستدعي المتصفّح generateBid() مقدّم عروض الأسعار لكل مجموعة اهتمامات وافقت على المشاركة ومؤهّلة للمشاركة في المزاد داخل المتصفّح. تحسب هذه الخطوة عرض السعر وتختار تصميم إعلان. يمكن لـ generateBid() الوصول إلى إشارات المشترين الاختيارية التي يقدّمها مقدّم عروض الأسعار وإشارات عروض الأسعار الموثوقة لمجموعة الاهتمامات المحدّدة.
يستدعي المتصفّح الدالة scoreAd() الخاصة بالبائع (في هذه الحالة، Google) من أجل تحديد ترتيب لكل عرض سعر في مزاد الإعلانات الخاص بمجموعة الاهتمامات. يتم ترتيب عروض الأسعار وتصفيتها استنادًا إلى إجراءات الحماية التي يتّخذها الناشرون وسياسات الإعلانات والقيود الأخرى.
يُجري المتصفّح مزادًا باستخدام عروض الأسعار المؤهّلة لمجموعة الاهتمامات. يشارك عرض الأسعار السياقي الأعلى ترتيبًا في المزاد داخل المتصفّح.
بعد انتهاء المزاد، إذا فازت مجموعة اهتمامات، يستدعي المتصفّح reportResult() البائع وreportWin() مقدّم عروض الأسعار لإبلاغ كل طرف بالفائز في المزاد الذي تم إجراؤه داخل المتصفّح.
في حال فاز إعلان يستهدف مجموعة اهتمامات، تعرض علامة الناشر من Google الإعلان في إطار iframe.

تفاصيل مسار العرض

قبل عرض الإعلانات

مراجعة تصميم الإعلان

يجب أن تراجع Google تصميمات الإعلانات وتوافق عليها قبل أن يتم عرضها من خلال مزادات Protected Audience داخل المتصفّح. يمكنك إرسال مواد إبداعية للمراجعة من خلال Real-time Bidding API أو من خلال الفحص التلقائي للمواد الإبداعية. يجب أن تتضمّن تصميمات الإعلانات الخاصة بمزاد إعلانات مجموعة الاهتمامات داخل المتصفّح في Protected Audience renderUrls للمراجعة.

متطلبات renderUrls:

يجب أن تتطابق renderUrl التي يتم إرسالها من خلال واجهة برمجة التطبيقات مع renderUrl المستخدَمة في مزاد الإعلانات ضمن مجموعة الاهتمامات.
يمكن أن يمثّل كل renderUrl معلنًا واحدًا أو حملة إعلانية واحدة فقط. لا يمكن استخدام renderUrl معيّن لعرض الإعلانات نيابةً عن عدّة معلِنين. يجب أن يرتبط كل renderUrl بتصميم إعلان واحد.
يجب أن يكون renderUrl قابلاً للوصول والاسترداد من خلال أنظمة مراجعة المواد الإبداعية غير الإلكترونية من Google لمدة تصل إلى 7 أيام بعد آخر عرض سعر تم تقديمه للإعلان.

Real-time Bidding API

يمكن مقدّمي عروض الأسعار استخدام واجهة برمجة التطبيقات الخاصة بعروض الأسعار في الوقت الفعلي لتحميل تصاميم الإعلانات من أجل تقديم عروض أسعار لمجموعات الاهتمامات.

المسح التلقائي للتصاميم

يمكن مقدّمي عروض الأسعار إعداد فحص تلقائي للمواد الإبداعية التي لم يتم تحميلها من خلال واجهة برمجة التطبيقات الخاصة بنظام عروض الأسعار في الوقت الفعلي.

في حال إعداد ميزة الفحص التلقائي لتصاميم الإعلانات، يعثر محرّك بحث Google على تصاميم الإعلانات في المزاد داخل المتصفّح ويفحصها تلقائيًا لتكون مؤهّلة للمزادات المستقبلية.

في ما يلي كيفية تفعيل ميزة "المسح التلقائي لتصاميم الإعلانات":

أضِف جميع مصادر تصميمات مجموعة الاهتمامات renderUrl إلى حساب Authorized Buyer.

أضِف عناوين HTTP المخصّصة التالية إلى استجابة HTTP الخاصة بتصميم الإعلان:

Authorized-Buyers-Creative-ID

string

رقم تعريف تصميم الإعلان الخاص بالمشتري يبلغ الحد الأقصى لطول معرّف تصميم الإعلان 128 بايت.

Authorized-Buyers-Click-Through-URLs

string

مجموعة عناوين URL المقصودة التي تم الإعلان عنها للعنصر الإبداعي المرمّز وفقًا RFC2396

مثال:

HTTP/1.1 200 OK
Date: Mon, 8 Jan 2022 12:28:53 GMT
Server: Apache/2.2.14 (Win32)
Last-Modified: Mon, 8 Jan 2022 12:01:53 GMT
Content-Length: 88
Content-Type: text/html
Connection: Closed
Authorized-Buyers-Creative-ID:123456
Authorized-Buyers-Click-Through-URLs:https://www.advertiser.com/clickUrl1,https://www.advertiser.com/clickUrl12

<html>
<body>
<h1>Hello, World!</h1>
</body>
</html>

انتهاء صلاحية تصميم الإعلان

تتم الموافقة على تصاميم الإعلانات لمدة 15 يومًا. في حال إرسال تصاميم إعلانات باستخدام Real-time Bidding API، عليك إعادة إرسال تصميم الإعلان بعد 15 يومًا. إذا كنت تعتمد على الفحص التلقائي للتصاميم، ستعيد عملية الفحص فحصها تلقائيًا.

معرّف إعداد التقارير لدى المشتري

يمكنك تقسيم مقاييس إعداد التقارير (مثل مرّات الظهور) باستخدام السمات التي يقدّمها المعلِن (مثل معرّف الحملة أو معرّف المعلِن). لإضافة سمة لإنفاق المجموعة باهتمامات مشتركة، حدِّد buyerAndSellerReportingId لإعلانك عند إضافة جهاز المستخدِم إلى المجموعة باهتمامات مشتركة. يمكنك الاطّلاع على تفاصيل إضافية في مستندات Protected Audience.

في ما يلي مثال على كيفية إضافة buyerAndSellerReportingId إلى إعدادات مجموعة الاهتمامات:

const myGroup = {
  ...
  'ads': [
    {
      ...
      'buyerAndSellerReportingId':
        '{"google_signals": {"buyer_reporting_id": "12345"}}',
      ...
    }
  ]
}
joinAdInterestGroup(myGroup);

سيظهر buyer_reporting_id كسمة جديدة في "أداة إعداد التقارير للمشتري المعتمَد"، تحت اسم سمة "معرّف إعداد التقارير للمشتري".

المزاد من جهة الخادم

تغييرات طلبات عروض الأسعار

في ما يلي إصدارات مبكرة من البروتوكولات المتوافقة التي يمكن استخدامها في التجربة:

الرابط المبكر في OpenRTB
الرابط السابق لبروتوكول عرض الأسعار في الوقت الفعلي (RTB) من Google (متوقّف نهائيًا)

تحديد ما إذا كان المزاد يتيح المجموعات حسب الاهتمامات

تتضمّن طلبات عروض الأسعار حقولاً جديدة للإشارة إلى إمكانية إجراء مزادات المجموعات المستندة إلى الاهتمامات:

‫OpenRTB:
- BidRequest.imp.ext.ae
- BidRequest.imp.ext.igbid
بروتوكول عرض الأسعار في الوقت الفعلي (RTB) من Google (متوقّف نهائيًا):
- BidRequest.adslot.supported_auction_environment
- BidRequest.adslot.interest_group_bidding_allowed

يمكنك استخدام هذا الحقل للتمييز بين فرص ظهور الإعلانات التي تتيح المزاد المستند إلى مجموعات الاهتمامات في المتصفّح باستخدام Protected Audience API، وتلك التي تتيح فقط المزاد التقليدي على خادم التبادل. يمكن أن يحتوي التعداد AuctionEnvironment على القيم التالية:

‫SERVER_SIDE_AUCTION (OpenRTB JSON: 0): المزاد الذي يحدّد الإعلان الفائز يتم إجراؤه على خوادم شبكة التبادل.
‫ON_DEVICE_INTEREST_GROUP_AUCTION (OpenRTB JSON: 1): الطلبات التي تتوافق مع Protected Audience، والتي يتم فيها إجراء مزاد سياقي على خوادم شبكة التبادل، ويتم إجراء عروض أسعار مجموعات الاهتمامات والمزاد النهائي في المتصفّح.
SERVER_SIDE_INTEREST_GROUP_AUCTION (OpenRTB JSON: 3): يتم إجراء المزاد السياقي على خوادم التبادل، ويتم تنفيذ منطق عروض الأسعار لمجموعات الاهتمامات ومنطق التسجيل لتحديد الإعلان الفائز النهائي في خوادم عروض الأسعار والمزاد.

تحديد حجم الخانة الإعلانية في Protected Audience API

يتضمّن طلب عرض السعر الحقول التالية لتزويدك بحجم مساحة إعلانية في "الجمهور المحمي":

‫OpenRTB:
- BidRequest.imp.ext.interest_group_auction.width
- BidRequest.imp.ext.interest_group_auction.height
بروتوكول عرض الأسعار في الوقت الفعلي (RTB) من Google (متوقّف نهائيًا):
- BidRequest.adslot.interest_group_auction.width
- BidRequest.adslot.interest_group_auction.height

تشير هذه الحقول إلى حجم مساحة عرض الإعلان في مزاد Protected Audience بالبكسل.

قد يختلف هذا الحجم عن الأحجام الواردة في الطلب السياقي، مثل تلك التي تظهر في الحقلين BidRequest.imp.banner.format.w وBidRequest.imp.banner.format.h في OpenRTB أو الحقلين BidRequest.adslot.width وBidRequest.adslot.height في بروتوكول عرض الأسعار في الوقت الفعلي (RTB) من Google المتوقّف نهائيًا.

قد يتضمّن الطلب السياقي أحجامًا متعدّدة. من المتوقّع أن تملأ الإعلان الفائز في المزاد على الجهاز حجمًا واحدًا ثابتًا للفتحة الإعلانية فقط.

تحديد ما إذا كان يمكن عرض إعلانات Protected Audience

قد يتم عرض إعلانات Protected Audience أو لا يتم عرضها، وذلك حسب مرحلة الدمج الحالية (راجِع تجربة عدم العرض). يشير الحقل render_interest_group_ads في طلب عرض السعر إلى ما إذا كان سيتم عرض الإعلان الفائز في Protected Audience.

‫OpenRTB: BidRequest.imp.ext.interest_group_auction.render_interest_group_ads
بروتوكول عرض الأسعار في الوقت الفعلي (RTB) من Google (تم إيقافه نهائيًا): BidRequest.adslot.interest_group_auction.render_interest_group_ads

تقليل الاعتماد على معرّفات المستخدمين

يمكن أن تستمر طلبات عروض الأسعار المستندة إلى السياق التي تندرج ضمن نطاق اختبار واجهة Protected Audience API في تضمين المعرّفات التقليدية المستندة إلى ملفات تعريف الارتباط عندما تكون متاحة من المتصفّح، مثل الحقلَين BidRequest.user.id وBidRequest.user.buyerid، أو BidRequest.google_user_id وBidRequest.hosted_match_data في بروتوكول عروض الأسعار في الوقت الفعلي من Google المتوقّف نهائيًا. ويخضع توفّر هذه المعرّفات في طلبات عروض الأسعار لسياسات الخصوصية الحالية. ننصحك بعدم الاعتماد على المعرّفات المستندة إلى ملفات تعريف الارتباط لأغراض الاستهداف وتقديم عروض الأسعار أثناء الاختبار، وذلك للاستعداد بشكل أفضل للشراء الفعّال عندما تصبح ملفات تعريف الارتباط التابعة لجهات خارجية غير متاحة.

قد تجري Google أيضًا تجارب صغيرة النطاق يتم فيها إخفاء المعرّفات المستندة إلى ملفات تعريف الارتباط من طلبات عروض الأسعار التي تندرج ضمن نطاق اختبار Protected Audience API. ويتم ذلك لتقييم التأثير المحتمل لإيقاف ملفات تعريف الارتباط التابعة لجهات خارجية نهائيًا.

اختبار الإيقاف النهائي لملفات تعريف الارتباط التابعة لجهات خارجية الذي يسهّله متصفّح Chrome

استعدادًا للإيقاف النهائي لملفات تعريف الارتباط التابعة لجهات خارجية (3PCD) في عام 2024، يوفّر Chrome الآن اختبارًا يسهّله Chrome.

يمكن للمواقع الإلكترونية والمورّدين استخدام الاختبارات التي يوفّرها Chrome لاختبار أنظمتهم ضمن 3PCD. في الاختبار، يتمّ تعيين متصفّحات Chrome إلى مجموعة تجريبية خاصة بملفات تعريف الارتباط التابعة لجهات خارجية، إما "الوضع أ" أو "الوضع ب". يتم تعيين تصنيف ثابت لكل متصفّح يتوافق مع مجموعة تجريبية معيّنة من 3PCD يمكنك الوصول إليها من خلال واجهة برمجة التطبيقات Chrome API داخل المتصفّح.

تنقل Google التصنيف غير المعدَّل من واجهة برمجة التطبيقات في Chrome إلى طلب عرض السعر في نظام عروض الأسعار في الوقت الفعلي. بسبب شرائح الزيارات الصغيرة لتصنيف فردي، لا تدرج Google التصنيف دائمًا في السياقات المحدودة الخصوصية.

في ما يلي الحقول التي يمكنك الاطّلاع على التصنيف فيها:

‫OpenRTB: BidRequest.device.ext.cdep
بروتوكول عرض الأسعار في الوقت الفعلي (RTB) من Google (تم إيقافه نهائيًا): BidRequest.device.cookie_deprecation_label

تغييرات في الاستجابة لعرض السعر

تحديد المشاركة في مزاد المجموعات ذات الاهتمامات المشترَكة

أنت مسؤول عن الإشارة بوضوح إلى نيتك المشاركة في المزاد داخل المتصفّح من خلال عرض العنصر InterestGroupBidding في الردّ على عرض الأسعار السياقي:

OpenRTB: BidResponse.ext.igbid
بروتوكول عرض الأسعار في الوقت الفعلي (RTB) من Google (متوقّف نهائيًا): BidResponse.interest_group_bidding

يجب تقديم ردّ على عرض الأسعار السياقية. ولا يُشترط أن يتضمّن الردّ عرض سعر سياقيًا. يجب أن يحتوي عنصر InterestGroupBidding على origin لكل InterestGroupBuyer، ويجب أن يتطابق مع أحد المصادر التي ضبطها مقدّم العروض لحسابه. تتم إضافة origin إلى interestGroupBuyers في إعدادات المزاد عندما تستدعي "علامة الناشر من Google" runAdAuction().

نقل الإشارات السياقية للمشترين

يمكنك تضمين إشارات المشتري في ردّ عرض السعر السياقي، والذي تنشره Google كعنصر JSON إلى وظيفة عروض الأسعار على الجهاز من خلال الوسيطة perBuyerSignals. يمكن تضمين ذلك في ردّ عرض السعر باستخدام الحقول التالية وفقًا للبروتوكول:

OpenRTB: BidResponse.ext.igbid.igbuyer.buyerdata
عروض الأسعار في الوقت الفعلي من Google (متوقّفة نهائيًا): BidResponse.interest_group_bidding.per_buyer_signals

نقل إشارات العرض السياقي للمشتري

قد تستخدم تصاميم الإعلانات الخاصة بالمجموعات المستندة إلى الاهتمامات إشارات سياقية محدودة أثناء العرض من خلال إرسال هذه الإشارات عبر استجابة عرض السعر السياقي وتلقّيها في طلب عنوان URL للعرض باستخدام توسيع وحدات الماكرو. على سبيل المثال، يمكن استخدام إشارات العرض لتخصيص شكل وتصميم مادة إبداعية من أجل تحسين الأداء في سياق شريحة إعلانية أو صفحة ناشر معيّنة.

يمكنك تضمين إشارات العرض الخاصة بالمشتري في شكل سلسلة متسلسلة آمنة لعناوين URL في استجابة عرض الأسعار السياقية، وسيستبدلها محرّك بحث Google في عنوان URL الخاص بعرض المجموعة الفائزة من الاهتمامات من خلال إنشاء وحدة الماكرو ${RENDER_DATA_buyer.origin.example[_OPTIONAL_SUFFIX]}.

يمكن تحديد إشارات العرض في ردّ عرض السعر باستخدام الحقول التالية، وذلك حسب البروتوكول:

OpenRTB: BidResponse.ext.igbid.igbuyer.rsig
عروض الأسعار في الوقت الفعلي من Google (متوقّفة نهائيًا): BidResponse.interest_group_bidding.interest_group_buyer.rendering_signals

يمكن تضمين ما يصل إلى 3 مجموعات من إشارات العرض مع لاحقات مختلفة لوحدات الماكرو في ردّ عرض السعر للتمييز بين الإشارات المختلفة. على سبيل المثال، يمكن استخدام لاحقة لمطابقة مجموعة معيّنة من الإشارات التي تنطبق فقط على تصميمات الإعلانات التي تتضمّن وحدة ماكرو مقابلة في عنوان URL الخاص بعرضها، ما يؤدي إلى تقليل حجم نقل البيانات.

سيتم رفض مشاركة المشتري في مجموعة الاهتمامات في مزاد Protected Audience إذا لم تكن الإشارات متوافقة مع عناوين URL، أو إذا لم تكن لاحقات وحدات الماكرو فريدة، أو إذا تم تقديم أكثر من 3 مجموعات من الإشارات.

تحديد الحدّ الأقصى لسعر عرض السعر داخل المتصفّح

في اقتراح Protected Audience، من المتوقّع أن يتم احتساب عروض الأسعار وإجراء المزاد النهائي على الجهاز فقط. وقد يؤدي ذلك إلى إنشاء متجهات إساءة استخدام محتملة يمكن أن تؤثر في سلامة نتائج المزاد النهائية، مثل سعر عرض السعر الفائز.

كإجراء للحدّ من المشاكل يتم توفيره أثناء اختبار Protected Audience API من Google لشركاء نظام عروض الأسعار في الوقت الفعلي، يمكنك تحديد قيمة عرض سعر قصوى متوقّعة في كل ردّ على عرض سعر يستند إلى السياق. عرض السعر الأقصى المتوقّع هو الحدّ الأقصى لعرض السعر الذي من المتوقّع أن تعرضه دالة عروض الأسعار. إذا تجاوز عرض السعر الفائز الذي تمّ تسجيله من المزاد داخل المتصفّح هذا المبلغ، لن يتم احتساب عرض السعر الفائز كحدث قابل للفوترة. هذا الأسلوب قابل للتغيير.

في استجابة طلب عروض الأسعار، يمكنك تحديد الحدّ الأقصى المتوقّع لقيمة عرض السعر في الحقول التالية:

‫OpenRTB: BidResponse.igbid.igbuyer.maxbid(معبّر عنها بوحدات عملة التكلفة لكل ألف ظهور)
بروتوكول عرض الأسعار في الوقت الفعلي (RTB) من Google (تم إيقافه نهائيًا): BidResponse.interest_group_bidding.interest_group_buyers.max_bid_cpm_micros (يتم التعبير عنه بوحدة microCPM)

إسناد مرّات الظهور إلى حسابات متعدّدة

على مقدّم العروض اختيار معرّف فوترة لتحديد مصدر مرّات الظهور الخاصة بعرض مجموعة الاهتمامات باستخدام الحقول التالية:

OpenRTB: BidResponse.igbid.igbuyer.billing_id
بروتوكول عرض الأسعار في الوقت الفعلي (RTB) من Google (متوقّف نهائيًا): BidResponse.interest_group_bidding.interest_group_buyers.billing_id

يجب أن يكون معرّف الفوترة المحدّد معرّف فوترة مؤهّلاً من طلب عروض الأسعار:

OpenRTB: BidRequest.imp.ext.billing_id
بروتوكول عرض الأسعار في الوقت الفعلي (RTB) من Google (متوقّف نهائيًا): BidRequest.adslot.matching_ad_data.billing_id

إذا لم يتم تقديم معرّف الفوترة الذي سيتمّ ربط مرّات الظهور الخاصة بعروض أسعار المجموعات ذات الاهتمامات المشتركة به، لن يشارك مقدّم عروض الأسعار في مزاد Protected Audience.

يمكن أن تتضمّن حسابات الأطفال ما يصل إلى رقمَي تعريف للفوترة. يمكن للمشتري استخدام أحد معرّفَي الفوترة للإنفاق حسب المحتوى، واستخدام المعرّف الآخر للإنفاق حسب مجموعة الاهتمامات. يُرجى التواصل مع مدير حسابك إذا أردت ضبط رقمَي تعريف فوترة لحساب فرعي.

يمكن ضبط ميزانية يومية لكل رقم تعريف فوترة. تواصَل مع مدير حسابك لضبط الميزانية اليومية لمعرّفات الفوترة الخاصة بالحسابات الفرعية.

تظهر أرقام تعريف الفوترة لجميع الحسابات الفرعية التي تتضمّن ميزانية متاحة ومؤهَّلة لتقديم عروض أسعار على مرّة الظهور في طلب عرض السعر لاختيار تحديد مصدر الإنفاق. يُرجى التواصل مع مدير حسابك لتعديل الميزانية لرقم تعريف الفوترة الخاص بمجموعة اهتمامات.

أثناء المزاد داخل المتصفّح

إنشاء عروض أسعار داخل المتصفّح

استخدِم generateBid() لإنشاء عروض أسعار في المتصفّح.

توفّر Google المَعلمات التالية:

‫auctionSignals: فارغ
‫perBuyerSignals: كائن JavaScript يتضمّن الإشارات نفسها التي يقدّمها مقدّم عروض الأسعار في الردّ السياقي

يتم عرض المَعلمات التالية:

‫ad: يتجاهل محرّك بحث Google هذا الحقل.
bid: عرض سعر رقمي يدخل المزاد. يجب أن تكون القيمة بوحدة التكلفة لكل ألف ظهور (وليس بالميكرو).
render: عنوان URL الذي يتم عرضه لعرض تصميم الإعلان إذا فاز عرض السعر بالمزاد. يجب أن تراجع Google عنوان URL هذا وتوافق عليه، وإلا سيتم استبعاده من المزاد.
‫allowComponentAuction: يجب أن تكون true. تتيح Google حاليًا اختبار المزادات التي تضمّ بائعين متعدّدين.

وفي ما يلي مثال لذلك:

function generateBid(...) {
  ...
  return {'ad': 'example',
          'bid': ad.metadata.bid,
          'render': ad.renderUrl,
          'allowComponentAuction': true};
}

راجِع قسم المزايدة على الجهاز في مواصفات Protected Audience للحصول على شرح للدالة generateBid().

عملة عرض السعر

يتم تقديم عروض أسعار مزاد داخل المتصفّح بوحدات التكلفة لكل ألف ظهور بعملة عرض السعر المحدّدة.

يجب الإشارة إلى عملة عرض السعر في كلّ من استجابة عرض السعر السياقي والقيمة المعروضة في generateBid، ويجب أن تكون رمزًا أبجديًا صالحًا وفقًا لمعيار ISO 4217، مثل "USD" أو "EUR" أو "JPY".

في OpenRTB، استخدِم الحقل الجديد cur في العنصر InterestGroupBuyer في إضافة استجابة عرض الأسعار من Google.

وفي ما يلي مثال لذلك:

ext {
  igbid {
    impid: "1"
    igbuyer {
      origin: "https://examplebuyerorigin.com"
      cur: "EUR"
    }
  }
}

في بروتوكول Google RTB، استخدِم الحقل الجديد currency في الرسالة InterestGroupBuyer ضمن ردّ عرض السعر.

وفي ما يلي مثال لذلك:

interest_group_bidding {
  adslot_id: 1
  interest_group_buyer {
    origin: "https://examplebuyerorigin.com"
    currency: "EUR"
  }
}

يجب أن تعرض وظائف generateBid الخاصة بمقدّمي عروض الأسعار عروض أسعار بالعملة نفسها المحدّدة في الرد على عرض الأسعار السياقي. املأ السمة الجديدة bidCurrency في القيمة المعروضة من generateBid:

function generateBid(...) {
  ...
  return {'ad': ad,
          'bid': bid,
          'bidCurrency': 'EUR',
          ...};
}

إذا كانت العملة الواردة من استجابة عرض السعر السياقي مختلفة عن العملة التي تعرضها generateBid، أو إذا عرض أي منهما عملة غير صالحة، سيتم فلترة عرض السعر قبل المزاد.

عمليات التحقّق من جودة الإعلانات

قد يكون تطبيق سياسة المواد الإبداعية وعناصر تحكّم الناشر أكثر تقييدًا لعروض أسعار المجموعات ذات الاهتمامات المشتركة داخل المتصفّح خلال اختبار Protected Audience API لشركاء نظام عروض الأسعار في الوقت الفعلي.

التوافق مع "قانون الخدمات الرقمية"

بموجب المادة 26 من "قانون الخدمات الرقمية"، يجوز للناشرين أن يطلبوا من المشترين عرض بيانات الإفصاح عن الشفافية داخل الإعلان. عندما يفعّل الناشر عنصر التحكّم "الطلب من المشترين عرض الإعلانات التي تتضمّن معلومات الشفافية حسب قانون الخدمات الرقمية فقط على موقعي الإلكتروني أو تطبيقي في المنطقة الاقتصادية الأوروبية"، يمكن للمشترين في مجموعات الاهتمامات تحديد فرص عرض الإعلانات التي تتطلّب منهم توفير معلومات الشفافية للمشترين من خلال ملاحظة قيم BidRequest.regs.dsa.required وBidRequest.dsa.pubrender في طلب عرض السعر (BidRequest.dsa.dsa_support وBidRequest.dsa.publisher_rendering_support على التوالي في بروتوكول Google RTB المتوقّف نهائيًا).

عندما يتلقّى مقدّم عروض أسعار يريد المشاركة في مزادات Protected Audience API إشارة في طلب عرض السعر بضرورة عرض معلومات الشفافية المتوافقة مع "قانون الخدمات الرقمية" للإعلانات المعروضة من خلال Protected Audience API، يجب على مقدّم عروض الأسعار تقييم ما إذا كان بإمكانه عرض المعلومات المطلوبة بشكل مناسب أم لا، وتحديد ذلك من خلال ضبط BidResponse.ext.igbid.igbuyer.dsaadrender (BidResponse.interest_group_bidding.interest_group_buyers.dsa_buyer_render في بروتوكول عروض الأسعار في الوقت الفعلي من Google المتوقّف نهائيًا). وفي حال عدم توفّرها، لن يتم تضمين المعلِن في مزاد Protected Audience API.

لمزيد من المعلومات حول الشفافية في الإعلانات بموجب "قانون الخدمات الرقمية"، يُرجى الاطّلاع على مقالة "مركز المساعدة: دعم قانون الخدمات الرقمية".

فلترة عروض الأسعار

تفرض Google عناصر تحكّم الناشر وسياسات الإعلانات أثناء المزاد على الجهاز.

بعد المزاد داخل المتصفّح

إبلاغ المشتري بنتيجة المزاد: reportWin()

لا تملأ Google الوسيطات التالية:

auctionSignals
sellerSignals

استخدِم reportWin() لإبلاغ المشتري بنتيجة المزاد.

لمزيد من المعلومات، راجِع قسم إعداد تقارير المشترين عن أحداث العرض والإعلان في شرح Protected Audience API.

وحدات ماكرو

يمكن أن يتضمّن renderUrl الذي يشير إلى تصميم Protected Audience API الإعلاني عنصرًا نائبًا واحدًا أو أكثر، يُعرف باسم وحدات الماكرو. بعد انتهاء مزاد المجموعة ذات الاهتمامات المشترَكة، ولكن قبل العرض، يتم استبدال وحدات الماكرو بالقيم المناسبة. يمكن أن تتضمّن renderUrl المستخدَمة في المزاد على الجهاز وحدات الماكرو التالية:

`${GDPR}`	يتم توسيعه إلى 0 إذا كانت اللائحة العامة لحماية البيانات لا تنطبق أو 1 إذا كانت تنطبق. يُرجى الاطّلاع على المستندات.
`${GDPR_CONSENT_XXXX}`	تتوسّع هذه السمة لتشمل سلسلة الموافقة والشفافية المرتبطة بالطلب. إذا كانت سلسلة الموافقة والشفافية فارغة أو غير صالحة، لن تتوسّع وحدة الماكرو هذه. استخدِم وحدة الماكرو هذه لتمرير سلسلة الموافقة والشفافية إلى مورّد مسجَّل في "قائمة المورّدين العالميين" الصادرة عن مكتب IAB في عنوان URL. استبدِل `XXXX` بمعرّف قائمة المورّدين العالميين (GVL) الصادر عن IAB والمخصّص للمورّد المسجّل في هذه القائمة. إذا كانت سلسلة الموافقة والشفافية فارغة أو غير صالحة، لن يتم توسيع هذا الماكرو. قد يتم حظر مواد العرض التي تتضمّن الماكرو `${GDPR_CONSENT_XXXX}` إذا لم يحصل المورّد المسجّل في قائمة المورّدين العالميين التابعة لمكتب IAB والمرتبط بمعرّف قائمة المورّدين العالميين التابعة لمكتب IAB الذي أدرجته على موافقة المستخدم. يجب أن يظهر الماكرو `${GDPR_CONSENT_XXXX}` مرة واحدة فقط ضمن `renderUrl`.
`${ADDL_CONSENT}`	تتوسّع إلى سلسلة الموافقة الإضافية المرتبطة بالطلب.
`${AD_WIDTH}, ${AD_HEIGHT)`	تُدرِج وحدات الماكرو هذه عرض خانة الإعلان وارتفاعها.
`${RENDER_DATA_buyer.origin.example[_OPTIONAL_SUFFIX]}`	وحدة ماكرو تحتوي على إشارات المشتري لوقت العرض المحدّدة في ردّ عرض السعر. استبدِل العنصر النائب `buyer.origin.example` بالمصدر الخاص بالمشتري في مجموعة الاهتمامات، والذي يجب أن يتطابق مع `interest_group_buyers.origin` في ردّ طلب عروض الأسعار. يمكنك تضمين `_OPTIONAL_SUFFIX` لتقديم ما يصل إلى ثلاث قيم مختلفة لإشارات العرض.

احتساب عدد مرّات الظهور

أثناء اختبار Protected Audience API مع شركاء عروض الأسعار في الوقت الفعلي، ستحتسب Google مرات الظهور عندما يستدعي المتصفّح الدالة reportResult()، ثم يسترد عنوان URL الخاص بإعداد التقارير من Google في طلب إلى sendReportTo().

بما أنّ الحدث الذي تستخدمه Google لاحتساب مرّات الظهور في مزادات Protected Audience داخل المتصفّح قد يختلف عن الحدث الذي يستخدمه شركاءها من مشتري عروض الأسعار في الوقت الفعلي لاحتساب مرّات الظهور، قد تختلف أعداد مرّات الظهور.

أحد أهداف Google من اختبار Protected Audience API هو تحديد هذه الاختلافات والحدّ منها.

تحديد مصدر مرات الظهور القابلة للفوترة

يتمّ تحديد مصدر جميع إنفاق مقدّم العروض من مزادات Protected Audience داخل المتصفّح على أنّه حساب واحد لمقدّم العروض استنادًا إلى عملية الربط من مصادر مالك مجموعة الاهتمامات التي تمّ إعدادها لمقدّم العروض. لا تتوفّر إمكانية تحديد مصدر الإنفاق في حسابات المقاعد الفرعية المختلفة الخاصة بأحد مقدّمي عروض الأسعار.

الحد الأقصى للميزانية اليومية

أثناء اختبار واجهة برمجة التطبيقات Protected Audience، يكون لكل حساب حد أقصى للميزانية اليومية التي يتم إنفاقها على Protected Audience على مستوى الحساب، ويحدّ هذا الحد الأقصى من المخاطر في بيئة المزاد داخل المتصفّح. بعد بلوغ الحدّ الأقصى للميزانية اليومية، لن يتلقّى الحساب طلبات عروض أسعار مؤهّلة في Protected Audience.

يمكن أن يواصل الحساب المشاركة في مزادات الاستهداف السياقي من جهة الخادم بعد بلوغ الحد الأقصى المسموح به في Protected Audience. على سبيل المثال، قد يتلقّى حساب مقدّم عروض بلغ الحد الأقصى المسموح به في Protected Audience طلب عرض سعر يتضمّن auction_environment = SERVER_SIDE_AUCTION (OpenRTB JSON: 0)، حتى إذا كان طلب عرض السعر مؤهّلاً للمشاركة في مزاد Protected Audience.

الملاحظات في الوقت الفعلي والحدّ الأدنى لعرض السعر للفوز

سيتلقّى مقدّمو عروض الأسعار الذين وافقوا على تلقّي ملاحظات في الوقت الفعلي ملاحظات بشأن مشتري المجموعات ذات الاهتمامات الذين طُلب إدراجهم في مزاد Protected Audience على الجهاز. سيتلقّى كل مشترٍ لمجموعة اهتمامات يحدّده مقدّم العرض في ردّ على عرض السعر عنصر ملاحظات واحدًا، بغض النظر عن عدد عروض الأسعار التي يقدّمها المشتري في مزاد Protected Audience. ستتوفّر المعلومات التالية في عنصر ملاحظات المشتري حول المجموعة ذات الاهتمامات المشتركة:

سيكون نوع الملاحظات في عنصر الملاحظات هو INTEREST_GROUP_BUYER_FEEDBACK.
مصدر المشتري في المجموعة ذات الاهتمامات المشترَكة
الحدّ الأدنى لعرض السعر الذي يجب أن يقدّمه المشتري من مجموعة الاهتمامات للفوز بالمزاد بشكل عام.
الحدّ الأدنى لعرض السعر الذي يجب أن يقدّمه المشتري المهتم بالمجموعة من أجل التفوق على عرض السعر الأعلى ترتيبًا من مكوّن المزاد الإجمالي من جهة الخادم.
رمز الحالة الخاص بالمشتري في المجموعة ذات الاهتمامات المشتركة يتم تحديد رموز الحالة المحتملة في interest-group-buyer-status-codes.txt.

راجِع مستندات البروتوكول الخاصة بالمزايدة في الوقت الفعلي في "المشترون المعتمَدون" وإضافات OpenRTB للاطّلاع على أسماء الحقول المحدّدة.

إشعار بشأن ملاحظات حول عروض الأسعار

يوفّر Chrome واجهة برمجة تطبيقات مؤقتة لتصحيح الأخطاء في Protected Audience API، ما يتيح لـ "مدير إعلانات Google" إرسال إشعارات تصحيح الأخطاء في الوقت الفعلي من الخادم إلى الخادم تتضمّن ملاحظات حول عرض أسعار في Protected Audience. سيتضمّن هذا الإشعار أسبابًا محتملة لتصفية عروض الأسعار في مزاد Protected Audience داخل المتصفّح، بالإضافة إلى معلومات أخرى عن عرض السعر موضّحة أدناه.

يمكن مقدّمي عروض الأسعار التواصل مع مدير حساباتهم لضبط عنوان URL ثابت سيتم استخدامه لإرسال إشعارات ملاحظات تصحيح الأخطاء بشأن عروض الأسعار في Protected Audience. سيتم جلب عنوان URL الثابت هذا من خوادم Google مع استبدال وحدات الماكرو المحدّدة بعد اكتمال مزاد Protected Audience. يمكن استخدام وحدات الماكرو التالية:

‫%%GOOGLE_QUERY_ID%%: يتم استبدال وحدة الماكرو هذه بمعرّف طلب البحث من Google الذي تم إرساله في طلب عرض الأسعار المستنِد إلى السياق والمفعَّل من خلال Protected Audience. في بروتوكول OpenRTB، يتم تحديد ذلك باستخدام BidRequest.ext.google_query_id، بينما يستخدم بروتوكول عرض الأسعار في الوقت الفعلي (RTB) من Google المتوقّف نهائيًا BidRequest.google_query_id.
‫%%INTEREST_GROUP_OWNER%%: مصدر مالك مجموعة الاهتمامات.
%%BID_CPM%%: سعر عرض السعر لكل ألف ظهور الذي حدّده المعلِن في الدالة generateBid()
‫%%RENDER_URL%%: عنوان URL لعرض تصميم الإعلان.
‫%%STATUS%%: رمز الحالة في حال تم رفض عرض السعر خلال scoreAd(). القيم هي رموز حالة تصميم الإعلان.

في ما يلي نموذج لعنوان URL ثابت قد يقدّمه مقدّم عروض الأسعار إلى مدير حسابه:

https://dsp.example/debug?google_query_id=%%GOOGLE_QUERY_ID%%&ig_owner=%%INTEREST_GROUP_OWNER%%&render_url=%%RENDER_URL%%&bid=%%BID_CPM%%&status=%%STATUS%%

إشعار ملاحظات عروض الأسعار هو ميزة مؤقتة تعتمد على واجهة برمجة التطبيقات المؤقتة ForDebuggingOnly في Chrome.

TURTLEDOVE على مستوى المنتج

تتوفّر الإعلانات المكوّنة من أجزاء متعدّدة أو TURTLEDOVE على مستوى المنتج (PLTD) لشركاء "عرض الأسعار في الوقت الفعلي" من Google أثناء اختبار واجهة Protected Audience API. يُرجى إبلاغ مدير حسابك أثناء عملية الدمج إذا كنت تخطّط لاختبار PLTD، لأنّ ذلك يتطلّب موارد وإعدادات إضافية.

الإعداد

إليك كيفية اختبار Protected Audience API:

الخطوات

املأ نموذج الطلب للانضمام إلى تجربة Protected Audience API.
بعد إرسال نموذج الطلب، تواصَل مع مدير حسابك أو أرسِل تذكرة دعم باستخدام مركز مساعدة Authorized Buyer.
بعد إعداد الحساب، يمكن لكل من Google والشريك التحقّق من عملية الدمج من خلال الخطوات الواردة في مراحل الاختبار.

مراجعة المواد الإبداعية

لتقديم عروض أسعار باستخدام إعلانات على مستوى المنتج (إعلانات مؤلّفة من عدّة أجزاء) في مزادات Protected Audience API، اتّبِع المتطلبات التالية:

أدرِج مَعلمة طلب البحث &pltd=True في renderUrl لحاوية الإعلان المكوّن (المعروفة أيضًا باسم renderUrl المستوى الأعلى) من أجل التمييز بين renderUrls المستوى الأعلى أثناء مراجعة تصميم الإعلان.
عرض تصميم إعلان تمثيلي عند جلب حاوية الإعلان المكوّن لإجراء مراجعة لتصميم الإعلان من قِبل Google لمعرفة الوقت الذي يجب فيه عرض إعلان تمثيلي، يمكنك الرجوع إلى مَعلمة طلب البحث validation=True التي يضبطها نظام مراجعة تصميمات الإعلانات في Google.

قائمة التحقّق من عملية الدمج

إعداد نقطة نهاية لطلب عروض الأسعار ستملأ الحقول ذات الصلة بواجهة Protected Audience API في الردّ على عرض الأسعار السياقي، مثل interest_group_bidding
تنفيذ عملية وضع العلامات على صفحات المعلِن لربط متصفّح المستخدِم بمجموعة الاهتمامات
نفِّذ الترميزَين generateBid() وreportWin().
اختَر مصادر مالكي المجموعات ذات الاهتمامات المشترَكة وأضِفها إلى حساب Authorized Buyer.
- يجب أن تتطابق مصادر مالكي المجموعات المستنِدة إلى الاهتمامات مع المصادر التي يتم استضافة وظائف generateBid() فيها.
- يُرجى التواصل مع مدير الحساب أو إرسال طلب دعم باستخدام مركز مساعدة برنامج Authorized Buyer لإكمال هذه الخطوة.
إعداد ميزة "الاستهداف المُسبَق" للمستودع الإعلاني ذي الصلة باختبار Protected Audience API
أرسِل تصاميم الإعلانات للمراجعة والموافقة من خلال واجهة برمجة التطبيقات الخاصة بتصاميم الإعلانات.
(اختياري) إعداد نقاط نهاية إشارات عروض الأسعار الموثوق بها
(اختياري) يمكنك إعداد صفحة معلِن اختبارية تتيح لمهندسي Google إضافة متصفّحاتهم إلى مجموعات الاهتمامات التي يملكها مصدر مشتري مجموعة الاهتمامات. يتيح لنا ذلك بدء مزادات Protected Audience API يدويًا.
(اختياري) فعِّل ميزة تلقّي الملاحظات في الوقت الفعلي في حسابك لتلقّي ملاحظات حول المشترين في مجموعات الاهتمامات الذين طلبت إدراجهم في مزاد Protected Audience.
(اختياري) تواصَل مع مدير حسابك لإعداد عنوان URL ثابت لتلقّي إشعار من الخادم إلى الخادم يقدّم ملاحظات حول عروض الأسعار في Protected Audience API بشأن حالة عرض سعر من مزاد Protected Audience على الجهاز للمساعدة في تصحيح الأخطاء غير المتوقّعة. لمزيد من التفاصيل، اطّلِع على إشعار ملاحظات حول عروض الأسعار.

مراحل الاختبار

المرحلة 1: الاختبار اليدوي

في ما يلي كيفية بدء مزاد Protected Audience يدويًا والتأكّد من إمكانية عرض الإعلان وتسجيل مرّة الظهور:

استخدِم الإصدار 101 من Chrome أو الإصدارات الأحدث.
فعِّل واجهة Privacy Sandbox API وFenced Frame باستخدام chrome://flags/#privacy-sandbox-ads-apis و chrome://flags/#enable-fenced-frames. يمكنك الاطّلاع على مزيد من المعلومات في تجربة "مبادرة حماية الخصوصية".
أرسِل تصميم إعلان للموافقة عليه باستخدام Real-time Bidding API.
استخدِم صفحة المعلِن التي يوفّرها مقدّم عروض الأسعار لإضافة متصفّح إلى مجموعة الاهتمامات التي يملكها مقدّم عروض الأسعار.
استخدِم صفحة الناشر التجريبي التالية التي توفّرها Google لتفعيل مزاد Protected Audience:

https://fledge-testing.uc.r.appspot.com/?nid=allow_all

يجب أن يقدّم فريق الاهتمامات داخل المتصفّح عرض سعر مرتفعًا بما يكفي للفوز بالمزاد، لأنّه قد يتنافس مع عروض الأسعار التقليدية من جهة الخادم. توفّر Google أيضًا صفحة ناشر تجريبي مخصّصة لكل شريك، حيث يمكن للشريك المحدّد فقط المشاركة في المزاد. قد يكون من الأسهل الفوز بشكل موثوق في مزادات داخل المتصفّح على صفحة خاصة بشريك معيّن.
تحقَّق مما يلي:
1. يتم عرض الإعلان الفائز المتوقّع.
2. يتم إرسال نتيجة المزاد من جهة الخادم، ما يعني أنّ مقدّم عرض السعر الفائز يتلقّى إشارة ردّ من reportWin().
3. تسجّل وحدة تحكّم صفحة الناشر التجريبي رسالة تصحيح أخطاء لكل عرض سعر تتضمّن المعلومات التالية:
  - ‫renderUrl: عنوان URL لعرض الإعلان
  - interestGroupOwner: مالك مجموعة الاهتمامات التي تم تقديم عرض السعر لها.
  - ‫accepted: تكون قيمة هذا الحقل true إذا تم قبول عرض السعر، وfalse إذا رفضت scoreAd() عرض السعر.
  - ‫externalBidStatus: رمز الحالة إذا تم رفض عرض السعر خلال scoreAd() القيم هي رموز حالة تصميم الإعلان.

المرحلة 2: (اختيارية) تجربة عدم العرض

بعد أن تتأكّد Google والشريك يدويًا من أنّ الشريك مؤهّل للمشاركة في مزاد Protected Audience، تتيح Google للشريك المرحلة التالية من الاختبار.

تخصّص Google جزءًا صغيرًا من الزيارات المباشرة لإجراء مزادات Protected Audience. بعد ذلك، لن تحتاج Google والشريك إلى بدء مزاد Protected Audience يدويًا. لم يتم عرض نتيجة المزاد الذي يستخدم Protected Audience API. ويتيح لنا ذلك اختبار عملية الدمج على نطاق واسع.

يُرجى التواصل مع مدير حسابك أو إرسال طلب دعم من خلال مركز مساعدة Authorized Buyer عندما تكون مستعدًا. ستفعّل Google الحساب لهذه المرحلة.

المرحلة 3: تجربة العرض

بعد أن تتحقّق Google والشريك من مزادات Protected Audience على نطاق واسع بدون عرض الإعلان، يمكن أن تسمح Google للشريك بعرض الإعلان الفائز في مزاد Protected Audience. تتلقّى Google عددًا قليلاً من الزيارات التي تكون فيها مزادات Protected Audience مؤهَّلة للعرض، ويتم عرض إعلانات مجموعات الاهتمامات الفائزة. تتنافس عروض الأسعار التي يقدّمها مقدّمو عروض الأسعار المشاركون في المتصفّح مع عروض الأسعار التقليدية.

الميزات الإضافية

الميزات التالية هي امتدادات للبروتوكول الأساسي.

الموازاة

التوازي هو تحسين يقلّل من وقت استجابة المزاد من البداية إلى النهاية من خلال بدء طلب الإعلان السياقي بالتوازي مع الطلبات إلى خوادم المشتري الموثوقة المحدّدة في trustedBiddingSignalsUrl.

يؤدي التوازي إلى تقليل وقت الاستجابة، ولكنّه يؤثّر في أهلية المشترين في مجموعات الاهتمامات وفي إمكانية إجراء تجارب منسّقة. تنطبق عملية التنفيذ المتوازي على جميع مقدّمي عروض الأسعار الذين يشاركون في المزاد على الجهاز فقط للمجموعات ذات الاهتمامات المشتركة. لا يحتاج مقدّمو عروض الأسعار إلى اتّخاذ أي إجراء للمشاركة في المزادات المتوازية، ولكن عليهم التعرّف على كيفية تأثير التوازي في أهليتهم للمشاركة في المزادات على الأجهزة. لا تتوفّر بعد معرّفات مجموعات التجربة للتجارب المنسّقة ضمن المزادات المتوازية.

ملخّص عملية العرض

في ما يلي ملخّص لمسار المزاد المتزامن: مخطط انسيابي

أهلية المشترين في مجموعات الاهتمامات على الأجهزة

في المزادات المتوازية، يتم طلب navigator.runAdAuction قبل عرض استجابة الإعلان السياقي. لبدء طلبات الخادم الموثوقة من جانب المشتري، تتطلّب navigator.runAdAuction تمرير المَعلمة interestGroupBuyers كقيمة، بينما تقبل مَعلمات المزاد المتبقية Promises في JavaScript يمكن حلّها بعد الردّ على الإعلان السياقي. بما أنّه يتم تمرير interestGroupBuyers قبل الردّ على الإعلان السياقي، لا يمكن استخدام الردّ على الإعلان السياقي (بما في ذلك ردود عروض الأسعار) لاختيار المشترين الذين يشاركون في المزاد المتوازي للطلب المحدّد. بدلاً من ذلك، تخزّن علامة الناشر من Google في ذاكرة التخزين المؤقت، في متصفّح المستخدم، المَعلمة interestGroupBuyers من عمليات التنفيذ السابقة navigator.runAdAuction على النطاق نفسه.

تتضمّن عملية التنفيذ المتوازي عدة اعتبارات مهمة:

يمكن مواصلة تحديد إشارات المزاد غير اللازمة لطلبات الخادم الموثوق به للمشتري، مثل perBuyerSignals، في ردود عروض الأسعار في الوقت الفعلي بالطريقة نفسها كما هو الحال في المزادات غير المتوازية. بعد حلّ الوعود الخاصة بهذه الإشارات، سيتم إكمال الخطوات المتبقية من المزاد على الجهاز بالطريقة نفسها كما هو الحال في مسار المزاد غير المتوازي.
بما أنّ التوازي يعتمد على تخزين قائمة مشتري المجموعات ذات الاهتمامات المشتركة مؤقتًا، لا تجري Google مزادًا متوازيًا دائمًا، لأنّ ذاكرة التخزين المؤقت للتوازي قد تكون فارغة أو منتهية الصلاحية. إذا كانت ذاكرة التخزين المؤقت فارغة أو انتهت صلاحيتها، ستجري Google مزادًا عاديًا غير متوازٍ باستخدام Protected Audience API، وستستخدِم نية المشتري للمشاركة في المزاد غير المتوازٍ من أجل إنشاء ذاكرة تخزين مؤقت للمشتري في مجموعة الاهتمامات.
إذا تم تخزين بيانات مشترٍ واحد على الأقل لأي مقدّم عروض مؤقتًا لنطاق الناشر الحالي، ستجري Google مزادًا متوازيًا، وسيتم توضيح ذلك في طلب تقديم العروض:
- بروتوكول عرض الأسعار في الوقت الفعلي (RTB) من Google: ‏ BidRequest.adslot.interest_group_auction.parallelized
- OpenRTB: BidRequest.imp.ext.interest_group_auction.parallelized
سيتضمّن كل مصدر لمشتري مجموعة اهتمامات مسجّلة لعارض أسعار معيّن تم تضمينه في المزاد المتوازي إدخال ParallelAuctionBuyer مطابقًا:
- بروتوكول عرض الأسعار في الوقت الفعلي (RTB) من Google: ‏ BidRequest.adslot.interest_group_auction.parallel_auction_buyer
- OpenRTB: BidRequest.imp.ext.interest_group_auction.pbuyer
في حال إجراء مزاد متوازٍ، ولكن لم يتوفّر مصدر مشتري معيّن في ذاكرة التخزين المؤقت، لا يمكن إضافة هذا المشتري إلى المزاد الحالي على الجهاز. يتم الإشارة إلى ذلك من خلال طلب يتضمّن parallelized=True ولا يتضمّن إدخال ParallelAuctionBuyer لمصدر مشتري مجموعة اهتمامات معيّنة. ومع ذلك، فإنّ مقدّمي عروض الأسعار الذين يشيرون إلى اهتمامهم من خلال تضمين InterestGroupBuyer(s) صالحة ومؤهّلة في ردّ عرض السعر ستتم إضافة مصادر مشتري المجموعة باهتمامات مشتركة ذات الصلة إلى ذاكرة التخزين المؤقت، وستكون هذه المصادر مؤهّلة لتلقّي طلبات متوازية مستقبلية من المتصفّح والنطاق نفسهما. يمكن الإشارة إلى نية المشاركة في مزادات المجموعات ذات الاهتمامات المشتركة في الحقول التالية:
- بروتوكول عرض الأسعار في الوقت الفعلي (RTB) من Google: ‏ BidResponse.adslot.interest_group_bidding.interest_group_buyers
- OpenRTB: BidResponse.ext.igbid.igbuyer
قد تتلقّى مصادر المشترين المخزّنة مؤقتًا (المضمّنة في المَعلمة interestGroupBuyers في المزاد الموازي) التي لا يشير مقدّم العرض إلى نيّته المشاركة في ردّ عرض السعر طلبًا من خادم موثوق به للمشتري، ولكنّها لن تشارك في المزاد الموازي.

Protected Audience API (المعروفة سابقًا باسم FLEDGE) تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

ملخّص عملية العرض

تفاصيل مسار العرض

قبل عرض الإعلانات

مراجعة تصميم الإعلان

Real-time Bidding API

المسح التلقائي للتصاميم

انتهاء صلاحية تصميم الإعلان

معرّف إعداد التقارير لدى المشتري

المزاد من جهة الخادم

تغييرات طلبات عروض الأسعار

تحديد ما إذا كان المزاد يتيح المجموعات حسب الاهتمامات

تحديد حجم الخانة الإعلانية في Protected Audience API

تحديد ما إذا كان يمكن عرض إعلانات Protected Audience

تقليل الاعتماد على معرّفات المستخدمين

اختبار الإيقاف النهائي لملفات تعريف الارتباط التابعة لجهات خارجية الذي يسهّله متصفّح Chrome

تغييرات في الاستجابة لعرض السعر

تحديد المشاركة في مزاد المجموعات ذات الاهتمامات المشترَكة

نقل الإشارات السياقية للمشترين

نقل إشارات العرض السياقي للمشتري

تحديد الحدّ الأقصى لسعر عرض السعر داخل المتصفّح

إسناد مرّات الظهور إلى حسابات متعدّدة

أثناء المزاد داخل المتصفّح

إنشاء عروض أسعار داخل المتصفّح

عملة عرض السعر

عمليات التحقّق من جودة الإعلانات

التوافق مع "قانون الخدمات الرقمية"

فلترة عروض الأسعار

بعد المزاد داخل المتصفّح

إبلاغ المشتري بنتيجة المزاد: reportWin()

وحدات ماكرو

احتساب عدد مرّات الظهور

تحديد مصدر مرات الظهور القابلة للفوترة

الحد الأقصى للميزانية اليومية

الملاحظات في الوقت الفعلي والحدّ الأدنى لعرض السعر للفوز

إشعار بشأن ملاحظات حول عروض الأسعار

TURTLEDOVE على مستوى المنتج

الإعداد

الخطوات

مراجعة المواد الإبداعية

قائمة التحقّق من عملية الدمج

مراحل الاختبار

المرحلة 1: الاختبار اليدوي

المرحلة 2: (اختيارية) تجربة عدم العرض

المرحلة 3: تجربة العرض

الميزات الإضافية

الموازاة

ملخّص عملية العرض

أهلية المشترين في مجموعات الاهتمامات على الأجهزة

Protected Audience API (المعروفة سابقًا باسم FLEDGE)