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

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

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

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

يمكنك الرجوع إلى مسرد المصطلحات للاطّلاع على المصطلحات المستخدَمة في مستندات 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
مراحل نشاط Protected Audience API

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

مثال:

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

المشترين لديهم ثلاث وظائف:

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

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

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

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

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

آلية الإبلاغ عن خسارة المشترين قيد المناقشة.

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

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

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

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

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

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

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

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

لاستيفاء متطلبات الخصوصية في Protected Audience API، يتم تقديم البيانات في الوقت الفعلي المطلوبة خلال مزاد الإعلانات من خلال خدمة المفتاح/القيمة. عندما يتصل كل مشترٍ بـ navigator.joinAdInterestGroup()، يحدّد المشتري عنوان URL لخدمة المفتاح/القيمة ويحدّد المفاتيح التي سيتم الاستعلام عنها للخدمة أثناء المزاد. كذلك، عندما يجري البائع مزادًا للإعلانات من خلال استدعاء navigator.runAdAuction()، يقدّم البائع عنوان URL لخدمة المفتاح/القيمة. سيتم الاستعلام عن خدمة المفتاح/القيمة للبائع باستخدام عنوان 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 يقدّم جولة تفصيلية حول عملية نشر Protected Audience API الأساسية. يوضِّح الفيديو التوضيحي لـ Protected Audience API طريقة عمل الرمز التوضيحي كما يوضّح كيفية استخدام "أدوات مطوري البرامج في Chrome" لتصحيح الأخطاء في Protected Audience API.

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