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

دليل المطوِّر في FLEDGE API

من هم المستخدمون المعنيون بهذه المقالة؟

تُعدّ هذه المشاركة مرجعًا فنيًا إلى التكرار الحالي للإصدار التجريبي من Protected Audience API.

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

ما هي ميزة Protected Audience؟

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

Protected Audience هي أول تجربة يتم تنفيذها في Chromium ضمن مجموعة اقتراحات TURTLEDOVE:

يقدّم المخطّط أدناه نظرة عامة على مراحل نشاط FLEDGE:

صورة توضيحية تعرض نظرة عامة على كل مرحلة من مراحل نشاط FLEDGE — مراحل نشاط FLEDGE

كيف يمكنني تجربة ميزة Protected Audience؟

الإصدار التجريبي من Protected Audience

تتوفّر جولة تفصيلية حول عملية النشر الأساسية باستخدام Protected Audience على المواقع الإلكترونية للمعلِنين والناشرين على protected-audience-demo.web.app.

الفيديو التوضيحي يشرح طريقة عمل الرمز التجريبي ويوضّح كيفية استخدام "أدوات مطوري البرامج في Chrome" لتصحيح أخطاء الجمهور المحمي.

المشاركة في مرحلة التجربة والتقييم في Protected Audience

تمت مرحلة التجربة والتقييم ومدى الصلة بمبادرة حماية الخصوصية متوفّرة في الإصدار التجريبي 101.0.4951.26 من Chrome والإصدارات الأحدث على أجهزة الكمبيوتر المكتبي، وذلك لميزة Protected Audience المواضيع واجهات برمجة تطبيقات Attribution Reporting

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

بعد التسجيل بنجاح في الفترة التجريبية، يمكنك تجربة Protected Audience JavaScript API على الصفحات. توفِّر رمزًا مميّزًا صالحًا للتجربة: على سبيل المثال، يمكنك توجيه طلب إلى المتصفّح للانضمام إلى مجموعة واحدة أو أكثر من مجموعات الاهتمامات. ثم إجراء مزاد إعلانات لاختيار إعلان وعرضه.

يقدِّم العرض التوضيحي لميزة Protected Audience مثالاً أساسيًا على عملية نشر Protected Audience بشكل شامل.

قدِّم رمزًا مميّزًا تجريبيًا لكل صفحة تريد تشغيل رمز Protected Audience API عليها:

كعلامة وصفية في <head>:

<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
كعنوان HTTP:

Origin-Trial: TOKEN_GOES_HERE

من خلال توفير رمز مميّز آليًا:

const otMeta = document.createElement('meta');
otMeta.httpEquiv = 'origin-trial';
otMeta.content = 'TOKEN_GOES_HERE';
document.head.append(otMeta);

إطار iframe يستخدم رمز Protected Audience، مثل navigator.joinAdInterestGroup() طلب اتصال من قِبل مالك مجموعة ذات اهتمامات مشتركة - سيحتاج إلى تقديم رمز مميز يتطابق مع مصدره.

التفاصيل المقترَحة بشأن أصل شرائح الجمهور المحمية الأولى وتوفر المزيد من التفاصيل حول أهداف التجربة الأولى وتشرح الميزات المتاحة.

اختبار واجهة برمجة التطبيقات هذه

يمكنك اختبار Protected Audience لمستخدم واحد في الإصدار التجريبي 101.0.4951.26 من Chrome والإصدارات الأحدث على أجهزة الكمبيوتر المكتبي:

من خلال تفعيل جميع واجهات برمجة تطبيقات الخصوصية في عرض الإعلانات ضِمن "chrome://settings/adPrivacy"
عن طريق وضع علامات من سطر الأوامر.

عرض الإعلانات في إطارات iframe أو إطارات محاطة بحدود

يمكن عرض الإعلانات في <iframe> أو <fencedframe> بناءً على العلامات التي يتم ضبطها.

لاستخدام <fencedframe> لعرض الإعلانات:

--enable-features=InterestGroupStorage,AdInterestGroupAPI,Fledge,FencedFrames

لاستخدام <iframe> لعرض الإعلانات:

--enable-features=InterestGroupStorage,AdInterestGroupAPI,Fledge,AllowURNsInIframes --disable-features=FencedFrames

ضمِّن العلامة BiddingAndScoringDebugReportingAPI لتفعيل طرق الإبلاغ عن فقدان الأخطاء/الفوز المؤقت.

تشغيل Chromium باستخدام العلامات طريقة وضع العلامات عند تشغيل Chrome والمتصفحات الأخرى المستندة إلى Chromium من خلال الأمر الخط. تتوفّر القائمة الكاملة لعلامات "الجمهور المحمي" من البحث في رموز Chromium

ملاحظة: هذا إصدار قيد التقدّم من Protected Audience لاستخدامها في الاختبار المبكر. لا ينبغي اعتباره كاملة أو مؤشرًا على التنفيذ النهائي. تتم مناقشة مستوى تقدّم ميزة "شرائح الجمهور المحمية" وحالتها في اجتماعات WICG المنتظمة. الدقائق لمكالمة WICG لعام 2021-05-12، يُرجى تقديم تفاصيل حول الميزات المتاحة وتلك غير المتاحة في إطار التنسيق الحالي التنفيذ. يوفّر المخطط الزمني لـ "مبادرة حماية الخصوصية" توقيت التنفيذ. معلومات عن Protected Audience وغير ذلك من اقتراحات "مبادرة حماية الخصوصية"

ما هي الميزات المتوفرة في أحدث إصدار من Chrome؟

يتم توفير Protected Audience بعد علامات الميزات في Chromium للمرة الأولى جرِّب اختبار الميزات التالية لاقتراح Protected Audience:

مجموعات الاهتمامات: يخزّنها المتصفّح، مع بيانات وصفية مرتبطة بها لإعداد عروض أسعار الإعلانات والعرض.
عروض الأسعار على الجهاز فقط حسب المشترين (DSP أو المعلن): استنادًا إلى مجموعات الاهتمامات والإشارات المخزّنة. من البائع.
اختيار البائع للإعلانات على الجهاز فقط (SSP أو الناشر): استنادًا إلى عروض أسعار المزاد البيانات الوصفية من المشترين.
عرض الإعلانات في إصدار مريح مؤقتًا من ميزة Fenced Frames: مع الوصول إلى الشبكة تسجيل الدخول لعرض الإعلان

مزيد من التفاصيل في الشرح حول واجهة برمجة التطبيقات حول دعم الميزة والقيود.

أذونات المجموعات ذات الاهتمامات المشتركة

الإعداد التلقائي في التنفيذ الحالي لميزة Protected Audience هو السماح بالاتصال بـ joinAdInterestGroup() من في أي مكان في الصفحة، حتى من إطارات iframe عبر النطاقات. في المستقبل، عندما يكون لدى مالكي المواقع بعض الوقت لتعديل سياسات أذونات iframe عبر النطاقات، تتمثل الخطة في منع المكالمات الواردة من إطارات iframe عبر النطاقات، كما هو موضح في الشرح.

