نظرة عامة على Protected Audience API

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

مَن هم المستخدمون المعنيّون بهذا المستند؟

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

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

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

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

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

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

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

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

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

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

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

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

مزيد من المعلومات عن تقارير مزاد Protected Audience

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

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

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

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

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

  • يوضّح دليل المطوّرين لواجهة Protected Audience API كيفية استخدام واجهة برمجة التطبيقات وكيفية إجراء الاختبارات محليًا.

  • يقدّم الموقع الإلكتروني protected-audience-demo.web.app شرحًا تفصيليًا لعملية نشر أساسية لواجهة Protected Audience API على المواقع الإلكترونية الخاصة بالمعلِنين والناشرين. يشرح الفيديو التوضيحي حول 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؟ يُرجى الرجوع إلى مسرد مصطلحات "مبادرة حماية الخصوصية".

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

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

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

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

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

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

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

يسمح Chrome بما يصل إلى 1000 مجموعة اهتمامات لكل مالك، وما يصل إلى 1000 مالك لمجموعات الاهتمامات. تهدف هذه الحدود إلى توفير حماية، وليس إلى بلوغها في التشغيل العادي.

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

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

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

  • المعلِن: الذي يعمل لحسابه الخاص
  • وسيط عرض الطلب (DSP): يعمل لصالح المعلِنين.
  • مالك مجموعة الاهتمامات: يعمل لصالح معلِنين متعدّدين.

لدى المشترين ثلاث مهام:

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

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

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

  • عنوان 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

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

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

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

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

نناقش حاليًا آلية إعداد تقارير عن المشترين الذين لم يعودوا يتسوّقون.

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

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

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

كيف يتم استخدام بيانات الطرف الأول في مزاد Protected Audience؟

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

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

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