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

اطّلِع على كيفية تعديل بيانات الجمهور من خلال ضبط عنوان 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

API reference guides are available:

The Protected Audience API explainer also provides detail about feature support and constraints.