خدمة المفتاح/القيمة

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

يتوفّر الآن رمز خدمة القيمة/مفتاح الجمهور المحمي في مستودع GitHub ضمن "مبادرة حماية الخصوصية". يمكن أن يستخدم مطوّرو Chrome وAndroid هذه الخدمة. يمكنك الاطّلاع على مشاركة المدونة التي تتضمّن الإعلان لمعرفة آخر المعلومات عن الحالة. يمكنك الاطّلاع على مزيد من المعلومات عن خدمة Protected Audience Key/القيمة من خلال شرح واجهة برمجة التطبيقات وشرح نموذج الثقة.

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

لضمان توفُّر ما يكفي من الوقت لاختبار المنظومة المتكاملة، لا نتوقّع أن نطلب استخدام خدمات المفاتيح/القيمة المفتوحة المصدر أو بيئة التنفيذ الموثوقة (TEE) إلا بعد إيقاف ملفات تعريف الارتباط التابعة لجهات خارجية نهائيًا. وسنرسل إشعارًا مهمًا إلى المطوّرين لبدء اختبار التطبيقات واعتمادها قبل تنفيذ عملية النقل هذه.

الكشف عن دعم الميزات

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

'joinAdInterestGroup' in navigator &&
  document.featurePolicy.allowsFeature('join-ad-interest-group') &&
  document.featurePolicy.allowsFeature('run-ad-auction') ?
  console.log('navigator.joinAdInterestGroup() is supported on this page') :
  console.log('navigator.joinAdInterestGroup() is not supported on this page');

كيف يمكنني إيقاف ميزة Protected Audience؟

يمكنك حظر الوصول إلى Protected Audience API سواء كنت مالكًا لموقع إلكتروني أو مستخدمًا فرديًا.

كيف يمكن للمواقع الإلكترونية التحكّم في إمكانية الوصول إليها؟

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

هناك سياستان لأذونات "الجمهور المحمي" يمكن ضبطهما بشكل مستقل:

تفعيل/إيقاف وظيفة "join-ad-interest-group" لإضافة متصفّح إلى مجموعات الاهتمامات
تفعيل/إيقاف وظيفة "run-ad-auction" لتنفيذ مزاد على الجهاز

يمكن إيقاف إمكانية الوصول إلى واجهات برمجة التطبيقات Protected Audience API تمامًا في سياقات الطرف الأول من خلال تحديد ما يلي: سياسة الأذونات في عنوان استجابة HTTP:

Permissions-Policy: join-ad-interest-group=(), run-ad-auction=()

يمكنك إيقاف استخدام واجهات برمجة التطبيقات في إطار iframe من خلال إضافة سمة allow التالية إلى عنصر iframe:

<iframe src="https://example.com" allow="join-ad-interest-group 'none'; run-ad-auction 'none'"></iframe>

يقدّم قسم سياسة الأذونات التجريبية لأذونات الاستخدام التجريبي المقترَحة المتعلّقة بأوّل شرائح جمهور محمية في Google مزيدًا من التفاصيل.

إيقاف مشاركة البيانات من جانب المستخدم

يمكن للمستخدم حظر الوصول إلى Protected Audience API وغيرها من ميزات "مبادرة حماية الخصوصية" باستخدام أيّ من الآليات التالية:

إيقاف الإصدارات التجريبية من "مبادرة حماية الخصوصية" في إعدادات Chrome: الإعدادات > الأمان والخصوصية > مبادرة حماية الخصوصية ويمكن الوصول إلى ذلك أيضًا على العنوان chrome://settings/adPrivacy.
إيقاف ملفات تعريف الارتباط التابعة لجهات خارجية في إعدادات Chrome: الإعدادات > الأمان والخصوصية:
اضبط ملفات تعريف الارتباط وبيانات الموقع الإلكتروني الأخرى على "حظر ملفات تعريف الارتباط التابعة لجهات خارجية". أو "حظر جميع ملفات تعريف الارتباط" ابتداءً من chrome://settings/cookies
استخدام "وضع التصفّح المتخفي"

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

تصحيح الأخطاء في أدوات "الجمهور المحمي"

من الإصدار 98.0.4718.0 من Chrome Canary، من الممكن تصحيح أخطاء أدوات Protected Audience API ضمن "أدوات مطوري البرامج في Chrome".

تتمثّل الخطوة الأولى في تحديد نقاط الإيقاف من خلال فئة جديدة في لوحة النقاط الفاصلة لمستمع الحدث. في لوحة المصادر.

لقطة شاشة عن
"أدوات مطوري البرامج" في Chrome Canary، مع تمييز لوحة "النقاط الفاصلة لأداة معالجة الأحداث" في لوحة "المصادر"
تم اختيار بدء مرحلة "عروض أسعار نظام عروض الأسعار" ضمن "وظيفة مزاد الإعلانات".

فعند تشغيل نقطة توقف، يتم إيقاف التنفيذ مؤقتًا قبل العبارة الأولى في المستوى الأعلى من البرنامج النصي للعمل. يمكنك استخدام نقاط التوقف أو أوامر الخطوات المعتادة للوصول إلى عروض الأسعار أو النتائج أو إعداد التقارير. لوظيفة نفسها.

ستظهر أيضًا النصوص البرمجية المباشرة للعمل ضمن لوحة Threads.

لقطة شاشة عن
"أدوات مطوري البرامج" في Chrome Canary، مع إبراز لوحة "سلاسل المحادثات" في لوحة "المصادر"، مع إظهار
نص برمجي محدد تم إيقافه مؤقتًا.

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

تتبُّع أحداث Protected Audience

من لوحة التطبيق في "أدوات مطوري البرامج في Chrome"، يمكنك متابعة المزاد وفئات الاهتمام ضمن Protected Audience API. أحداث.

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

تشير رسالة الأشكال البيانية
لوحة تطبيق "أدوات مطوري البرامج" في Chrome Canary، تعرض معلومات حول مجموعة اهتمامات "الجمهور المحمي"
الانضمام إلى الحدث.

والآن، إذا انتقلت إلى الموقع الإلكتروني للناشر في العرض التوضيحي لتطبيق Protected Audience في متصفّح تم فيه تفعيل Protected Audience، تعرض "أدوات مطوري البرامج" معلومات عن حدثَي bid وwin.

تشير رسالة الأشكال البيانية
لوحة تطبيق "أدوات مطوري البرامج" في Chrome Canary، تعرض معلومات عن عرض سعر مزاد Protected Audience API
بالأحداث.

ما هي آلية عمل Protected Audience API؟

في هذا المثال، يتصفح أحد المستخدمين الموقع الإلكتروني لصانع دراجات مخصص، ثم يزور لاحقًا موقع أخبار ثم يظهر له إعلان عن دراجة جديدة من صانع الدراجات

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

1. يزور أحد المستخدمين موقعًا إلكترونيًا للمعلن

