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

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

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

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

تتناول هذه المقالة أساسيات Protected Audience API وتوضّح بعض المقصود بالأساسيات، ولكنها لا تتناول الكثير من التفاصيل الفنية.

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

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

ما هي واجهة برمجة التطبيقات Protected Audience API؟

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

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

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

Protected Audience API في دقيقة واحدة

للحصول على نظرة عامة أكثر تفصيلاً على Protected Audience API، يُرجى الاطّلاع على دليل مطوّري واجهة برمجة التطبيقات Protected Audience API.

نظرة عامة على كل مرحلة من مراحل دورة حياة Protected Audience API — دورة حياة Protected Audience API

تستخدِم Protected Audience API مجموعات الاهتمامات لتفعيل المواقع الإلكترونية ل عرض الإعلانات ذات الصلة بمستخدِميها.

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

اسم مجموعة الاهتمامات: على سبيل المثال، "درّاجات مخصّصة".
مالك المجموعة باهتمامات مشتركة: على سبيل المثال، "https://dsp.example".
معلومات ضبط مجموعة الاهتمامات للسماح للمتصفّح بالوصول إلى رمز عروض الأسعار ورمز الإعلان والبيانات في الوقت الفعلي، إذا تمت دعوة مالك المجموعة لمحاولة تقديم عروض أسعار في مزاد إعلاني

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

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

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

ويُعرف كلّ مستخدم ينتمي إلى مجموعة اهتمامات معيّنة ويقدّم عرض سعر باسم "مشترٍ".

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

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

يمكن للبائع الإبلاغ عن نتيجة المزاد (reportResult())، ويمكن للمشترين الإبلاغ عن عمليات الشراء الناجحة (reportWin()).

اطّلِع على مزيد من المعلومات عن تقارير مزادات "الجمهور المحمي".

لماذا نحتاج إلى Protected Audience API؟

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

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

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

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

يوضّح دليل المطوّر لواجهة برمجة التطبيقات Protected Audience API كيفية استخدام واجهة برمجة التطبيقات وكيفية الاختبار على الجهاز.
يوفّر protected-audience-demo.web.app بدوره بدوره شرحًا تفصيليًا لعملية نشر Protected Audience الأساسية على المواقع الإلكترونية للمعلِنين والناشرين. يوضّح الفيديو التجريبي لميزة "الجمهور المحمي" طريقة عمل هذا الرمز ويقدّم معاينة لكيفية استخدام "أدوات مطوّري البرامج في Chrome" لتصحيح الأخطاء.

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

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

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

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

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

هل يمكنني إيقاف Protected Audience API؟

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

المفاهيم الرئيسية

هل تبحث عن مزيد من المعلومات حول المصطلحات المتعلّقة بميزة "الجمهور المحمي"؟ يُرجى الرجوع إلى مسرد "مبادرة حماية الخصوصية".

ما هي مجموعة الاهتمامات؟

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

لكل مجموعة اهتمامات في Protected Audience API مالك. سينشئ أصحاب الحسابات أنواعًا مختلفة من مجموعات الاهتمامات في حالات استخدام مختلفة.

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

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

يقدّم الجدول التالي أمثلة على الأنواع المختلفة من مجموعات الاهتمامات وأصحابها في Protected Audience API.

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

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

ما هو المشتري؟

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

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

المعلِن: يتصرّف نيابةً عن نفسه.
وسيط عرض الطلب (DSP): يمثّل المعلِنين.
مالك مجموعة الاهتمامات: يعمل لدى معلِنين متعدّدين.

تتوفّر للمشترين ثلاث مهام:

اختَر ما إذا كنت تريد المشاركة في مزاد.
اختَر الإعلانات واحسب عرض السعر.
سجِّل نتيجة المزاد.

يتم تنفيذ هذه المهام آليًا، باستخدام رمز يوفّره المشتري ويتم تشغيله أثناء مزاد إعلانات Protected Audience API.

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

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

يمكن أن يتضمّن رمز المشتري أيضًا دالة reportWin() للإبلاغ عن نتيجة المزاد.

من يدير مزاد الإعلانات؟

هناك جهات متعددة قد تُجري مزادًا لبيع المساحة الإعلانية.

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

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

