دليل المطوِّر لمزادات الإعلانات على الجهاز فقط لعرض تجديد النشاط التسويقي وشرائح الجمهور المخصّصة بدون تتبُّع الجهات الخارجية على مواقع إلكترونية متعددة
بالنسبة إلى المستخدمين الجدد في Protected Audience API، يُرجى الاطّلاع على نظرة عامة على Protected Audience API للحصول على شرح عام لواجهة برمجة التطبيقات.
تمّت كتابة هذه المشاركة للمطوّرين كمرجع فني لأحدث تكرار من Protected Audience API التجريبية. يتوفّر عرض توضيحي حول النشر الأساسي لواجهة Protected Audience API، بالإضافة إلى مراجع واجهات برمجة التطبيقات لمشتري الإعلانات والبائعين.
حالة التنفيذ
- يتمّ الآن نقل اقتراح Protected Audience API إلى مدى التوفّر للجمهور العام. طرح الأسئلة ومتابعة المناقشة:
- توضّح حالة Protected Audience API للإمكانات في انتظار المراجعة التغييرات والتحسينات التي طرأت على Protected Audience API وميزاتها.
- حالة وميض
- حالة نظام Chrome الأساسي في Protected Audience API: تنطبق على Protected Audience API على Chrome.
- حالة منصّة Chrome لـ Ads API: مجموعة من واجهات برمجة التطبيقات لتسهيل عرض الإعلانات: Protected Audience API وTopics وFenced Frames (الإطارات المسوّرة) وتقارير تحديد المصدر.
لتلقّي إشعارات بشأن تغييرات الحالة في واجهة برمجة التطبيقات، يمكنك الانضمام إلى القائمة البريدية لمطوّري البرامج.
ما هي Protected Audience API؟
Protected Audience API هي واجهة برمجة تطبيقات من مبادرة حماية الخصوصية مصمَّمة لعرض حالات استخدام تجديد النشاط التسويقي والجمهور المخصّص، وهي مصمَّمة بحيث لا يمكن للجهات الخارجية استخدامها لتتبُّع سلوك المستخدمين في التصفّح على المواقع الإلكترونية. تتيح واجهة برمجة التطبيقات إجراء المزادات على الجهاز فقط بواسطة المتصفح لاختيار الإعلانات الملائمة للمواقع الإلكترونية التي زارها المستخدم من قبل.
إنّ Protected Audience API هي أول تجربة يتم تنفيذها في Chromium ضمن مجموعة الاقتراحات TURTLEDOVE.
تجربة Protected Audience API
مرجع واجهة برمجة التطبيقات المتاح
يمثّل هذا المستند نظرة عامة على Protected Audience API. إذا كنت تبحث عن طرق ومَعلمات محدَّدة لواجهة برمجة التطبيقات:
- دليل "المشترين" في
joinAdInterestGroup()وgenerateBid(). - دليل البائع حول Protected Audience API
runAdAuction() - دليل المشترين إلى
reportWin()ودليل البائعين إلىreportResult() - تحديد المشاكل في Protected Audience API وحلّها
يمكنك أيضًا الاطّلاع على أفضل الممارسات المتعلّقة بوقت الاستجابة في مزاد الإعلانات في Protected Audience API.
عرض توضيحي لميزة Protected Audience API
تتوفّر جولة تفصيلية حول عملية النشر الأساسية لواجهة Protected Audience API على المواقع الإلكترونية للمعلِنين والناشرين على الموقع الإلكتروني specific-audience-demo.web.app/.
اختبار واجهة برمجة التطبيقات هذه
يمكنك اختبار Protected Audience API على مستخدم واحد في الإصدار التجريبي 101.0.4951.26 من Chrome والإصدارات الأحدث على الكمبيوتر المكتبي:
- تفعيل جميع واجهات برمجة تطبيقات الخصوصية في عرض الإعلانات ضمن "
chrome://settings/adPrivacy" - ضبط العلامات من سطر الأوامر يمكن العثور على القائمة الكاملة لعلامات Protected Audience API المتاحة في البحث في الرموز البرمجية في Chromium.
عرض الإعلانات في إطارات iframe أو إطارات محاطة بحدود
يمكن عرض الإعلانات في <iframe> أو <fencedframe>، بناءً على العلامات التي يتم إعدادها.
لاستخدام <fencedframe> لعرض الإعلانات:
--enable-features=InterestGroupStorage,AdInterestGroupAPI,Fledge,FencedFrames
لاستخدام <iframe> لعرض الإعلانات:
--enable-features=InterestGroupStorage,AdInterestGroupAPI,Fledge,AllowURNsInIframes --disable-features=FencedFrames
ضمِّن العلامة BiddingAndScoringDebugReportingAPI لتفعيل
طرق الإبلاغ عن فقدان الأخطاء مؤقتًا أو تقارير الفوز من أجل تصحيح الأخطاء.
الميزات المتاحة
إنّ Protected Audience API ضمن علامات الميزات في Chromium هي تجربة أولى لاختبار الميزات التالية في Protected Audience API:
- مجموعات الاهتمامات: يخزّنها المتصفّح، مع بيانات وصفية مرتبطة به لضبط عروض أسعار الإعلانات وعرضها.
- عروض الأسعار على الجهاز فقط حسب المشترين (DSP أو المعلن): استنادًا إلى مجموعات الاهتمامات المحفوظة والإشارات من البائع.
- اختيار البائع للإعلانات على الجهاز فقط (SSP أو الناشر): استنادًا إلى عروض أسعار المزادات والبيانات الوصفية من المشترين.
- عرض الإعلانات في إصدار مرن مؤقتًا من ميزة Fenced Frames: مع السماح بالوصول إلى الشبكة وتسجيل الدخول لعرض الإعلانات
يمكنك الاطّلاع على مزيد من المعلومات عن إتاحة الميزات والقيود المفروضة عليها في الفيديو التوضيحي حول Protected Audience API.
أذونات المجموعات ذات الاهتمامات المشتركة
الإعداد التلقائي للتنفيذ الحالي لواجهة Protected Audience API هو السماح بطلب البيانات من
joinAdInterestGroup()
من أي مكان في الصفحة، حتى من إطارات iframe على مستوى عدة نطاقات.
في المستقبل، عندما يتمكّن مالكو المواقع الإلكترونية من تعديل سياسات أذونات إطارات iframe على مستوى عدة نطاقات، ستكون الخطة هي منع الطلبات الواردة من إطارات iframe عبر النطاقات.
خدمة المفتاح/القيمة
لإتاحة مزاد الإعلانات في Protected Audience API، يمكن للمتصفّح الوصول إلى خدمة مفتاح/قيمة لاسترداد المعلومات في الوقت الفعلي التي تتوافق مع مزاد الإعلانات في Protected Audience API. يمكن استخدام هذه المعلومات بعدة طرق:
- قد يرغب المشترون في حساب الميزانية المتبقية في إحدى الحملات الإعلانية.
- قد يُطلب من البائعين التحقّق من تصاميم الإعلانات للتأكّد من توافقها مع سياسات الناشر.
أصبح مفتاح/رمز خدمة القيمة/مفتاح واجهة برمجة التطبيقات Protected Audience API متوفّرًا الآن. يمكنك الاطّلاع على مشاركة المدونة التي تتضمّن الإعلان لمعرفة آخر المعلومات عن الحالة.
للاختبار الأولي، تم طرح نموذج "إحضار الخادم الخاص بك". وعلى المدى الطويل، ستحتاج تكنولوجيات الإعلان إلى استخدام خدمات المفاتيح/القيمة المفتوحة المصدر في Protected Audience API ضمن بيئات تنفيذ موثوقة.
راجِع مشاركة المدونة الخاصة بخدمات Protected Audience API للاطّلاع على تعديلات المخطط الزمني. وسنقدم إشعارًا مهمًا للمطورين لبدء الاختبار والاعتماد قبل إجراء هذا الانتقال.
الكشف عن دعم الميزات
قبل استخدام واجهة برمجة التطبيقات، تحقّق مما إذا كانت متوافقة مع المتصفّح ومتوفّرة في المستند:
'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 API؟
في هذا المثال، يتصفح أحد المستخدمين موقع الويب لصانع دراجات مخصص، ثم يزور لاحقًا موقعًا إخباريًا ويظهر له إعلان عن دراجة جديدة من صانع الدراجات.
ستتمّ إضافة ميزات Protected Audience API بمرور الوقت مع تقدّم عملية التنفيذ.
1- يزور أحد المستخدمين موقعًا إلكترونيًا للمعلن
تخيل أن مستخدمًا يزور موقع الويب لصانع دراجات مخصص (المعلن) في هذا المثال) ويقضي بعض الوقت في صفحة المنتج لدراجة فولاذية مصنوعة يدويًا. يوفر ذلك لصانع الدراجات فرصة تجديد النشاط التسويقي.
2. سيُطلَب من متصفّح المستخدم إضافة مجموعة اهتمامات.
يطلب وسيط عرض الطلب (DSP) لدى المعلِن (أو المعلن نفسه)
navigator.joinAdInterestGroup() ليطلب من المتصفّح إضافة مجموعة اهتمامات
إلى قائمة المجموعات التي ينتمي إليها المتصفّح.
في هذا المثال، تُسمى المجموعة custom-bikes، والمالك هو dsp.example. سيكون مالك مجموعة الاهتمامات (في هذه الحالة، وسيط عرض الطلب) مشتريًا في مزاد الإعلانات في Protected Audience API. ويتم تخزين عضوية مجموعة الاهتمامات من خلال المتصفّح
وعلى جهاز المستخدم، ولا تتم مشاركتها مع مورّد المتصفّح أو أي شخص آخر.
- الاطّلاع على شرح حول Protected Audience API: مجموعات الاهتمامات في سجلّات المتصفّحات
- اقرأ دليل واجهة برمجة التطبيقات: المشترون ومقدّمو الخدمات الرقمية (DSP)، وتعرّف على كيفية
joinAdInterestGroup()وإنشاء عروض الأسعار.
تحديد إعلانات لمجموعة اهتمامات
يتضمن العنصران ads وadComponents عنوان URL لتصميم إعلان،
بالإضافة إلى بيانات وصفية عشوائية يمكن استخدامها في وقت عروض الأسعار اختياريًا. مثلاً:
{
renderUrl: 'https://cdn.example/.../bikeAd1.html',
metadata: bikeAd1metadata // optional
}
كيف يقدّم المشترون عروض الأسعار؟
يتم طلب generateBid() لكل مجموعة اهتمامات يكون المتصفّح عضوًا فيها،
في حال دعوة مالك مجموعة الاهتمامات لتقديم عروض أسعار.
يمكنك الاطّلاع على مستندات مطوّري برامج "generatedBid()".
3- يزور المستخدم موقعًا إلكترونيًا يبيع مساحة إعلانية.
بعد ذلك، يزور المستخدم موقعًا إلكترونيًا يبيع مساحة إعلانية، وهو موقع إلكتروني إخباري في هذا المثال. يحتوي الموقع على مستودع إعلانات، يتم بيعه آليًا باستخدام عروض الأسعار في الوقت الفعلي.
4. يتم إجراء مزاد إعلانات في المتصفح
من المحتمل أن يتم تشغيل مزاد الإعلانات من قِبل مزوّد جهة العرض للناشر أو الناشر نفسه. الغرض من المزاد هو اختيار الإعلان الأكثر ملاءمة لشريحة إعلانية متاحة في الصفحة الحالية. ويراعي المزاد مجموعات الاهتمامات التي ينتمي إليها المتصفّح، بالإضافة إلى البيانات الواردة من مشتري المساحات الإعلانية والبائعين من خدمات المفاتيح/القيمة.
- قراءة الشرح التوضيحي لواجهة برمجة التطبيقات Protected Audience API: يجري البائعون مزادات على الأجهزة
- قراءة دليل واجهة برمجة التطبيقات: يمكن للبائعين معرفة المزيد عن
runAdAuction()وأفضل الممارسات المتعلقة بوقت استجابة مزادات الإعلانات.
5- يطلب البائع والمشترين المشاركون بيانات في الوقت الفعلي من خدمة المفتاح/القيمة
خلال مزاد الإعلانات، يمكن للبائع طلب بيانات في الوقت الفعلي حول تصميمات إعلانات معيّنة
من خلال تقديم طلب إلى خدمة المفتاح/القيمة.
يمكن للبائع طلب هذه المعلومات أثناء
runAdAuction() من خلال السمة trustedScoringSignalsUrl،
بالإضافة إلى المفاتيح من السمتَين 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 API: جلب البيانات في الوقت الفعلي من خدمة Protected Audience API أو مفتاح القيمة
- اطّلِع على مقالة فتح المصدر عن خدمة المفتاح/القيمة في Protected Audience API.
6. يتم عرض الإعلان الفائز
ينتهي الوعد الذي ترجعه runAdAuction() إلى كائن ضبط الإطار المحمي (FencedFrameConfig) عند ضبط علامة resolveToConfig على true في إعدادات المزاد. يتم استخدام تكوين الإطار بواسطة إطار مزوَّد بحدود لنقل الإطار إلى الإعلان الفائز، غير أنّ عنوان URL للإعلان لا يكون مرئيًا لأداة تضمين الإطارات.
يتوفّر عنصر إعداد الإطار المقيّد بدءًا من الإصدار M114. لمزيد من المعلومات حول الكائن FencedFrameConfig، يُرجى الاطّلاع على مقالة مدونة Chrome.
- الاطّلاع على الشرح التوضيحي بشأن Protected Audience API: تعرض المتصفّحات الإعلان الفائز
7. يتم الإبلاغ عن نتيجة المزاد
تتمثل الخطة طويلة الأجل في السماح للمتصفّح بإعداد تقارير عن نتائج المزاد للبائع والمشترين باستخدام واجهات برمجة تطبيقات التجميع الخاص.
كآلية مؤقتة لإعداد التقارير على مستوى الحدث، يمكن للرمز الذي ينفذ
reportResult() للبائع وreportWin() لمقدم عرض السعر الفائز استدعاء
الدالة sendReportTo(). ويأخذ هذا وسيطة واحدة: سلسلة تمثّل عنوان URL يتم جلبه بعد اكتمال المزاد، وهي ترمّز المعلومات على مستوى الحدث للإبلاغ عنها.
- قراءة دليل واجهة برمجة التطبيقات: معلومات حول تقارير البائعين والمشترين
8. الإبلاغ عن نقرة على إعلان
يتم الإبلاغ عن نقرة على إعلان معروض في إطار محاط بسياج. لمزيدٍ من المعلومات عن كيفية عمل ذلك، اطّلِع على إعداد تقارير إعلانات الإطارات المحظورة.
ما الفرق بين Protected Audience API وTURTLEDOVE؟
إنّ Protected Audience API هي أول تجربة يتم تنفيذها في Chromium ضمن مجموعة اقتراحات TURTLEDOVE.
تتّبع Protected Audience API مبادئ TURTLEDOVE عالية المستوى. استندت بعض الإعلانات على الإنترنت إلى عرض إعلان على شخص يُحتمل أن يكون مهتمًا وقد سبق له التفاعل مع المعلن أو الشبكة الإعلانية. في السابق، كان الهدف من هذه الطريقة هو التعرّف على شخص معيّن أثناء تصفّحه مواقع إلكترونية، وهي إحدى مخاوف الخصوصية الأساسية في شبكة الويب اليوم.
تهدف مبادرة TURTLEDOVE إلى توفير واجهة برمجة تطبيقات جديدة لمعالجة حالة الاستخدام هذه مع توفير بعض التطورات الرئيسية في مجال الخصوصية:
- يحتفظ المتصفح، وليس المعلن، بالمعلومات المتعلقة بما يعتقد المعلن أن الشخص مهتم به.
- ويمكن للمعلنين عرض الإعلانات استنادًا إلى أحد الاهتمامات، ولكن لا يمكنهم الجمع بين هذا الاهتمام ومعلومات أخرى حول أحد الأشخاص، لا سيما من هويته أو الصفحة التي يزورها.
نشأت Protected Audience API من TURTLEDOVE ومجموعة من الاقتراحات ذات الصلة بإجراء تعديلات بهدف تقديم خدمة أفضل للمطوّرين الذين قد يستخدمون واجهة برمجة التطبيقات:
- في SPARROW: اقترح Criteo إضافة نموذج خدمة ("Gatekeeper") يعمل في بيئة تنفيذ موثوقة (TEE). تتضمّن Protected Audience API استخدامًا محدودًا لبيئة التنفيذ الموثوقة (TEE) من أجل البحث عن البيانات في الوقت الفعلي وإعداد التقارير المجمّعة.
- وصفت اقتراحات TERN وPARRROT من NextRoll الأدوار المختلفة التي يتمتع بها المشترين والبائعون في المزاد على الجهاز فقط. يستند مسار عروض أسعار الإعلانات أو النتائج في Protected Audience API إلى هذه العوامل.
- حسّنت تعديلات TURTLEDOVEالمستندة إلى النتائج وعلى مستوى المنتج من RTB House نموذج إخفاء الهوية وميزات التخصيص في المزاد على الجهاز فقط.
- PARAKEET هي اقتراح من Microsoft لتقديم خدمة إعلانية تشبه TURTLEDOVE تعتمد على خادم وكيل يعمل في بيئة TEE بين المتصفِّح ومزوّدي تقنية الإعلان لإخفاء هوية طلبات الإعلانات وفرض خصائص الخصوصية. لم تستخدِم Protected Audience API نموذج الخادم الوكيل هذا. نعمل على دمج واجهات برمجة تطبيقات JavaScript لكل من PARAKEET وProtected Audience API معًا، دعمًا للعمل المستقبلي لدمج أفضل الميزات في كلا العرضَين.
لم تمنع Protected Audience API حتى الآن شبكة المواقع الإعلانية الإلكترونية من معرفة الإعلانات التي تظهر للمستخدمين. ونتوقّع تعديل واجهة برمجة التطبيقات لكي تصبح أكثر خصوصية بمرور الوقت.
هل يمكن استخدام Topics API مع Protected Audience API؟
رائع يمكن للبائع أو مقدِّم عروض الأسعار استخدام موضوع تمت ملاحظته للمستخدم الحالي، وذلك من خلال Topics API. يمكن تضمين موضوع في الخصائص التالية:
auctionSignals، وهي خاصية لكائن إعدادات المزاد التي تم تمريرها إلىnavigator.runAdAuction()userBiddingSignals، وهي سمة لكائن ضبط مجموعة الاهتمامات التي تم تمريرها إلىnavigator.joinAdInterestGroup()
إعدادات المتصفِّح المتاحة
يمكن للمستخدمين تعديل مشاركتهم في الإصدارات التجريبية من "مبادرة حماية الخصوصية" في Chrome من خلال
تفعيل إعدادات المستوى الأعلى أو إيقافها في
chrome://settings/adPrivacy.
أثناء الاختبار الأوّلي، سيتمكّن المستخدمون من استخدام إعدادات "مبادرة حماية الخصوصية" العالية المستوى هذه لإيقاف Protected Audience API. يخطط Chrome للسماح للمستخدمين بالاطّلاع على قائمة مجموعات الاهتمامات التي تمت إضافتهم إليها وإدارتها على مواقع الويب التي زاروها. كما هو الحال مع تقنيات "مبادرة حماية الخصوصية" نفسها، قد تتطوّر إعدادات المستخدمين استنادًا إلى الملاحظات الواردة من المستخدمين والهيئات التنظيمية وغيرهم.
سنواصل تعديل الإعدادات المتاحة في Chrome بناءً على الاختبارات والملاحظات. نخطط في المستقبل لتقديم إعدادات أكثر دقة لإدارة Protected Audience API والبيانات المرتبطة بها.
لا يمكن للمتصلين من واجهة برمجة التطبيقات الوصول إلى عضوية المجموعة عندما يتصفّح المستخدمون في "وضع التصفّح المتخفي"، وتتمّ إزالة الاشتراك عندما يمحو المستخدمون بيانات مواقعهم الإلكترونية.
هل يخزن المتصفّح مؤقتًا وظائف Protected Audience؟
التخزين المؤقت للموارد التي تحتوي على أدوات Protected Audience API يمكنك استخدام العنوان Cache-Control للتحكّم في سلوك التخزين المؤقت.
التفاعل مع الملاحظات ومشاركتها
الحصول على دعم
لطرح أسئلة والحصول على الدعم بشأن عملية التنفيذ أو العرض التوضيحي أو التوثيق:
- GitHub: اطّلِع على الفيديو التوضيحي وطرح الأسئلة وتابِع المناقشة.
- العرض التوضيحي: يمكنك طرح مشكلة في مستودع الرموز التجريبية.
- فريق دعم المطوّرين: يمكنك طرح الأسئلة والانضمام إلى المناقشات حول مستودع دعم المطوّرين في "مبادرة حماية الخصوصية". اختَر نموذج المشكلة في Protected Audience API.
- تنفيذ الإعلانات في Chrome: بالنسبة إلى الأخطاء أو المشاكل المرتبطة بتنفيذ Protected Audience API في Chrome، يمكنك الاطّلاع على المشاكل الحالية أو حلّ مشكلة جديدة.
إذا كانت لديك أسئلة عامة أكثر حول تلبية احتياجاتك باستخدام Protected Audience API، يمكنك الإبلاغ عن مشكلة في مستودع واجهة برمجة التطبيقات. يمكنك أيضًا مناقشة حالات الاستخدام في المجال من خلال تحسين مجموعة خدمات الإعلان على الويب التابعة لـ W3C.
استخدِم نموذج الملاحظات المتعلّق بـ "مبادرة حماية الخصوصية" لمشاركة الملاحظات والآراء بشكل خاص مع فريق Chrome خارج المنتديات العامة.
إيقاف
هل تريد إيقاف Protected Audience API؟ تعرَّف على كيفية حظر الوصول إلى Protected Audience API، بصفتك مالك موقع إلكتروني أو مستخدِم فردي.
البقاء على اطّلاع
- لتلقّي إشعارات بتغييرات حالة واجهة برمجة التطبيقات، يمكنك الانضمام إلى القائمة البريدية للمطوّرين.
- لمتابعة جميع المناقشات الجارية حول واجهة برمجة التطبيقات، انقر على الزر مشاهدة في صفحة واجهة برمجة التطبيقات على GitHub. يتطلب ذلك أن يكون لديك أو إنشاء حساب GitHub.
- لتلقّي آخر الأخبار بشكل عام حول "مبادرة حماية الخصوصية"، يُرجى الاشتراك في خلاصة RSS [مستوى التقدّم في "مبادرة حماية الخصوصية"]
- الانضمام إلى المكالمات المُجدوَلة لواجهة Protected Audience API (كل أسبوع) نرحب بالجميع للانضمام إلينا - للمشاركة، احرص أولاً على الانضمام إلى WICG. يمكنك المشاركة بنشاط أو مجرد الاستماع!