تعرَّف على كيفية تحديد شريحة جمهور من خلال إنشاء مجموعة اهتمامات باستخدام Protected Audience API. يمكنك الاطّلاع على دليل المطوّرين للتعرّف على دورة الحياة الكاملة لواجهة Protected Audience API، والرجوع إلى شرح Protected Audience API للاطّلاع على اقتراح مفصّل حول كيفية تسجيل المتصفّحات لمجموعات الاهتمامات.
ألست مطوّرًا؟ يُرجى الرجوع إلى نظرة عامة على Protected Audience API.
مجموعات الاهتمامات في Protected Audience API
تمثّل مجموعة الاهتمامات في Protected Audience API مجموعة من الأشخاص الذين لديهم اهتمام مشترك، ويتوافق ذلك مع قائمة تجديد النشاط التسويقي. لكل مجموعة اهتمامات في Protected Audience API مالك.
يعمل مالكو المجموعات ذات الاهتمامات المشتركة كمشترين في مزاد الإعلانات على Protected Audience API. يخزِّن المتصفّح معلومات العضوية في المجموعات ذات الاهتمامات المشتركة على جهاز المستخدم، ولا تتم مشاركتها مع موفِّر المتصفّح أو أي شخص آخر.
وظائف واجهة برمجة التطبيقات
joinAdInterestGroup()
تطلب منصة عرض الطلب (DSP) التابعة للمعلِن أو المعلِن نفسه من المتصفّح إضافة مجموعة اهتمامات إلى قائمة العضوية في المتصفّح من خلال استدعاء navigator.joinAdInterestGroup().
يجب أن يتطابق مصدر سياق الاتصال الخاص بالدالة joinAdInterestGroup() مع مصدر مالك المجموعة باهتمامات مشتركة، لذا يجب استدعاء الدالة joinAdInterestGroup() من إطار iframe (على سبيل المثال، من وسيط عرض الطلب) ما لم يتطابق مصدر مالك المجموعة باهتمامات مشتركة مع مصدر المستند الحالي (على سبيل المثال، موقع إلكتروني يتضمّن مجموعات باهتمامات مشتركة خاصة به).
يتطلّب joinAdInterestGroup() الحصول على إذن من:
- الموقع الإلكتروني الذي تتم زيارته
- مالك المجموعة ذات الاهتمامات المشتركة
وهذا يعني أنّه لا يمكن لـ malicious.example طلب joinAdInterestGroup() لمجموعة اهتمامات تملكها dsp.example.com، بدون أن تمنح dsp.example.com الإذن بذلك.
إذن من الموقع الإلكتروني الذي تمت زيارته
يمكن منح الإذن من المصدر نفسه أو من مصادر متعددة. يتم تلقائيًا منح الإذن بإجراء طلبات joinAdInterestGroup() من المصدر نفسه الذي تم منه الانتقال إلى الموقع الإلكتروني (أي من المصدر نفسه الذي تم منه الانتقال إلى الإطار ذي المستوى الأعلى في الصفحة الحالية).
مثال على الاستخدام
في ما يلي مثال على كيفية تحديد مجموعة باهتمامات مشتركة وطلب الانضمام إليها من المتصفّح.
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);
يجب ألا يتجاوز حجم الكائن interestGroup الذي تم تمريره إلى الدالة 50 كيلوبايت، وإلا سيتعذّر تنفيذ الطلب. تحدّد المَعلمة الثانية مدة المجموعة ذات الاهتمامات المشتركة، بحد أقصى 30 يومًا. تؤدي عمليات الاستدعاء المتتالية إلى استبدال القيم المخزّنة سابقًا.
الخصائص المطلوبة
السمتان المطلوبتان فقط لمجموعات الاهتمامات هما owner وname:
| الموقع | مثال | الدور |
|---|---|---|
owner |
https://dsp.example |
تمثّل هذه السمة مصدر مالك مجموعة الاهتمامات. |
name |
custom-bikes |
اسم مجموعة الاهتمامات. |
السمات الاختيارية
الخصائص المتبقية اختيارية:
biddingLogicUrl1، 2- مثال:
https://dsp.example/bid/custom-bikes/bid.js - الدور: عنوان URL لرمز JavaScript الخاص بالمزايدة الذي يتم تنفيذه في وحدة عمل.
biddingWasmHelperUrl1، 2- مثال:
https://dsp.example/bid/custom-bikes/bid.wasm - الدور: عنوان URL لرمز WebAssembly يتم تشغيله من
biddingLogicUrl. updateUrl2- مثال:
https://dsp.example/bid/custom-bikes/update - الدور: عنوان URL يعرض JSON لتعديل سمات مجموعة الاهتمامات. (راجِع تعديل بيانات الجمهور وإعادة تحميل الإعلانات).
trustedBiddingSignalsUrl2- مثال:
https://dsp.example/trusted/bidding-signals - الدور: عنوان URL الأساسي لطلبات المفتاح/القيمة إلى خدمة المفتاح/القيمة الموثوقة الخاصة مقدّم عروض الأسعار.
trustedBiddingSignalsKeys- مثال:
['key1', 'key2' ...] - الدور: مفاتيح الطلبات إلى خدمة المفتاح/القيمة الموثوقة.
userBiddingSignals- مثال:
{...} - الدور: بيانات وصفية إضافية يمكن للمالك استخدامها أثناء تقديم عروض الأسعار.
ads1- مثال:
[bikeAd1, bikeAd2, bikeAd3] - الدور: الإعلانات التي قد يتم عرضها لهذه المجموعة ذات الاهتمامات المشترَكة
adComponents- مثال:
[customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2] - الدور: مكوّنات الإعلانات التي تتألف من أجزاء متعددة
1 السمتان biddingLogicUrl وads اختياريتان، ولكنّهما ضروريتان للمشاركة في مزاد. قد تكون هناك حالات استخدام لإنشاء مجموعة اهتمامات بدون هذه الخصائص: على سبيل المثال، قد يريد مالك مجموعة اهتمامات إضافة متصفّح إلى مجموعة اهتمامات لحملة لم يتم إطلاقها بعد، أو لاستخدام آخر في المستقبل، أو قد يكون قد نفد مؤقتًا من ميزانية الإعلان.
2 في التنفيذ الحالي لواجهة Protected Audience API، يجب أن يكون لكل من biddingLogicUrl وbiddingWasmHelperUrl وupdateUrl وtrustedBiddingSignalsUrl المصدر نفسه كمالك. قد لا يكون هذا القيد طويل الأمد، ولا ينطبق على عناوين URL الخاصة بـ ads وadComponents.
تحديد إعلانات لمجموعة اهتمامات
يتضمّن العنصران ads وadComponents عنوان URL لتصميم إعلان، ويمكنهما اختياريًا تضمين بيانات وصفية عشوائية يمكن استخدامها أثناء تقديم عروض الأسعار.
على سبيل المثال:
{
renderUrl: 'https://cdn.example/.../bikeAd1.html',
metadata: bikeAd1metadata // optional
}
leaveAdInterestGroup()
يمكن لمالك مجموعة الاهتمامات أن يطلب إزالة متصفّح من مجموعة الاهتمامات. يزيل المتصفّح مجموعة الاهتمامات من قائمة العضوية.
navigator.leaveAdInterestGroup({
owner: 'https://dsp.example',
name: 'custom-bikes'
});
إذا عاد المستخدِم إلى الموقع الإلكتروني الذي طلب من المتصفّح إضافة مجموعة اهتمامات، يمكن لمالك مجموعة الاهتمامات استدعاء الدالة navigator.leaveAdInterestGroup() لطلب إزالة مجموعة الاهتمامات من المتصفّح.
يمكن أن يستدعي رمز الإعلان أيضًا هذه الدالة لمجموعة الاهتمامات.
الأسئلة الشائعة
ما هو الحدّ الأقصى لعدد مجموعات الاهتمامات لكل مالك مجموعة لمستخدم واحد؟
يسمح Chrome بما يصل إلى 1,000 مجموعة باهتمامات مشتركة لكل مالك، وما يصل إلى 1,000 مالك لمجموعات باهتمامات مشتركة. تهدف هذه الحدود إلى توفير حماية، وليس إلى بلوغها في التشغيل العادي.
كيف يمكنني زيادة عدد الإعلانات المستندة إلى الاهتمامات التي تستوفي حدود 𝑘-anon؟
كما يوضّح الشرح التوضيحي العلني، بما أنّ مجموعة اهتمامات واحدة يمكن أن تتضمّن إعلانات متعدّدة محتملة قد تعرضها، ستتاح للمجموعة فرصة إعادة تقديم عروض أسعار لإعلان آخر من إعلاناتها ليعمل كـ "إعلان احتياطي" في أي وقت يكون فيه خيارها الأكثر تفضيلاً أقل من الحدّ الأدنى. وهذا يعني أنّه يمكن لإعلان صغير ومتخصّص لا يزال أقل من حدّ 𝑘-anonymity أن يشارك في المزادات، ويمكن لمجموعة الاهتمامات التابعة له أن تعود إلى إعلان أكثر عمومية إلى أن يحصل الإعلان الأكثر تخصّصًا على عدد كبير بما يكفي من الجمهور.
من منظور تكتيكي، يمكنك مراعاة ما يلي:
- لبدء عرض إعلان جديد، ما عليك سوى البدء في تقديم عروض أسعار له في الحالات التي تريد عرضه فيها. ليس عليك اتّخاذ أي إجراء إضافي.
- يمكنك عرض إعلان احتياطي عندما لا تكون الإعلانات الجديدة مجهولة الهوية بمقدار 𝑘. هناك بعض المخاطر من عدم استيفاء الإعلان الاحتياطي نفسه لشرط عدم الكشف عن الهوية بمقدار 𝑘، لذا يمكنك التفكير في تقديم عروض أسعار باستخدام الإعلان الاحتياطي في المقام الأول في بعض الأحيان. يمكنك إجراء ذلك بنسبة% 1 من الوقت، على سبيل المثال، إذا كان هذا المستوى مناسبًا لضمان بقاء القيمة الاحتياطية فوق الحدّ.
لقد تمّت مؤخرًا مناقشة بعض الطرق الأخرى التي يمكن أن تعمل بها هذه الميزة، لذا إذا كان لديك بعض حالات الاستخدام التي قد تسبّب فيها هذه الآلية مشكلة، يمكنك مواصلة المشاركة في المحادثة العامة حول الطرق التي يمكن من خلالها تحسين واجهة برمجة التطبيقات.
جميع مراجع Protected Audience API
تتوفر الأدلة المرجعية لواجهة برمجة التطبيقات:
- دليل المطوّرين حول Protected Audience API
- دليل مشتري الإعلانات حول مجموعات الاهتمامات وإنشاء عروض الأسعار للجمهور المحمي.
- دليل بائع الإعلانات حول مزادات الإعلانات للجمهور المحمي
- دليل إعداد التقارير عن نتائج المزادات
- أفضل ممارسات وقت استجابة مزاد الإعلانات للجمهور المحمي
- تحديد المشاكل في الجمهور المحمي وحلّها
يوفّر الشرح في Protected Audience API أيضًا تفاصيل حول إتاحة الميزات والقيود المفروضة عليها.