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

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