باستخدام Protected Audience API، يكون لدى بائع المساحة الإعلانية ثلاث مهام:

فرض قواعد الناشر: تحديد المشترين وعروض الأسعار المؤهّلة
تنفيذ منطق المزاد: يتمّ تنفيذ JavaScript في وحدات العمل لاحتساب درجة المرغوب فيه لكلّ عرض سعر.
سجِّل نتيجة المزاد.

يتم تنفيذ هذه المهام آليًا، في رمز يوفّره البائع عند بدء مزاد إعلاني من خلال استدعاء دالة JavaScript navigator.runAdAuction().

كيف يعمل مزاد الإعلانات في Protected Audience API؟

يوضّح المخطّط البياني التالي كل مرحلة من مراحل مزاد الإعلانات في Protected Audience API:

ست مراحل في مزاد إعلانات Protected Audience API — مراحل مزاد الإعلانات في "شريحة الجمهور المحمية"

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

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

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

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

إنّ آلية إعداد التقارير عن فقدان المشترين قيد المناقشة.

ما هي خدمة Protected Audience API Key/Value؟

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

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

يقدّم المشتري أو البائع قائمة "بالمفاتيح" لتحديد البيانات التي يحتاجها من خدمة Protected Audience API Key/Value. تستجيب خدمة Key/Value بقيمة لكل مفتاح.

يتوفّر الآن رمز خدمة المفتاح/القيمة في Protected Audience API في مستودع GitHub الخاص بـ "مبادرة حماية الخصوصية". يمكن لمطوّري Chrome وAndroid استخدام هذه الخدمة.

اطّلِع على مزيد من المعلومات عن خدمة Protected Audience API Key/Value من شرح واجهة برمجة التطبيقات وشرح نموذج الثقة.

كيف يتم دمج البيانات في الوقت الفعلي في المزادات؟

قد يحتاج المشترون أو البائعون في مزاد إعلاني إلى الوصول إلى data في الوقت الفعلي. على سبيل المثال، قد يريد المشترون احتساب الميزانية المتبقية في حملة إعلانية، أو قد يُطلب من العميل التحقّق من تصميمات الإعلانات وفقًا لسياسات الناشر.

لاستيفاء متطلبات الخصوصية في Protected Audience API، توفّر خدمة Key/Value البيانات في الوقت الفعلي المطلوبة أثناء مزاد الإعلانات. عندما يطلب كلّ مشترٍ navigator.joinAdInterestGroup()، يحدّد المشترِك عنوان URL لخدمة "المفتاح/القيمة" ويحدّد المفاتيح التي سيتمّ الاستعلام عنها من الخدمة أثناء المزاد. وبالمثل، عندما يُجري البائع مزادًا إعلانيًا من خلال طلب navigator.runAdAuction()، يقدّم البائع عنوان URL لخدمة Key/Value. سيتمّ طلب خدمة المفتاح/القيمة الخاصة بالبائع باستخدام عنوان URL لعرض تصميم الإعلان.

لإجراء الاختبار الأولي، يتم استخدام نموذج "إحضار الخادم الخاص بك". على المدى الطويل، ستحتاج تكنولوجيات الإعلان إلى استخدام خدمات 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 طريقة عمل الرمز التجريبي، ويعرض كيفية استخدام أدوات مطوّري البرامج في Chrome لتصحيح أخطاء Protected Audience API.

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

GitHub: يمكنك قراءة الشرح، طرح الأسئلة ومتابعتها.
الإعلانات: يمكنك الانضمام إلى القائمة البريدية لواجهة برمجة التطبيقات Protected Audience API أو الاطّلاع على الإعلانات السابقة.
W3C: مناقشة حالات استخدام المجال في Improving Web Advertising Business Group
دعم المطوّرين: يمكنك طرح أسئلة حول التنفيذ وأفضل الممارسات أو الانضمام إلى المناقشات على مستودع دعم المطوّرين في "مبادرة حماية الخصوصية".
التنفيذ الحالي: إذا كانت لديك أسئلة حول تنفيذ Chrome لميزة "الجمهور المحمي"، يمكنك إبلاغ فريق Chromium عن خطأ.