مزادات الإعلانات على الجهاز فقط لعرض تجديد النشاط التسويقي وشرائح الجمهور المخصّصة بدون تتبُّع الجهات الخارجية على مواقع إلكترونية متعددة
من هم المستخدمون المعنيون بهذه المقالة؟
تتناول هذه المقالة أساسيات Protected Audience API وتشرح بعض البيانات الأساسية. الأخرى، لكنها لا تخوض في الكثير من التفاصيل الفنية.
- إذا كنت تعمل في مجال الإعلان أو تكنولوجيا الإعلان، ستحصل على نظرة عامة حول طريقة عمل Protected Audience
- إذا كنت مطوّرًا أو مهندس برامج، يقدّم دليل المطوِّرين Protected Audience API المزيد من المعلومات تفاصيل فنية متعمقة عن واجهة برمجة التطبيقات. اطّلِع على أحدث حالة لإمكانات ميزة Protected Audience في انتظار المراجعة
يمكنك الرجوع إلى مسرد المصطلحات للاطّلاع على المصطلحات المُستخدَمة في مستندات Protected Audience في نهاية هذه المقالة، يمكنك معرفة كيفية التفاعل مع الملاحظات ومشاركتها
ما هي Protected Audience API؟
Protected Audience API هي إحدى مبادرة حماية الخصوصية خدمة لعرض حالات استخدام تجديد النشاط التسويقي والجمهور المخصص، بحيث لا يمكن للجهات الخارجية تتبُّع سلوك تصفّح المستخدمين عبر المواقع الإلكترونية.
تتيح Protected Audience API تفعيل المزادات على الجهاز فقط من خلال المتصفّح لاختيار الإعلانات ذات الصلة من المواقع الإلكترونية التي زارها المستخدم سابقًا.
Protected Audience API هي أول تجربة يتم تنفيذها في Chromium ضمن مجموعة اقتراحات TURTLEDOVE: تشير رسالة الأشكال البيانية الفرق بين الجمهور المحمي وTURTLEDOVE يتعلق في المقام الأول بفصل دور مشتري الإعلانات وبائعها على الجهاز فقط توضح الأقسام التالية كيف تعمل Protected Audience API
Protected Audience API في دقيقة واحدة
للحصول على نظرة عامة أكثر تفصيلاً عن Protected Audience API، يُرجى الاطّلاع على دليل المطوِّرين Protected Audience API
![نظرة عامة على كلّ مرحلة من مراحل نشاط Protected Audience API](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/protected-audience-overview.png?authuser=8&hl=ar)
تستخدم Protected Audience API مجموعات الاهتمامات للسماح للمواقع الإلكترونية تعرض إعلانات ملائمة لمستخدميها.
على سبيل المثال، عندما يزور أحد المستخدمين موقعًا إلكترونيًا يريد الإعلان عن منتجاته، مالك مجموعة باهتمامات (مثل يمكن أن تطلب المنصة جانب الطلب (DSP) من متصفّح المستخدم إضافة اشتراك إلى مجموعة الاهتمامات. في حال تم الطلب بنجاح، يسجِّل المتصفح ما يلي:
- اسم مجموعة الاهتمام: على سبيل المثال، "دراجات مخصصة".
- مالك مجموعة الاهتمامات: على سبيل المثال، "https://dsp.example".
- معلومات ضبط مجموعة الاهتمامات للسماح للمتصفّح بالوصول إلى رمز عرض الأسعار ورمز الإعلان والبيانات في الوقت الفعلي، في حال تمت دعوة مالك المجموعة تقديم عرض سعر معيّن في مزاد إعلانات.
وفي وقت لاحق، عندما يزور المستخدم موقعًا إلكترونيًا به مساحة إعلانية متاحة، يختار بائع المساحة الإعلانية
(مقدم خدمة من جهة البيع (SSP) أو الموقع الإلكتروني
نفسه) استخدام Protected Audience لإجراء مزاد إعلانات واختيار الإعلانات الأكثر ملاءمةً
لعرضها للمستخدم. يتصل البائع بـ navigator.runAdAuction()
التي توفّر قائمة بمالكي مجموعات الاهتمامات التي تمت دعوتهم لتقديم عروض الأسعار.
لا يمكن تقديم عروض الأسعار إلا من خلال مجموعات الاهتمامات التي يكون المتصفّح عضوًا فيها، والتي تمت دعوة مالكيها لتقديم عروض أسعار.
يتم استرداد رمز عرض الأسعار من عنوان URL مُقدَّم في مجموعة الاهتمامات التكوين. توفر هذه التعليمة البرمجية بيانات حول مجموعة الاهتمامات ومعلومات من البائع، إلى جانب بيانات سياقية عن ومن المتصفح.
وتُعرف كل مجموعة اهتمامات تقدِّم عرض سعر باسم "المشتري".
عندما يستدعي المتصفح هذه الدالة لتنفيذ مزاد الإعلانات، يظهر رمز كل مشترٍ ينشئ عرض سعر بمساعدة البيانات في الوقت الفعلي التي يقدمها خدمة مفتاح الجمهور/القيمة المحمية. بعد ذلك، يجب على البائع هذه العروض بالإضافة إلى البيانات التي يمتلكها البائع في الوقت الفعلي ويقيّم كل لعرض السعر. يفوز عرض السعر الذي سجّل أعلى نتيجة بالمزاد.
يتم عرض الإعلان الفائز في إطار مضمّن. يتم تحديد عنوان URL لتصميم الإعلان في عرض السعر، ويجب أن يتطابق المصدر مع عنوان URL في القائمة التي تقدّمها إعدادات مجموعة الاهتمامات.
يمكن للبائع الإبلاغ عن نتيجة المزاد (reportResult()
)، ويمكن للمشترين
والإبلاغ عن فوزهم (reportWin()
).
اطّلِع على مزيد من المعلومات عن تقارير مزادات الجمهور المحمي.
لماذا نحتاج إلى Protected Audience API؟
يمكن أن يؤدي فهم اهتمامات المستخدمين إلى تفعيل إعلانات أكثر ملاءمةً من مجرد اختيار الإعلانات التي تستند إلى محتوى الموقع (استهداف المحتوى) أو باستخدام المعلومات التي يقدّمها المستخدم إلى الموقع الإلكتروني الذي يظهر عليه الإعلان (استهداف بيانات الطرف الأول).
عادةً، تعرّفت المنصات الإعلانية على اهتمامات المستخدمين من خلال تتبُّع السلوك عبر المواقع الإلكترونية. تحتاج المتصفّحات إلى طريقة تمكّن المنصات الإعلانية من اختيار الملائمة، بحيث يمكن لناشري المحتوى الحصول على أرباح من الإعلانات بدون البحث عن مواقع إلكترونية متعددة التتبع.
تهدف Protected Audience API إلى تقريب منصة الويب من الحالة التي متصفّح المستخدم على جهازه، وليس المعلن أو منصات تكنولوجيا الإعلان، التي تخصّ معلومات حول ما يهتم به هذا الشخص.
كيف يمكنني تجربة Protected Audience API؟
يوضّح دليل المطوِّرين Protected Audience API كيفية استخدام واجهة برمجة التطبيقات وكيفية الاختبار محليًا.
protected-audience-demo.web.app توفّر جولة تفصيلية حول عملية النشر الأساسية باستخدام Protected Audience على مستوى المعلِن والناشر المواقع. يشرح الفيديو التجريبي لميزة Protected Audience طريقة عمل هذا الرمز البرمجي ويعاينه. طريقة استخدام "أدوات مطوري البرامج في Chrome" لتصحيح الأخطاء
ما هي إعدادات المتصفِّح المتاحة؟
يمكن للمستخدمين تعديل إعدادات المشاركة في الفترات التجريبية من "مبادرة حماية الخصوصية" في Chrome من خلال:
تمكين أو تعطيل إعداد المستوى الأعلى في
chrome://settings/adPrivacy
أثناء الاختبار الأوّلي، يمكن للمستخدمين إيقاف Protected Audience API باستخدام
إعدادات "مبادرة حماية الخصوصية"
يخطط Chrome للسماح للمستخدمين بالاطّلاع على قائمة مجموعات الاهتمامات وإدارتها تمت إضافتهم إليها عبر المواقع التي زاروها. كما هي الحال مع سياسة الخصوصية تقنيات وضع الحماية، وقد تتطور إعدادات المستخدم مع ملاحظات المستخدمين، والهيئات التنظيمية وغيرها.
سنعدّل الإعدادات المتاحة في Chrome مع تقدّم Protected Audience API. بالاستناد إلى الاختبارات والملاحظات. في المستقبل، سنقدم إعدادات أكثر دقة لإدارة Protected Audience البيانات المرتبطة بها.
لا يمكن للمتصلين من واجهة برمجة التطبيقات الوصول إلى عضوية المجموعة عند تصفُّح المستخدمين في "وضع التصفُّح المتخفي". وتتمّ إزالة العضوية عندما يمحو المستخدمون بيانات مواقعهم الإلكترونية.
هل يمكنني إيقاف Protected Audience API؟
اطّلِع على كيفية حظر الوصول إلى Protected Audience API. إما كمالك للموقع أو كمستخدم فردي.
المفاهيم الرئيسية
هل تبحث عن مزيد من المعلومات عن مصطلحات ميزة "الجمهور المحمي"؟ ارجع إلى مسرد مصطلحات "مبادرة حماية الخصوصية"
ما هي المجموعة ذات الاهتمامات المشتركة؟
إنّ مجموعة الاهتمامات المشتركة في Protected Audience API تمثّل مجموعة من المستخدمين ذوي الاهتمامات المشتركة. بشكل مطابق لقائمة تجديد النشاط التسويقي.
يكون لكل مجموعة اهتمامات في Protected Audience API مالكها. ستنشئ أنواع مختلفة من المالكين أنواعًا مختلفة من مجموعات الاهتمامات بحالات استخدام مختلفة.
يطلب المالك من متصفّح المستخدم إضافة عضوية في مجموعة اهتماماته من خلال
استدعاء دالة JavaScript navigator.joinAdInterestGroup()
، مع تقديم
معلومات مثل البيانات المتعلقة بالإعلانات ذات الصلة بمجموعة الاهتمامات، وعنوان URL
للغة JavaScript المستخدمة في عروض الأسعار ويمكن تحديد بيانات مجموعة الاهتمامات (مثل الإعلانات).
تحديثه، ويمكن تفعيل مجموعة اهتمامات لمدة تصل إلى 30 يومًا.
أنواع المجموعات ذات الاهتمامات المشتركة
يعرض الجدول التالي أمثلة على الأنواع المختلفة من مجموعات الاهتمامات والمجموعات في Protected Audience API.
المالك | مثال | الاهتمام | مثال | حالات الاستخدام |
---|---|---|---|---|
المعلِن | ماكينة صنع الدرّاجات | المنتجات | الأشخاص الذين شاهدوا صفحات منتجات لفئة معيّنة من الدراجات | تجديد النشاط التسويقي للأشخاص الذين تفاعلوا من قبل مع العلامة التجارية. |
الناشر | موقع إلكتروني إخباري | المحتوى | الأشخاص الذين يقرؤون عن ركوب الدراجات | يمكن للناشرين استخدام بيانات الطرف الأول لتفعيل المعلِنين. لشراء إعلانات ملائمة للقرّاء على مواقعهم الإلكترونية. حاسمة مجموعة الاهتمامات المشتركة التي يملكها الناشر تتيح للناشرين فعل الشيء نفسه، عندما يتصفح هؤلاء الأشخاص مواقع أخرى. قد يتمكن الناشرون تحصيل رسوم مقابل إمكانية عرض الإعلانات على شرائح معينة من جمهورك. |
تكنولوجيا الإعلان | معالِج الإشارات الرقمية (DSP) | فئة المنتجات | الأشخاص الذين أبدوا اهتمامًا بمعدات ركوب الدراجات | يمكن لشركة تكنولوجيا الإعلان إنشاء مجموعة اهتمام وإدارتها من الأشخاص الذين يعتقدون أنهم في السوق لفئة معينة من السلعة. مجموعة الاهتمامات هذه يمكن استخدامها بعد ذلك للإعلان عن منتجات على مواقع تبيع أشياء من تلك الفئة ( الذين يعملون مع شركة تكنولوجيا الإعلان). |
يسمح Chrome بما يصل إلى 1000 مجموعة اهتمام لكل مالك، وما يصل إلى 1000 مجموعة اهتمام مالكين. تهدف هذه الحدود إلى كونها حواجز حماية، ولا يتم اختراقها أثناء العمليات العادية.
من هو المشتري؟
في Protected Audience API، يكون المشتري هو طرف يملك مجموعة اهتمام ويقدّم عروض أسعار في مزاد إعلانات.
على سبيل المثال:
- المعلِن: العمل نيابةً عن نفسها
- المنصة جانب الطلب (DSP): العمل للمعلنين.
- مالك مجموعة الاهتمامات: العمل لدى معلنين متعددين.
لدى المشترون ثلاث وظائف:
- اختَر ما إذا كنت تريد المشاركة في مزاد.
- اختيار الإعلانات وحساب عرض السعر.
- أبلِغ عن نتيجة المزاد.
يتم تنفيذ هذه المهام آليًا، وذلك من خلال رمز يوفّره المشتري يتم تشغيله. خلال مزاد إعلانات Protected Audience API
عندما يطلب مشترٍ من متصفح المستخدم إضافة مجموعة اهتمامات إلى المجموعات التي ينتمي إليها (من خلال الاتصال
دالة JavaScript navigator.joinAdInterestGroup()
) يزوّد المشتري المتصفح بما يلي:
- عنوان URL لرمز عروض الأسعار الذي سيتم استخدامه عندما يجري البائع مزاد إعلانات.
- ومن المحتمل أن تتضمّن عناوين URL تصميمات الإعلانات لمجموعة الاهتمامات. (يمكن إضافة عناوين URL للإعلانات لاحقًا مع تحديث).
- قائمة بمفاتيح البيانات المطلوب الاستعلام عنها، وعنوان URL لخدمة المفتاح/القيمة للمشتري لتفعيل رمز عروض الأسعار من أجل الحصول على البيانات في الوقت الفعلي خلال المزاد
يمكن أن يتضمّن رمز المشتري أيضًا دالة reportWin()
للإبلاغ عن نتائج المزاد.
من يدير مزاد الإعلانات؟
هناك جهات متعددة يمكن أن تُجري مزادًا لبيع مساحة إعلانية.
على سبيل المثال:
- ناشر محتوى: يعمل بنفسه لاستضافة محتوى الإعلان على موقعه الإلكتروني.
- منصّة جهة العرض (SSP): العمل مع الناشر وتقديم خدمات أخرى.
- النص البرمجي التابع لجهة خارجية: العمل لدى الناشر من أجل تفعيل المشاركة في مزادات الإعلانات.
باستخدام Protected Audience API، يحصل بائع المساحة الإعلانية على ثلاث مهام:
- فرض قواعد الناشرين: لتحديد المشترين وعروض الأسعار المؤهلة.
- تنفيذ منطق المزاد: تشغيل JavaScript في worklets لحساب نقاط الرغبة لكل عرض أسعار.
- أبلِغ عن نتيجة المزاد.
يتم تنفيذ هذه المهام آليًا، وذلك من خلال الرمز الذي يقدّمه البائع عند بدء الإعلان.
المزاد من خلال استدعاء دالة JavaScript navigator.runAdAuction()
.
كيف يعمل مزاد الإعلانات في Protected Audience API؟
يوضِّح المخطّط البياني التالي كلّ مرحلة من مراحل مزاد الإعلانات في Protected Audience API:
![ست مراحل في مزاد إعلانات Protected Audience API](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/protected-audience-steps.png?authuser=8&hl=ar)
في Protected Audience API، يكون مزاد الإعلانات مجموعة من برامج JavaScript الصغيرة التي يشغّلها المتصفّح على حساب المستخدِم. جهازك لاختيار إعلان وللحفاظ على الخصوصية، يتم تشغيل جميع رموز مزاد الإعلانات الخاصة بالبائع والمشترين. في تطبيقات JavaScript معزولة لا يمكنها التواصل مع العالم الخارجي.
بائع (ناشر أو منصّة جهة توريد) بدء مزاد إعلانات Protected Audience على موقع إلكتروني يبيع مساحة إعلانية (مثل موقع إخباري موقعك). حيث يختار البائع المشترين للمشاركة في المزاد، وتشير إلى المساحة المعروضة للبيع وتوفّر معايير إضافية للإعلان. يُعد كل مشترٍ مالكًا لمجموعة ذات اهتمامات مشتركة.
يزود البائع المتصفح برمز لتسجيل عروض الأسعار، والذي يتضمن قيمة كل عرض سعر للمواد الإبداعية للإعلان والبيانات الأخرى التي تم عرضها من كل مشترٍ. خلال المزاد، ضبط عروض الأسعار من المشترين ورمز نقاط عرض السعر من البائع، يُمكن تلقي بيانات من خدمات المفتاح/القيمة: بمجرد اختيار الإعلان معروض (في إطار مسيوج للحفاظ على privacy) يمكن للبائع والمشتري الفائز الإبلاغ عن نتيجة المزاد.
- يزور أحد المستخدِمين موقعًا إلكترونيًا يعرض الإعلانات.
- يبدأ رمز البائع مزادًا. ويحدّد البائع المساحة الإعلانية عرض السعر للبيع والذين يمكنهم تقديم عروض أسعار له، بالإضافة إلى طريقة لتسجيل عروض الأسعار هذه.
- يتم تنفيذ رمز المشتري الذي تمت دعوته لإنشاء عرض سعر، وعنوان URL لإعلان ذي صلة. والمواد الإبداعية وغيرها من البيانات. يستطيع النص البرمجي لعرض الأسعار الاستعلام عن البيانات في الوقت الفعلي مثل الميزانية المتبقية للحملة الإعلانية، من المفتاح/القيمة للمشتري الخدمة.
- يسجِّل رمز البائع كل عرض سعر ويختار فائزًا. يستخدم هذا المنطق دالة قيمة عرض السعر وبيانات أخرى لإرجاع الرغبة في عرض السعر ورفض إعلان لا يمكنك الفوز على الإعلان الرابح استنادًا إلى المحتوى. يمكن للبائع استخدام ملفات تعريف الارتباط الخاصة به خدمة المفتاح/القيمة للبيانات في الوقت الفعلي. قبل بدء مزاد، يجد البائع أفضل إعلان سياقي الشريحة الإعلانية
- يتم عرض الإعلان الفائز ككائن ضبط إطار مشروط عند ضبط علامة
resolveToConfig
في إعدادات المزاد. يتمّ استخدام الإعداد للانتقال ضمن الإطار المحدّد إلى تصميم الإعلان، ويكون عنوان URL لتصميم الإعلان مخفيًا عن كلّ من البائع والناشر. في حال ضبط علامةresolveToConfig
علىfalse
أو عدم ضبطها، يتم عرض الإعلان الفائز على شكل URN مبهم يمكن استخدامه لعرض الإعلان في إطار iframe. يتوفّر عنصر إعداد الإطار المحدود بدءًا من الإصدار M114. - ويتم إبلاغ البائع والمشترين الفائزين عن المزاد.
وهناك آلية للإبلاغ عن خسارة المشترين قيد المناقشة.
ما هي خدمة المفتاح/القيمة Protected Audience API؟
تتيح خدمة مفتاح أو قيمة Protected Audience API لتكنولوجيا الإعلانات طلب البيانات في الوقت الفعلي عندما يقدّم المشتري عرض سعر، كما تتيح للبائعين عرض الإعلانات مع الحفاظ على الخصوصية. يمكنك الاطّلاع على خدمة المفتاح/القيمة Protected Audience API وغيرها في خدمات Protected Audience API.
يتم نشر خدمة المفتاح/القيمة إلى البنية الأساسية للسحابة الإلكترونية الخاصة بتكنولوجيا الإعلان، ويتم تشغيل الخدمة في بيئة تنفيذ موثوقة. لا يمكن أن يؤدي طلب خدمة المفتاح/القيمة إلى التسجيل على مستوى الحدث أو أن يكون له آثار جانبية أخرى. ستوفّر خدمة المفتاح/القيمة أيضًا الدوال التي يحدّدها المستخدم (UDF) التي تسمح لتقنيات الإعلانات بتنفيذ منطق مخصّص لها ضمن خدمة المفتاح/القيمة.
يقدِّم المشتري أو البائع قائمة "المفاتيح" لتحديد البيانات التي تتطلّبها خدمة المفتاح/القيمة من Protected Audience API تستجيب خدمة المفتاح/القيمة بقيمة لكل مفتاح.
يتوفّر الآن مفتاح/رمز خدمة القيمة Protected Audience API في مستودع GitHub ضمن "مبادرة حماية الخصوصية". يمكن أن يستخدم مطوّرو Chrome وAndroid هذه الخدمة.
يمكنك الاطّلاع على مزيد من المعلومات عن خدمة المفتاح/القيمة في Protected Audience API من شرح حول واجهة برمجة التطبيقات والشرح التوضيحي بشأن نموذج الثقة
كيف يتم دمج البيانات في الوقت الفعلي في المزادات؟
قد يحتاج المشترون أو البائعون في مزاد الإعلانات إلى الوصول إلى البيانات في الوقت الفعلي. البيانات. على سبيل المثال، قد يرغب المشترين في حساب الميزانية المتبقية في إحدى الحملات الإعلانية أو قد يُطلب من البائع التحقّق من تصاميم الإعلانات للتأكّد من توافقها مع سياسات الناشر.
لتلبية متطلبات الخصوصية في Protected Audience API، توفّر خدمة المفتاح/القيمة البيانات في الوقت الفعلي المطلوبة خلال مزاد الإعلانات. عندما يستدعي كل مشترٍ navigator.joinAdInterestGroup()
، يحدّد المشتري عنوان URL لخدمة المفتاح/القيمة ويحدّد المفاتيح المطلوب الاستعلام عنها للخدمة أثناء المزاد. وبالمثل، عندما يُجري البائع مزاد إعلانات من خلال الاتصال بخدمة navigator.runAdAuction()
، يقدّم البائع عنوان URL لخدمة المفتاح/القيمة. سيتم الاستعلام عن خدمة المفتاح/القيمة لدى البائع باستخدام عنوان URL لعرض تصميم الإعلان.
للاختبار الأولي، يتم استخدام نموذج "إحضار الخادم الخاص بك". وعلى المدى الطويل، ستحتاج تقنيات الإعلان إلى استخدام خدمات المفاتيح/القيمة المفتوحة المصدر في Protected Audience API من خلال بيئات تنفيذ موثوق بها لاسترداد البيانات في الوقت الفعلي.
لضمان توفّر ما يكفي من الوقت لاختبار المنظومة المتكاملة، لا نتوقّع أن نطلب استخدام خدمات المفاتيح/القيمة المفتوحة المصدر أو بيئات التنفيذ الموثوق بها إلا بعد إيقاف ملفات تعريف الارتباط التابعة لجهات خارجية نهائيًا. وسنرسل إشعارًا مهمًا إلى المطوّرين لبدء اختبار التطبيقات واعتمادها قبل تنفيذ عملية النقل هذه.
كيف يتم استخدام بيانات الطرف الأول في مزاد Protected Audience API؟
بيانات الطرف الأول هي بيانات يمتلكها الموقع الإلكتروني على مستخدميه. على سبيل المثال، إذا حدّد أحد المستخدمين لونه المفضّل على موقع المعلِن أو الناشر، يُعتبر هذا اللون بيانات الطرف الأول.
في مزاد يستخدم Protected Audience API، يمكن للمعلِن استخدام بيانات الطرف الأول لتحديد العضوية في مجموعة الاهتمامات الإعلانية، ويمكنه أيضًا نقل البيانات إلى مجموعة الاهتمامات على أنّها userBiddingSignals
. وستكون بيانات الطرف الأول من المعلِن متاحة فقط للمشترين خلال خطوة إنشاء عروض الأسعار، ولن تكون متاحة للبائعين.
على سبيل المثال، إذا كان المعلِن يعرف اللون المفضّل لدى المستخدم، يمكن ضبط القيمة في إعدادات مجموعة الاهتمامات على userBiddingSignals
عند إضافة المستخدم إلى مجموعة الاهتمامات:
const interestGroup = {
owner: 'https://example-buyer.com',
name: 'running-shoes',
userBiddingSignals: {
favoriteColor: 'blue' // First-party data
},
// ...other interest group settings
};
navigator.joinAdInterestGroup(interestGroup, 3600);
يمكن للناشر أيضًا تمرير بيانات الطرف الأول من خلال ضبط الإشارات في إعدادات المزاد عند بدء المزاد، ويمكنه أيضًا التحكّم في الجهات التي تتلقّى بيانات الطرف الأول. عندما يرسل الناشر بيانات الطرف الأول بتنسيق auctionSignals
، تصبح بيانات الطرف الأول متاحة لكل من المشترين والبائعين. عند تمرير البيانات بتنسيق sellerSignals
، لا تكون متاحة إلا للبائع، وعند تمريرها بتنسيق perBuyerSignals
، لا تكون متاحة إلا للمشترين المحدّدين. ويمكن للناشر أيضًا نقل بيانات الطرف الأول إلى مزادات المكوّنات. يجب أن يتّفق الناشر والمشاركون في المزاد على بيانات الطرف الأول التي يجب مشاركتها وطبيعة تنسيق البيانات.
يوضّح المثال التالي الطريقة التي يمكن بها للناشر تمرير بيانات الطرف الأول إلى مختلف المشاركين في المزاد:
const auctionConfig = {
seller: 'https://example-seller.com',
auctionSignals: {
favoriteColor: 'blue', // Both buyer and seller will receive this signal
},
sellerSignals: {
favoriteIceCreamFlavor: 'chocolate', // Only the seller will receive this signal
},
perBuyerSignals: {
'https://example-buyer.com': {
favoriteDrink: 'tea', // Only a specific buyer will receive this signal
},
},
// The same pattern applies to the component auction
componentAuctions: [{
seller: 'https://example-component-seller.com',
auctionSignals: { ... },
sellerSignals: { ... },
perBuyerSignals { ... }
}],
// ...other auction settings
};
navigator.runAdAuction(auctionConfig);
التعرف على المزيد
للحصول على نظرة عامة أكثر تفصيلاً عن Protected Audience API، يُرجى الاطّلاع على دليل المطوِّرين Protected Audience API
المطورون
إذا كنت مستعدًا لبدء العمل باستخدام Protected Audience API، اطّلِع على التجربة والمشاركة
لقد كتبنا دليلاً للمطوّرين حول واجهة برمجة التطبيقات وأنشأنا عرضًا توضيحيًا لواجهة Protected Audience API يقدّم عرضًا تفصيليًا حول عملية النشر الأساسية لاستخدام Protected Audience API. يوضِّح الفيديو التوضيحي حول Protected Audience API طريقة عمل الرمز التجريبي، كما يوضِّح طريقة استخدام "أدوات مطوري البرامج في Chrome" لتصحيح الأخطاء في Protected Audience API.
التفاعل مع الملاحظات ومشاركتها
- GitHub: يُرجى الاطّلاع على الموضّح. طرح الأسئلة ومتابعة المناقشة
- الإشعارات: يمكنك الانضمام إلى الإشعارات السابقة أو عرضها في القائمة البريدية Protected Audience API.
- W3C: مناقشة حالات الاستخدام على مستوى المجال في مقالة تحسين النشاط الإعلاني على الويب المجموعة:
- فريق دعم المطوّرين: يمكنك طرح أسئلة حول التنفيذ وأفضل الممارسات، أو الانضمام إلى المناقشات حول مستودع دعم المطوّرين ضمن "مبادرة حماية الخصوصية"
- التنفيذ الحالي: إذا كانت لديك أسئلة عن تنفيذ Chrome لميزة Protected Audience، يُرجى الإبلاغ عن خطأ في Chromium.