صورة توضيحية تعرض
رجل يزور موقعًا إلكترونيًا خاصًا بالشركة المصنعة للدراجات في متصفح على الكمبيوتر المحمول.

تخيل أن أحد المستخدمين يزور الموقع الإلكتروني لصانع دراجات مخصص (المعلن في هذا المثال) ويقضي بعض الوقت على صفحة المنتج لدراجة فولاذية مصنوعة يدويًا. يوفر هذا صانع دراجات لديه فرصة تجديد نشاط تسويقي.

مصطلح رئيسي: المنصة جانب الطلب (DSP) هي خدمة تكنولوجيا الإعلان تُستخدم لبرمجة شراء الإعلانات. أنظمة DSP يستخدمه المعلنون لشراء مرات ظهور الإعلان في مجموعة من المواقع الإلكترونية للناشرين عرض الناشرون المساحة المتوفّرة للإعلانات للبيع من خلال أسواق تسمى Ad Exchange (تبادل الإعلانات)، ويحدد DSP بشكل آلي الإعلانات المتاحة مرات الظهور الأكثر منطقية بالنسبة إلى المعلن للشراء. منصّة جهة التوريد (SSP) هي خدمة تكنولوجيا الإعلان تُستخدَم لبرمجة بيع المساحة المتوفّرة للإعلانات. منصات عرض المبيعات (SSP) السماح للناشرين بعرض مخزونهم (المستطيلات الفارغة التي ستنتقل إليها الإعلانات) في إعلانات متعددة والتبادلات وDSP والشبكات. يتيح ذلك لمجموعة كبيرة من المشترين المحتملين تقديم عروض أسعار لمساحة إعلانية.

2. سيُطلَب من متصفّح المستخدم إضافة مجموعة اهتمامات.

صورة توضيحية تعرض شخصًا يشاهد موقعًا إلكترونيًا في متصفّح على كمبيوتر محمول JavaScript
يعمل الرمز joinAdinterestGroup() في المتصفح.

قسم الشرح: مجموعات الاهتمامات المسجّلة للمتصفّحات

وسيط عرض الطلب (DSP) للمعلِن (أو المعلن) نفسه) navigator.joinAdInterestGroup() لمطالبة المتصفّح بإضافة مجموعة اهتمامات إلى قائمة بالمجموعات التي ينتمي إليها المتصفّح. في هذا المثال، تُسمى المجموعة custom-bikes، المالك هو dsp.example. سيكون مالك مجموعة الاهتمامات (في هذه الحالة، وسيط عرض الطلب) المشتري في مزاد الإعلانات الموضّح في الخطوة 4. يُخزِّن المتصفّح عضوية مجموعة الاهتمامات على جهاز المستخدم، ولا تتم مشاركتها مع أو مورد المتصفح أو أي شخص آخر.

ملاحظة: يجب أن يتطابق أصل سياق الاتصال للسمة joinAdInterestGroup() مع مجموعة الاهتمامات. المصدر الخاص بالمالك، لذلك يلزم استدعاء joinAdInterestGroup() من إطار iframe (ل من وسيط عرض الطلب) ما لم يتطابق أصل مالك مجموعة الاهتمامات مع أصل الصفحة (على سبيل المثال، موقع إلكتروني يضم مجموعات اهتمامات خاصة). لا يستوفي runAdAuction المتطلبات نفسها، لذا يُرجى الاتصال بـ runAdAuction() من <script> من المحتمل أن تكون العلامة التجارية أفضل بكثير من إطار iframe من مصادر متعددة.

يتطلّب تطبيق "joinAdInterestGroup()" إذنًا من:

الموقع الإلكتروني الذي تتم زيارته
مالك مجموعة الاهتمامات

على سبيل المثال: يجب ألا يكون من الممكن لـ "malicious.example" الاتصال joinAdInterestGroup() مع dsp.example كمالك بدون إذن dsp.example

إذن من الموقع الإلكتروني الذي تتم زيارته

المصدر نفسه: بشكل تلقائي، يتم منح الإذن بشكل ضمني لمكالمات joinAdInterestGroup() من المصدر نفسه للموقع الذي تتم زيارته، أي من المصدر نفسه الذي يصل إليه إطار المستوى الأعلى الصفحة الحالية. يمكن للمواقع الإلكترونية استخدام عنوان سياسة أذونات Protected Audience API. التوجيه join-ad-interest-group لإيقاف مكالمات joinAdInterestGroup().

مصادر متعددة: يتم طلب joinAdInterestGroup() من مصادر مختلفة عن المصادر الحالية. لا يمكن أن تنجح الصفحة إلّا إذا ضبط الموقع الإلكتروني الذي تتم زيارته سياسة أذونات تسمح بالمكالمات joinAdInterestGroup() من إطارات iframe من مصادر متعددة.

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

إذن من مالك مجموعة الاهتمامات

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

الاقتراح هو أنّه يمكن تنفيذ joinAdInterestGroup() في صفحة أو إطار iframe في نطاق المالك. تفويضها إلى نطاقات أخرى مقدمة باستخدام قائمة على عنوان URL .well-known.

استخدام navigator.joinAdinterestGroup()

في ما يلي مثال على كيفية استخدام واجهة برمجة التطبيقات:

const interestGroup = {
  owner: 'https://dsp.example',
  name: 'custom-bikes',
  biddingLogicUrl: ...,
  biddingWasmHelperUrl: ...,
  dailyUpdateUrl: ...,
  trustedBiddingSignalsUrl: ...,
  trustedBiddingSignalsKeys: ['key1', 'key2'],
  userBiddingSignals: {...},
  ads: [bikeAd1, bikeAd2, bikeAd3],
  adComponents: [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2],
};

navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);

يجب ألا يزيد حجم كائن interestGroup الذي يتم تمريره إلى الدالة عن 50 كيلوبايت، وإلا فستفشل الاتصال. تحدد المعلمة الثانية مدة مجموعة الاهتمامات، بحد أقصى 30 أيام. تحل المكالمات المتتالية محل القيم المخزَّنة سابقًا.

نقطة رئيسية: يجب أن تكون جميع عناوين URL المستخدَمة كمَعلمات لطرق Protected Audience API من مصادر آمنة، ويجب أن تكون جميع الموارد متوافقة. عبر عناوين URL لبروتوكول HTTPS. كيفية استخدام HTTPS في التطوير المحلي تشرح هذه المقالة كيفية إجراء ذلك عند تشغيل Protected Audience على الجهاز. بالإضافة إلى ذلك، تتطلّب جميع biddingLogicUrl وdecisionLogicUrl وtrustedBiddingSignals عنوان استجابة HTTP X-Allow-FLEDGE: true.

مواقع المجموعة ذات الاهتمامات المشتركة

