نظرة عامة على 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 مجموعات الاهتمامات لتفعيل المواقع الإلكترونية ل عرض الإعلانات ذات الصلة بمستخدِميها.

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

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

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

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

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

ويُعرف كلّ مشتري بأنّه مجموعة اهتمامات تقدّم عرض سعر.

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

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

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

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

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

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

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

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

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

  • يوضّح دليل المطوّر لواجهة برمجة التطبيقات Protected Audience API كيفية استخدام واجهة برمجة التطبيقات وكيفية الاختبار على الجهاز.

  • يوفّر protected-audience-demo.web.app شرحًا تفصيليًا حول عملية نشر ميزة "الجمهور المحمي" الأساسية على المواقع الإلكترونية للمعلنين والناشرين. يوضّح الفيديو التوضيحي "شريحة الجمهور المحمية" طريقة عمل هذا الرمز ويقدّم معاينة لكيفية استخدام أدوات مطوّري البرامج في 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 بما يصل إلى 1000 مجموعة اهتمامات لكل مالك، وما يصل إلى 1000 مالك مجموعة اهتمامات. هذه الحدود مخصّصة لحماية التطبيقات من تجاوزها، وليس من المفترض أن يتم تجاوزها أثناء التشغيل العادي.

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

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

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

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

على المشترين تنفيذ ثلاث مهام:

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

يتم تنفيذ هذه المهام آليًا، باستخدام رمز يوفّره المشتري ويتم تشغيله أثناء مزاد إعلانات 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 معزولة لا يمكنها التواصل مع العالم الخارجي.

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

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

  1. يزور أحد المستخدِمين موقعًا إلكترونيًا يعرض إعلانات.
  2. يبدأ رمز البائع مزادًا. يحدّد البائع المساحة الإعلانية التي هي للبيع والمستخدمين الذين يمكنهم تقديم عروض أسعار، بالإضافة إلى طريقة لتقييم عروض الأسعار هذه.
  3. يتم تنفيذ رمز المشتري المدعو لإنشاء عرض أسعار وعنوان URL لمادة عرض إعلان ملائمة وغيرها من البيانات. يمكن لنص عروض الأسعار طلب بيانات في الوقت الفعلي، مثل ميزانية الحملة الإعلانية المتبقية، من خدمة "المفتاح/القيمة" الخاصة بالمشتري.
  4. يحدِّد رمز البائع نتيجة كلّ عرض سعر ويختار الفائز. يستخدم هذا المنطق قيمة ال bid وبيانات أخرى لعرض مدى ملاءمة عروض الأسعار ورفض إعلان لا يمكنه التغلب على الإعلان الفائز بالسياق. يمكن للبائع استخدام خدمة مفتاح/قيمة الخاصة به للبيانات في الوقت الفعلي. قبل بدء المزاد، يعثر البائع على أفضل إعلان سياقي للمساحة الإعلانية المتاحة.
  5. يتم عرض الإعلان الفائز كعنصر إعداد إطار مُغلق عند ضبط العلامة resolveToConfig في إعدادات المزاد. يتم استخدام الإعدادات للتنقّل في الإطار المحدود إلى تصميم الإعلان، ويتم إخفاء عنوان URL لتصميم الإعلان عن كلّ من البائع والناشر. إذا تم ضبط العلامة resolveToConfig على false أو لم يتم تمريرها، يتم عرض الإعلان الفائز كعنوان URN غير شفاف يمكن استخدامه لعرض الإعلان في إطار iframe. يتوفّر عنصر إعداد الإطار المحدود بدءًا من الإصدار M114.
  6. يتم إبلاغ البائع والمشترين الفائزين بالمزاد.

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

ما هي خدمة المفتاح/القيمة في Protected Audience API؟

تسمح خدمة 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. سيتمّ الاستعلام عن خدمة Key/Value الخاصة بالبائع باستخدام عنوان URL لعرض تصميم الإعلان.

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

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

كيف يتم استخدام بيانات الطرف الأول في مزاد "شرائح الجمهور المحمية"؟

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

في مزاد "شريحة الجمهور المحمية"، يمكن للمعلِن استخدام بيانات الطرف الأول لتحديد عضوية مجموعة الاهتمامات الإعلانية، ويمكنه أيضًا تمرير البيانات إلى مجموعة الاهتمامات على أنّها 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.

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