تعديل بيانات الجمهور وإعادة تحميل الإعلانات

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

ألست مطوّرًا؟ يُرجى الرجوع إلى نظرة عامة على Protected Audience API.

مجموعات الاهتمامات في Protected Audience API

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

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

وظائف واجهة برمجة التطبيقات

مثال على الاستخدام

في ما يلي المثال من الدليل حول كيفية تحديد بيانات الجمهور الذي يوضّح كيفية إنشاء مجموعة اهتمامات وطلب انضمام المتصفّح إلى المجموعة.

const interestGroup = {
  owner: 'https://dsp.example',
  name: 'custom-bikes',
  biddingLogicUrl: ...,
  biddingWasmHelperUrl: ...,
  updateUrl: ...,
  trustedBiddingSignalsUrl: ...,
  trustedBiddingSignalsKeys: ['key1', 'key2'],
  userBiddingSignals: {...},
  ads: [bikeAd1, bikeAd2, bikeAd3],
  adComponents: [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2],
};

navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);

يوفّر updateUrl عنوان URL يعرض JSON لتعديل سمات المجموعة ذات الاهتمامات المشتركة. يجب أن يكون لهذا العنصر المصدر نفسه الخاص بالعنصر owner.

تعديل السمات

تحدّد updateUrl خادم ويب يعرض JSON يحدّد خصائص المجموعة ذات الاهتمامات المشتركة، بما يتوافق مع عنصر المجموعة ذات الاهتمامات المشتركة الذي تم تمريره إلى joinAdInterestGroup().

يسمح هذا الإجراء لمالك المجموعة بتعديل سمات المجموعة باهتمامات مشتركة بشكل دوري. في التنفيذ الحالي، يمكن تغيير السمات التالية:

  • biddingLogicUrl
  • biddingWasmHelperUrl
  • trustedBiddingSignalsUrl
  • trustedBiddingSignalsKeys
  • ads
  • priority

لن تتم الكتابة فوق أي حقل غير محدّد في JSON، بل سيتم تعديل الحقول المحدّدة في JSON فقط، بينما يؤدي استدعاء navigator.joinAdInterestGroup() إلى الكتابة فوق أي مجموعة اهتمامات حالية.

تُجرى التحديثات بأقصى جهد ممكن، وقد يتعذّر إجراؤها في الحالات التالية:

  • انتهاء مهلة طلب الشبكة (30 ثانية حاليًا)
  • تعذُّر الاتصال بالشبكة لسبب آخر
  • تعذُّر تحليل ملف JSON

يتم وضع حدّ أقصى لعدد التعديلات المسموح بها، وهو تعديل واحد في اليوم.

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

تحديثات يدوية

يمكن تشغيل التعديلات على مجموعات الاهتمامات التي يملكها مصدر الإطار الحالي يدويًا باستخدام navigator.updateAdInterestGroups().

يمنع الحدّ الأقصى لعدد الطلبات إجراء التحديثات بشكل متكرر جدًا: لا تؤدي الطلبات المتكررة إلى navigator.updateAdInterestGroups() إلى أي شيء إلى أن تنتهي فترة الحدّ الأقصى لعدد الطلبات (يوم واحد حاليًا).

تتم إعادة ضبط الحدّ الأقصى لعدد الطلبات إذا تم استدعاء navigator.joinAdInterestGroup() مرة أخرى لمجموعة الاهتمامات نفسها owner وname.

التحديثات التلقائية

يتم تعديل جميع مجموعات الاهتمامات التي تم تحميلها للمزاد تلقائيًا بعد اكتمال المزاد، مع مراعاة حدود المعدّل نفسها التي تنطبق على التعديلات اليدوية.

بالنسبة إلى كل مالك لديه مجموعة اهتمامات واحدة على الأقل تشارك في مزاد، يكون الأمر كما لو تم استدعاء navigator.updateAdInterestGroups() من إطار iframe يتطابق مصدره مع هذا المالك.

جميع مراجع Protected Audience API

تتوفر الأدلة المرجعية لواجهة برمجة التطبيقات:

يوفّر الشرح في Protected Audience API أيضًا تفاصيل حول إتاحة الميزات والقيود المفروضة عليها.