الموقع	مطلوب	مثال	الدور
`owner`	مطلوب	`'https://dsp.example'`	مصدر مالك مجموعة الاهتمامات.
`name`	مطلوب	`'custom-bikes'`	اسم مجموعة الاهتمامات.
`biddingLogicUrl`**	اختياري*	`'https://dsp.example/bid/custom-bikes/bid.js'`	عنوان URL لعرض أسعار JavaScript يتم تشغيله في Worklet.
`biddingWasmHelperUrl`**	اختياري*	`'https://dsp.example/bid/custom-bikes/bid.wasm'`	عنوان URL لرمز WebAssembly الذي تم الاستناد إليه من `biddingLogicUrl`.
`dailyUpdateUrl`**	اختياري	`'https://dsp.example/bid/custom-bikes/update'`	عنوان URL يعرض ملف JSON لتعديل سمات مجموعة الاهتمامات (اطّلع على تعديل مجموعة الاهتمامات.)
`trustedBiddingSignalsUrl`**	اختياري	`'https://dsp.example/trusted/bidding-signals'`	عنوان URL الأساسي لطلبات المفتاح/القيمة إلى الخادم الموثوق به لدى مقدِّم عرض السعر.
`trustedBiddingSignalsKeys`	اختياري	`['key1', 'key2' ...]`	مفاتيح للطلبات المُرسَلة إلى خادم موثوق به ذي قيمة أساسية
`userBiddingSignals`	اختياري	`{...}`	البيانات الوصفية الإضافية التي يمكن للمالك استخدامها أثناء تقديم عروض الأسعار
`ads`	اختياري*	`[bikeAd1, bikeAd2, bikeAd3]`	الإعلانات التي قد يتم عرضها لمجموعة الاهتمامات هذه.
`adComponents`	اختياري	`[customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2]`	مكونات الإعلانات المؤلفة من عدة أجزاء.

* جميع السمات اختيارية باستثناء owner وname. biddingLogicUrl وads المواقع اختيارية، ولكنها مطلوبة للمشاركة في مزاد. قد تكون هناك حالات استخدام إنشاء مجموعة اهتمامات بدون السمات التالية: على سبيل المثال، قد يختار مالك مجموعة الاهتمامات تريد إضافة متصفح إلى مجموعة اهتمامات لحملة لم يتم عرضها بعد، أو لبعض الأشخاص أي استخدام آخر في المستقبل، أو قد تنفد ميزانيتها الإعلانية مؤقتًا.

** يجب أن يكون مصدر عناوين URL biddingLogicUrl وbiddingWasmHelperUrl وdailyUpdateUrl وtrustedBiddingSignalsUrl هو المصدر نفسه للمالك. ولا يتضمّن عنوانا URL ads وadComponents أي قيد من هذا القبيل.

تعديل سمات مجموعة الاهتمامات

تحدّد الدالة dailyUpdateUrl خادم ويب يعرض ترميز JSON الذي يحدّد سمات مجموعة الاهتمامات. يتوافق مع عنصر مجموعة الاهتمامات الذي تم تمريره إلى navigator.joinAdInterestGroup(). هذا النمط آلية لمالك المجموعة لتحديث سمات المجموعة بشكل دوري ذات الاهتمامات المشتركة. في طريقة التنفيذ الحالية يمكن تغيير السمات التالية:

biddingLogicUrl
biddingWasmHelperUrl
trustedBiddingSignalsUrl
trustedBiddingSignalsKeys
ads
priority

ولن يتم استبدال أي حقل غير محدّد في ملف JSON، ولن يتم استبدال الحقول المحدّدة في ملف JSON فقط. تم تعديل البيانات، بينما يؤدي طلب navigator.joinAdInterestGroup() إلى استبدال أي مجموعة اهتمامات حالية.

وتُعدّ التحديثات أفضل جهد، ويمكن أن يتعذّر إتمامها في الحالات التالية:

مهلة طلب الشبكة (تبلغ حاليًا 30 ثانية).
تعذّر الاتصال بالشبكة الأخرى.
تعذَّر تحليل ملف JSON.

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

تحديثات يدوية

يمكن إجراء تعديلات يدويًا على مجموعات الاهتمامات التي يملكها مصدر الإطار الحالي من خلال من خلال navigator.updateAdInterestGroups() يؤدي تقييد المعدل إلى منع تكرار التحديثات: لا يتم تنفيذ أي إجراء من المكالمات المتكررة إلى navigator.updateAdInterestGroups() إلا بعد الوصول إلى الحدّ الأقصى لمعدّل الاستخدام. قد انقضت فترة (يوم واحد حاليًا). تتم إعادة ضبط الحد الأقصى لمعدّل الاستخدام إذا يتم طلب navigator.joinAdInterestGroup() مرة أخرى لمجموعة الاهتمامات نفسها owner وname.

التحديثات التلقائية

يتم تلقائيًا تعديل جميع مجموعات الاهتمامات التي يتم تحميلها في مزاد بعد اكتمال المزاد. لقيود المعدل نفسها التي تخضع لها التحديثات اليدوية. لكل مالك لديه مجموعة اهتمام واحدة على الأقل المشاركة في مزاد، فالأمر كما لو أن navigator.updateAdInterestGroups() يتم استدعاؤه من إطار iframe الذي يتطابق مصدره مع ذلك المالك

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

يتضمّن العنصران ads وadComponents عنوان URL لتصميم إعلان، كما يمكنك اختيار إجراء عشوائي. بيانات التعريف التي يمكن استخدامها في وقت عرض السعر. على سبيل المثال:

{
  renderUrl: 'https://cdn.example/.../bikeAd1.html',
  metadata: bikeAd1metadata // optional
}

كيف يقدّم المشترون عروض الأسعار؟

يجب أن يتضمن النص البرمجي الموجود في biddingLogicUrl والذي يقدمه مالك مجموعة الاهتمامات generateBid() الأخرى. عندما يتّصل بائع مساحة إعلانية بـ "navigator.runAdAuction()"، يتم عرض generatedBid() مرة واحدة لكل مجموعة من المجموعات ذات الاهتمامات المشتركة التي يكون المتصفح عضوًا فيها، إذا كانت دعوة مالك المجموعة لتقديم عرض أسعار. بعبارة أخرى، يتم استدعاء generateBid() مرة واحدة لكل مرشح الإعلان. يقدّم البائع سمة decisionLogicUrl في مَعلمة إعدادات المزاد التي تم تمريرها. إلى navigator.runAdAuction(). يجب أن يتضمّن الرمز في عنوان URL هذا الدالة scoreAd()، وهي لكل مقدِّم عرض سعر في المزاد، لتسجيل كل عرض من عروض الأسعار التي تم عرضها من خلال generateBid().

ملاحظة: إنّ السمة biddingWasmHelperUrl اختيارية، ولكنّها تتيح لمقدّم عرض السعر تقديم. برامج فرعية مكلفة من الناحية الحاسوبية في WebAssembly بدلاً من JavaScript، أن تكون صادرة من دالة JavaScript التي يوفّرها biddingLogicUrl في حال حذف عند تقديمه، يجب أن يشير إلى برنامج ثنائي WebAssembly، يتم إرساله باستخدام application/wasm mimetype. تشير رسالة الأشكال البيانية WebAssembly.Module المقابل يوفره المتصفح للدالة generateBid().

يجب أن يشتمل النص البرمجي على biddingLogicUrl الذي يقدمه مشترٍ في مساحة إعلانية على دالة generateBid(). يتم استدعاء هذه الدالة مرة واحدة لكل إعلان مرشّح. runAdAuction() مراجعة كل إعلان بشكل فردي، إضافةً إلى عرض السعر والبيانات الوصفية المرتبطة به، ثم تعيين درجة الرغبة العددية.

generateBid(interestGroup, auctionSignals, perBuyerSignals,
    trustedBiddingSignals, browserSignals) {
  ...
  return {
    ad: adObject,
    bid: bidValue,
    render: renderUrl,
    adComponents: [adComponentRenderUrl1, ...]
   };
}

تستخدم generateBid() الوسيطات التالية:

interestGroup تمرير العنصر إلى joinAdInterestGroup() من قِبل مشتري الإعلان. (المجموعة ذات الاهتمامات المشتركة ويمكن تعديلها عبر dailyUpdateUrl.)
auctionSignals سمة لوسيطة ضبط المزاد تم تمريرها إلى navigator.runAdAuction() من قِبل بائع في المساحة الإعلانية ويوفر هذا معلومات حول سياق الصفحة (مثل حجم الإعلان والرقم التعريفي للناشر) ونوع المزاد (السعر الأول أو السعر الثاني) بيانات التعريف.
perBuyerSignals كما هي الحال مع auctionSignals، سمة إعدادات المزاد تمرير الوسيطة إلى navigator.runAdAuction() من قِبل البائع. يمكن أن يوفر ذلك معلومات إشارات من خادم المشتري عن الصفحة، إذا كان البائع من SSP طلب عرض الأسعار في الوقت الفعلي لخوادم المشترين وتمرير الرد، أو إذا كان الناشر تتصل الصفحة بخادم المشتري مباشرةً. إذا كان الأمر كذلك، فقد يرغب المشتري في التحقق من التشفير توقيع هذه الإشارات داخل generateBid() كحماية من التلاعب.
trustedBiddingSignals يشير هذا المصطلح إلى كائن تكون مفاتيحه هي trustedBiddingSignalsKeys الخاص بـ ذات الاهتمامات المشتركة، ويتم عرض قيمها في طلب trustedBiddingSignals.
browserSignals يشير هذا المصطلح إلى كائن تم إنشاؤه من خلال المتصفِّح وقد يحتوي على معلومات عن صفحة. والسياق (مثل hostname من الصفحة الحالية، التي يمكن للبائع تزييفها) والبيانات عن مجموعة الاهتمامات المعنيّة نفسها (مثل سجلّ الوقت الذي فازت فيه المجموعة سابقًا في المزاد، وذلك للسماح تحديد عدد مرات الظهور على الجهاز فقط).

يحتوي الكائن browserSignals على السمات التالية:

{
  topWindowHostname: 'publisher.example',
  seller: 'https://ssp.example',
  joinCount: 3,
  bidCount: 17,
  prevWins: [[time1,ad1],[time2,ad2],...],
  wasmHelper: ... /* WebAssembly.Module object based on interest group's biddingWasmHelperUrl. */
  dataVersion: 1, /* Data-Version value from the buyer's Key/Value service response(s). */
}

لاحتساب قيمة bid، يمكن للرمز في generateBid() استخدام خصائص دالة المعلَمات. على سبيل المثال:

function generateBid(interestGroup, auctionSignals, perBuyerSignals,
    trustedBiddingSignals, browserSignals) {
  return {
    ...
    bid: auctionSignals.is_above_the_fold ? perBuyerSignals.atf_value : perBuyerSignals.btf_value,
    ...
  }
}

تُرجع generateBid() كائنًا بأربع خصائص:

ad بيانات وصفية عشوائية عن الإعلان، مثل المعلومات التي يتوقع البائع الاطّلاع عليها بشأن عرض السعر هذا أو تصميم الإعلان. ويستخدم البائع](/privacy-sandbox/resources/مسرد#ssp) هذه المعلومات في مزاده وقراره. تصميم الإعلان. يستخدم البائع هذه المعلومات في مزاده وقراره. المنطق.
bid عرض سعر رقمي يمكن أن يدخل في المزاد. يجب أن يكون البائع في موضع لإجراء المقارنة عروض الأسعار من مشترين مختلفين، وبالتالي يجب أن تكون عروض الأسعار في وحدة معينة يختارها البائع (على سبيل المثال "دولار أمريكي لكل 100"). إذا كان عرض السعر صفرًا أو سالبًا، فلن تشارك مجموعة الاهتمامات هذه في مزاد البائع على الإطلاق. وباستخدام هذه الآلية، يمكن للمشتري تنفيذ أي قواعد للمعلنين بشأن الحالات التي قد تظهر أو لا تظهر إعلاناتهم.
render عنوان URL أو قائمة عناوين URL التي سيتم استخدامها لعرض تصميم الإعلان في حال فوز عرض الأسعار هذا بالمزاد. (اطّلع على الإعلانات المؤلفة من أجزاء متعددة) في شرح واجهة برمجة التطبيقات). يجب أن تتطابق القيمة مع renderUrl لإحدى الإعلانات المحددة لمجموعة الاهتمامات.
adComponents قائمة اختيارية تضم ما يصل إلى 20 مكونًا إعلانات تتألف من عدة أجزاء مأخوذ من السمة adComponents في وسيطة مجموعة الاهتمامات. تم تمريره إلى navigator.joinAdInterestGroup().

مطالبة المتصفّح بمغادرة مجموعة ذات اهتمام

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

navigator.leaveAdInterestGroup({
  owner: 'https://dsp.example',
  name: 'custom-bikes'
});

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

3- يزور المستخدم موقعًا إلكترونيًا يبيع مساحة إعلانية.

صورة توضيحية تعرض شخصًا يزور موقعًا إلكترونيًا إخباريًا من خلال متصفح على كمبيوتر محمول الموقع الإلكتروني
تحتوي على شريحة إعلانية فارغة.

وفي وقت لاحق، يزور المستخدم موقعًا إلكترونيًا يبيع مساحة إعلانية، وهو في هذا المثال موقع إلكتروني إخباري. يحتوي الموقع على المساحة المتوفّرة للإعلانات التي تبيعها آليًّا باستخدام عروض الأسعار في الوقت الفعلي:

ملاحظة: هناك ثلاثة أدوار رئيسية موضّحة في شرح اقتراح "الجمهور المحمي": * المعلِن: موقع إلكتروني يدفع رسومًا مقابل الإعلان عن منتجاته. في المثال هنا، دراجة مخصصة صانع المحتوى. * الناشر: المواقع الإلكترونية التي تبيع مساحات إعلانية، مثل موقع الأخبار على الإنترنت المشار إليه في الأمثلة هنا. فالعديد من المواقع الإلكترونية (وليس كلها) التي تبيع مساحات إعلانية هي مواقع ناشري محتوى. * البائع: الجهة التي تُجري مزاد الإعلانات (في الخطوة التالية). يستخدم معظم الناشرين تكنولوجيا الإعلان خدمة مثل SSP لتحسين المساحة المتوفّرة للإعلانات لبيعها.

4. يتم إجراء مزاد إعلانات في المتصفح

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

قسم الشرح: البائعون إجراء مزادات على الأجهزة

من المحتمل أن يدير مزاد الإعلانات SSP لدى الناشر. الناشر نفسه. الغرض من المزاد هو اختيار أكثر الإعلانات ملاءمة الشريحة الإعلانية المتوفرة في الصفحة الحالية ويأخذ المزاد في الاعتبار مجموعات الاهتمامات أحد المستخدمين في خدمات المفاتيح/القيمة، إلى جانب بيانات مستمَدة من مشتري المساحات الإعلانية والبائعين.

يطلب بائع المساحة الإعلانية من متصفّح المستخدم بدء مزاد إعلانات من خلال طلب navigator.runAdAuction()

على سبيل المثال:

const auctionConfig = {
  seller: 'https://ssp.example',
  decisionLogicUrl: ...,
  trustedScoringSignalsUrl: ...,
  interestGroupBuyers: ['https://dsp.example', 'https://buyer2.example', ...],
  auctionSignals: {...},
  sellerSignals: {...},
  sellerTimeout: 100,
  perBuyerSignals: {
    'https://dsp.example': {...},
    'https://another-buyer.example': {...},
    ...
  },
  perBuyerTimeouts: {
    'https://dsp.example': 50,
    'https://another-buyer.example': 200,
    '*': 150,
    ...
  },
  componentAuctions: [
    {
      'seller': 'https://some-other-ssp.example',
      'decisionLogicUrl': ...,
      ...
    },
    ...
  ]
};

const auctionResultPromise = navigator.runAdAuction(auctionConfig);

تعرض الدالة runAdAuction() تعهدًا يتم حله إلى URN (urn:uuid:<something>) الذي يمثّل نتائج مزاد الإعلانات. ولا يمكن للمتصفّح فك ترميز ذلك إلا عند تمريره إلى إطار محاط بسياج للعرض: لا يمكن لصفحة الناشر فحص الإعلان الفائز.

ملاحظة: كما أوضحنا سابقًا، فإن أصل سياق الطلب يجب أن تتطابق joinAdInterestGroup() مع حساب مالك مجموعة الاهتمامات. الأصل، لذلك يجب استدعاء joinAdInterestGroup() من إطار iframe (على سبيل المثال، من وسيط عرض الطلب) ما لم يتطابق أصل مالك مجموعة الاهتمامات مع أصل الصفحة (على سبيل المثال، موقع إلكتروني يضم مجموعات اهتمامات خاصة). لا يستوفي runAdAuction المتطلبات نفسها، لذا يُرجى الاتصال بـ runAdAuction() من <script> من المحتمل أن تكون العلامة التجارية أفضل بكثير من إطار iframe من مصادر متعددة.

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

`auctionConfig` مكانًا للإقامة

الموقع	مطلوب	مثال	الدور
`seller`	مطلوب	`'https://ssp.example'`	أصل البائع.
`decisionLogicUrl`	مطلوب	`'https://ssp.example/auction-decision-logic.js'`	عنوان URL لـ JavaScript Worklet الخاص بالمزاد.
`trustedScoringSignalsUrl`	اختياري	`'https://ssp.example/scoring-signals'`	عنوان URL لخادم البائع الموثوق به.
`interestGroupBuyers*`	مطلوب	`['https://dsp.example', 'https://buyer2.example', ...]`	طلبت مصادر جميع مالكي مجموعات الاهتمامات تقديم عروض أسعار في المزاد.
`auctionSignals`	اختياري	`{...}`	معلومات البائع حول سياق الصفحة، ونوع المزاد، وما إلى ذلك
`sellerSignals`	اختياري	`{...}`	المعلومات المستندة إلى إعدادات الناشر وتقديم طلب الإعلان المستند إلى السياق وما إلى ذلك
`sellerTimeout`	اختياري	`100`	الحد الأقصى لوقت تشغيل النص البرمجي `scoreAd()` الخاص بالبائع
`perBuyerSignals`	اختياري	`{'https://dsp.example': {...}, 'https://another-buyer.example': {...}, ...}`	إشارات سياقية من خادمه عن صفحة كل مشترٍ محدّد
`perBuyerTimeouts`	اختياري	`50`	الحد الأقصى لوقت التشغيل (بالمللي ثانية) للنصوص البرمجية التي يبلغ عددها `generateBid()` للمشتري المُعين.
`componentAuctions`	اختياري	`[{'seller': 'https://www.some-other-ssp.com', 'decisionLogicUrl': ..., ...}, ...]`	عمليات ضبط إضافية لمزادات المكوّنات

* يجوز للبائع تحديد interestGroupBuyers: '*' للسماح لجميع مجموعات المصالح بتقديم عروض أسعار. وبعد ذلك، يتم قبول الإعلانات أو رفضها استنادًا إلى معايير أخرى غير إدراج مالك مجموعة الاهتمامات. على سبيل المثال، يجوز للبائع مراجعة تصاميم الإعلانات للتأكّد من التزامها بسياساته.

** لا تتوفّر ميزة additionalBids في التنفيذ الحالي لميزة Protected Audience. قراءة المزاد "المشاركون" في شرح عن ميزة "الجمهور المحمي" للحصول على مزيد من المعلومات

كيف يتم اختيار الإعلانات؟

الرمز في decisionLogicUrl (وهي خاصية لكائن مزاد الإعلانات التي يتم تمريرها إلى runAdAuction()) يجب أن يتضمن الدالة scoreAd(). يتم تنفيذ هذه الخطوة مرة واحدة لكل إعلان لتحديد مدى مرغوب فيه.

scoreAd(adMetadata, bid, auctionConfig, trustedScoringSignals, browserSignals) {
  ...
  return desirabilityScoreForThisAd;
}

تستخدم scoreAd() الوسيطات التالية:

adMetadata البيانات الوصفية العشوائية التي يقدّمها المشتري
bid قيمة عرض سعر رقمية.
auctionConfig تم تمرير كائن إعدادات المزاد إلى navigator.runAdAuction().
trustedScoringSignals القيم التي يتم استردادها في وقت المزاد من الخادم الموثوق به للبائع التي تمثّل رأي البائع في الإعلان
browserSignals يشير هذا المصطلح إلى كائن تم إنشاؤه من خلال المتصفّح، بما في ذلك المعلومات التي أنشأها المتصفح. على نص المزاد الخاص بالبائع والذي قد يرغب البائع في التحقق منه:

{
  topWindowHostname: 'publisher.example',
  interestGroupOwner: 'https://dsp.example',
  renderUrl: 'https://cdn.example/render',
  adComponents: ['https://cdn.com/ad-component-1', ...],
  biddingDurationMsec: 12,
  dataVersion: 1 /* Data-Version value from the seller's Key/Value service response. */
}

وقبل بدء المزاد، يجد البائع أفضل إعلان سياقي للخانة الإعلانية المتاحة. جزء من منطق scoreAd() هو رفض أي إعلان لا يتفوق على الفائز من حيث المحتوى.

5- يتلقى البائع والمشترين المشاركون بيانات في الوقت الفعلي من خدمة المفتاح/القيمة

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

قسم الشرح: جلب البيانات في الوقت الفعلي من خدمة "مفتاح/قيمة الجمهور المحمي".

خلال مزاد الإعلانات، يمكن لبائع المساحة الإعلانية الحصول على بيانات في الوقت الفعلي عن تصميمات إعلانات محدّدة عن طريق تقديم طلب إلى خدمة المفتاح/القيمة باستخدام خاصية trustedScoringSignalsUrl تم تمرير وسيطة إعدادات المزاد إلى navigator.runAdAuction() إلى جانب المفاتيح من خصائص renderUrl لجميع الإدخالات في الحقل ads وadComponents من جميع الإدخالات المجموعات ذات الاهتمامات المشتركة في المزاد.

وبالمثل، يمكن لمشتري المساحة الإعلانية طلب بيانات في الوقت الفعلي من خدمة المفتاح/القيمة باستخدام السمتان trustedBiddingSignalsUrl وtrustedBiddingSignalsKeys لوسيطة مجموعة الاهتمامات تمريره إلى navigator.joinAdInterestGroup().

عند استدعاء الدالة runAdAuction()، يرسل المتصفّح طلبًا إلى الخادم الموثوق به لكل مشترٍ للإعلانات. تشير رسالة الأشكال البيانية قد يظهر عنوان URL للطلب على النحو التالي:

https://kv-service.example/getvalues?hostname=publisher.example&keys=key1,key2

مصدر عنوان URL الأساسي هو trustedBiddingSignalsUrl.
يوفّر المتصفّح hostname.
قيمة keys مأخوذة من trustedBiddingSignalsKeys.

والاستجابة لهذا الطلب هي كائن JSON يوفر قيمًا لكل مفتاح من المفاتيح.

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

6- يتم عرض الإعلان الفائز

صورة توضيحية تعرض شخصًا يشاهد موقعًا إلكترونيًا إخباريًا في متصفح على كمبيوتر محمول إعلان
للدراجة (خصم 20%) - مع وجود قفل أعلاه للإشارة إلى أن الإعلان معروض في
محددة.

قسم الشرح: عرض المتصفحات للإعلان الفائز

كما هو موضّح سابقًا: يتم تعديل الوعد الذي تم إرجاعه من خلال runAdAuction() إلى URN. والذي يتم تمريره إلى إطار محاط بحدود للعرض، ويعرض الموقع الإعلان الفائز.

7. يتم الإبلاغ عن نتيجة المزاد

قسم الشرح: إعداد التقارير على مستوى الحدث (حتى الآن)

ملاحظة: تتمثل الخطة طويلة الأجل في تفعيل المتصفّح من تسجيل نتائج المزاد للبائعين والمشترين. باستخدام واجهات برمجة تطبيقات التقارير المجمَّعة كآلية إبلاغ مؤقتة على مستوى الحدث، الرمز الذي ينفذ reportResult() والبائع "reportWin()" لمقدِّم عرض السعر الفائز، يمكنه استدعاء الدالة sendReportTo(). يستغرق ذلك وسيطة واحدة: سلسلة تمثّل عنوان URL يتم جلبه بعد اكتمال المزاد، لترميز المعلومات على مستوى الحدث المطلوب الإبلاغ عنها.

نتيجة تقارير البائع

قسم الشرح: إعداد تقارير البائعين عن العرض

يمكن لرمز JavaScript الخاص بالبائع والمتوفّر على decisionLogicUrl (والذي يوفّر أيضًا scoreAd()) تضمين الدالة reportResult()، للإبلاغ عن نتائج المزاد.

reportResult(auctionConfig, browserSignals) {
  ...
  return signalsForWinner;
}

الوسيطات التي تم تمريرها إلى هذه الدالة هي:

auctionConfig تم تمرير كائن إعدادات المزاد إلى navigator.runAdAuction().

browserSignals
كائن تم إنشاؤه من خلال المتصفّح يقدّم معلومات عن المزاد على سبيل المثال:

{
  'topWindowHostname': 'publisher.example',
  'interestGroupOwner': 'https://dsp.example',
  'renderUrl': 'https://cdn.example/url-of-winning-creative.wbn',
  'bid:' <bidValue>,
  'desirability': <winningAdScore>
}

تُستخدم القيمة المعروضة لهذه الدالة كوسيطة sellerSignals لعرض السعر الفائز reportWin().

نتيجة تقارير مقدِّم عرض السعر الفائز

قسم الشرح: إعداد تقارير المشترين حول العرض وأحداث الإعلانات

يمكن أن يتضمن رمز JavaScript الخاص بمقدِّم عرض السعر الفائز (والذي يوفّر generateBid() أيضًا) reportWin() للإبلاغ عن نتائج المزاد.

reportWin(auctionSignals, perBuyerSignals, sellerSignals, browserSignals) {
  ...
}

ملاحظة: سيصدر تحذير بشأن التنفيذ الحالي لـ Protected Audience في Chrome في حال عدم تحديد reportWin().

الوسيطات التي تم تمريرها إلى هذه الدالة هي:

auctionSignals وperBuyerSignals
تم تمرير القيم نفسها إلى generateBid() لمقدِّم عرض السعر الفائز.
sellerSignals القيمة المعروضة reportResult()، ما تمنح البائع فرصة لتمرير المعلومات إلى المشتري.

browserSignals كائن تم إنشاؤه من خلال المتصفّح يقدّم معلومات عن المزاد على سبيل المثال:

{
  'topWindowHostname': 'publisher.example',
  'seller': 'https://ssp.example',
  'interestGroupOwner': 'https://dsp.example',
  'interestGroupName': 'custom-bikes',
  'renderUrl': 'https://cdn.example/winning-creative.wbn',
  'bid:' <bidValue>
}

تنفيذ تقرير الخسارة/الفوز المؤقت

هناك طريقتان متاحتان مؤقتًا في Chrome لإعداد تقارير المزاد:

forDebuggingOnly.reportAdAuctionLoss()
forDebuggingOnly.reportAdAuctionWin()

تستخدم كل من هذه الطرق وسيطة واحدة: عنوان URL المطلوب جلبه بعد اكتمال المزاد. يمكنه سيتم استدعاؤها عدة مرات، في كل من scoreAd() وgenerateBid()، باستخدام وسيطات عنوان URL مختلفة.

لا يرسل Chrome تقارير تصحيح الأخطاء/الفوز/تصحيح الأخطاء إلا عند انتهاء المزاد حتى اكتماله. إذا كان المزاد لن يتم إنشاء أي تقارير (بسبب عملية تنقُّل جديدة مثلاً).

تتوفّر هذه الطرق تلقائيًا في Chrome. لتتمكّن من اختبار الطرق، فعِّل جميع واجهات برمجة تطبيقات Ad Privacy API ضمن "chrome://settings/adPrivacy". إذا كنت تستخدم Chrome مع علامات سطر الأوامر لتفعيل Protected Audience، عليك ما يلي: لتفعيل الطرق بشكل صريح من خلال تضمين علامة BiddingAndScoringDebugReportingAPI. إذا كانت إذا لم يتم تفعيل العلامة، ستظل الطرق متاحة ولكن لا تفعل أي شيء.

8. الإبلاغ عن نقرة على إعلان

صورة توضيحية تعرض
شخص ينقر على إعلان لدراجة داخل إطار محاط بسور، على موقع إلكتروني إخباري مع تقرير
بيانات إلى البائع والمشترين.

يتم الإبلاغ عن نقرة على إعلان معروض في إطار محاط بسياج. لمعرفة المزيد حول كيفية عمل ذلك، راجِع إعداد تقارير إعلانات الإطارات سيئة.

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

صورة توضيحية تعرض نظرة عامة على كل مرحلة من مراحل مزاد الإعلانات باستخدام ميزة "الجمهور المحمي"

ما الفرق بين Protected Audience وTURTLEDOVE؟

Protected Audience هي أول تجربة يتم تنفيذها في Chromium ضمن مجموعة اقتراحات TURTLEDOVE.

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

تهدف TURTLEDOVE إلى توفير واجهة برمجة تطبيقات جديدة لمعالجة حالة الاستخدام هذه مع توفير بعض التطورات الرئيسية في مجال الخصوصية:

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

نشأ Protected Audience من TURTLEDOVE ومجموعة من الاقتراحات ذات الصلة بإجراء التعديلات بهدف تقديم خدمة أفضل للمطوّرين الذين قد يستخدمون واجهة برمجة التطبيقات:

في SPARROW: اقترح Criteo إضافة ("Gatekeeper") يعمل في بيئة تنفيذ موثوقة (TEE). وتشمل Protected Audience استخدامًا محدودًا على البيئة التنفيذية (TEE) من أجل البحث عن البيانات في الوقت الفعلي وإعداد التقارير المجمَّعة.
TERN وMignite من NextRoll ببغاء الأدوار المختلفة التي كان يلعبها المشترين والبائعين في المزاد على الجهاز فقط. ويستند مسار عروض أسعار الإعلانات أو النتائج في Protected Audience إلى هذا العمل.
القائمة على النتائج وبيان RTB House مستوى المنتج TURTLEDOVE من خلال التعديلات، حسّن نموذج إخفاء الهوية وإمكانات التخصيص في المزاد على الجهاز فقط.
PARAKEET هي اقتراح Microsoft لتقديم خدمة إعلانية تشبه TURTLEDOVE تعتمد على خادم وكيل يعمل في بيئة التنفيذ الموثوقة (TEE) بين المتصفّح ومزوّدي تقنية الإعلان، لإخفاء هوية طلبات الإعلانات وفرض الخصوصية المواقع. لم تستخدم ميزة Protected Audience نموذج الوكيل هذا. نحن بصدد توفير واجهات برمجة تطبيقات JavaScript تكامل PARAKEET مع Protected Audience من أجل دعم الجهود المستقبلية ميزات كلا العرضين.

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

ما هي إعدادات المتصفِّح المتاحة؟

يمكن للمستخدمين تعديل إعدادات المشاركة في الفترات التجريبية من "مبادرة حماية الخصوصية" في Chrome من خلال تفعيل هذه الميزة أو إيقافها. الإعدادات ذات المستوى الأعلى في chrome://settings/adPrivacy. أثناء الاختبار الأولي، سيكون الأشخاص سنتمكّن من استخدام إعدادات "مبادرة حماية الخصوصية" العالية المستوى لإيقاف ميزة Protected Audience على يخطط Chrome للسماح عرض وإدارة قائمة المجموعات ذات الاهتمامات المشتركة التي أُضيفت إليها على الويب المواقع التي زاروها. كما هو الحال مع تقنيات "مبادرة حماية الخصوصية" ذاتها، قد تتيح إعدادات المستخدم وتطويرها استنادًا إلى الملاحظات الواردة من المستخدمين والهيئات التنظيمية وغير ذلك

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

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

التفاعل مع الملاحظات ومشاركتها

GitHub: اطّلِع على الاقتراح طرح الأسئلة ومتابعة المناقشة
W3C: مناقشة حالات الاستخدام على مستوى المجال في مقالة تحسين النشاط الإعلاني على الويب المجموعة:
فريق دعم المطوّرين: يمكنك طرح الأسئلة والانضمام إلى المناقشات على مستودع دعم المطوّرين ضمن "مبادرة حماية الخصوصية"
القائمة البريدية لـ FLEDGE: fledge-api-announce إشعارات وتحديثات حول واجهة برمجة التطبيقات
الانضمام إلى المكالمات المُجدوَلة لخدمة Protected Audience الأسبوع الثاني). يُسمح للجميع بالانضمام. للمشاركة، يجب التأكّد أولاً من الانضمام إلى WICG. يمكنك المشاركة بنشاط أو الاستماع فقط.
استخدام نموذج الملاحظات والآراء حول "مبادرة حماية الخصوصية" لمشاركة الملاحظات بشكل خاص مع فريق Chrome خارج المنتديات العامة.

الحصول على الدعم

لطرح سؤال حول عملية التنفيذ أو العرض التوضيحي أو المستندات:

فتح مشكلة جديدة في مستودع دعم Privacy-Sandbox-dev. تأكَّد من اختيار نموذج المشكلة لميزة Protected Audience.
يمكنك طرح مشكلة في مستودع الرموز التجريبية على GitHub.
لمزيد من الأسئلة العامة حول كيفية تلبية حالات الاستخدام لواجهة برمجة التطبيقات، الإبلاغ عن مشكلة في مستودع الاقتراح

بالنسبة إلى الأخطاء والمشاكل المرتبطة بتنفيذ Protected Audience API في Chrome: * الاطّلاع على المشاكل الحالية عن واجهة برمجة التطبيقات. * يمكنك طرح مشكلة جديدة على الرابط crbug.com/new.

البقاء على اطّلاع

لتلقّي إشعارات بتغييرات الحالة في واجهة برمجة التطبيقات، يمكنك الانضمام إلى القائمة البريدية .
لمتابعة كل المناقشات الجارية حول واجهة برمجة التطبيقات عن كثب، انقر على الزر مشاهدة في صفحة الاقتراح على GitHub. يتطلب ذلك أن يكون لديك أو إنشاء موقع GitHub الحساب.
للحصول على آخر الأخبار حول "مبادرة حماية الخصوصية"، يُرجى الاشتراك في خلاصة RSS [مستوى التقدّم في صفحة "الخصوصية" Sandbox].

التعرف على المزيد

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

صورة من إعداد راي هينيسي على قناة Unقلاش.