‫Topics API للأجهزة الجوّالة: نظرة عامة

تعرَّف على واجهة برمجة التطبيقات Topics API على Android والخطوات المطلوبة لتنفيذها. يمكنك أيضًا الانتقال مباشرةً إلى تنفيذ المواضيع.

آلية عمل Topics API

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

المفاهيم الرئيسية

  • الموضوع هو موضوع يهمّ المستخدم الحالي ويمكن لشخص عادي قراءته، وهو جزء من تصنيف المواضيع.
  • المُرسِل هو كيان، مثل تطبيق أو حزمة تطوير برامج (SDK) تابعة لجهة خارجية أو موقع إلكتروني أو خدمة، يُرسِل طلبًا إلى Topics API لمراقبة اهتمامات المستخدم أو الوصول إليها.
  • يرصد المُتصل موضوعًا إذا أرسل طلبًا إلى Topics API من صفحة ويب أو تطبيق مرتبطَين بهذا الموضوع خلال الفترات الثلاث الماضية.
  • الفاصل الزمني هو فترة احتساب المواضيع، ويكون تلقائيًا أسبوعًا واحدًا.
  • التصنيف هو قائمة هرمية للفئات، تشمل على سبيل المثال فئات مثل /Arts & Entertainment/Music & Audio/Soul & R&B و/Business & Industrial/Business Services/Corporate Events.
  • يتمّ اشتقاق المواضيع باستخدام نموذج تصنيف يربط نشاط المستخدِم بمواضيع معدومة أو أكثر.

الخطوات الأساسية لمسار Topics API

تتضمّن دورة حياة Topics API ثلاث خطوات رئيسية:

  • مراقبة نشاط المستخدم، مثل زيارته لصفحة الويب https://cats.example/tabby/index.html أو تنزيل التطبيق cats
  • استنباط المواضيع من نشاط المستخدِم، على سبيل المثال /Pets & Animals/Pets/Cats
  • الوصول إلى المواضيع التي تم رصدها سابقًا للمستخدم، على سبيل المثال، كإشارة لاختيار إعلانات ذات صلة (مثل إعلان ترويجي لطعام القطط)

مراقبة المواضيع

لا يمكن للمتصلين الوصول إلا إلى المواضيع التي تهمّهم والتي لاحظوها. يرصد المُتصل موضوعًا عند إرسال طلب إلى Topics API من سياق مرتبط بهذا الموضوع. لتوضيح هذا المفهوم، راجِع المثال المبسّط التالي.

  • لنفترض أنّ هناك اثنين من مستخدمي Topics API: أ وب.
  • هناك سياقان:
    • Greenhouse، على سبيل المثال، تطبيق باسم Greenhouse أو موقع إلكتروني greenhouse.example، مرتبط بالموضوع Home & Garden.
    • تمارين التنس، على سبيل المثال تطبيق باسم "تمارين التنس" أو موقع إلكتروني tennis.example، مرتبط بالموضوع Sports/Tennis
  • يُشار إلى كل من المتصلَين أ وب في سياق Greenhouse.
  • لا يظهر سوى المتصل ب في سياق تمارين التنس.
  • لنفترض أنّه لم يتم رصد أي مواضيع للمستخدم قبل الحقبة 1، وذلك للتبسيط.
  • يزور المستخدم تطبيق Greenhouse، ويُجري المُتصلان أ وب طلبًا إلى Topics API لتسجيل زيارة المستخدم إلى الصفحة أو التطبيق (اطّلِع على دليل التنفيذ المقترَح في الخطوات التالية لمعرفة كيفية طلب Topics API). ويتم استخدام هذا السجلّ (اسم مضيف أو بيانات التطبيق) لاحقًا لاستخراج المواضيع التي تهمّك. ستضع واجهة برمجة التطبيقات Topics API لاحقًا علامة على الموضوع Home & Garden على أنّه موضوع رصده كل من المتصلَين أ وب.
  • يزور المستخدم تطبيق تمارين التنس. ولا يرسل سوى المُتصل ب طلبًا إلى Topics API. ستضع واجهة برمجة التطبيقات Topics API لاحقًا علامة على الموضوع Sports/Tennis على أنّه موضوع رصده المُتصل ب.
  • بحلول نهاية الحقبة، تُعدّل Topics API أهم مواضيع المستخدم وتحدّد المُتصلين الذين رصدوا هذه المواضيع استنادًا إلى نشاط المستخدم.
  • لاحقًا، عندما يُجري المُتصل ب طلبًا آخر من Topics API، يمكن أن يحصل على موضوع Home & Garden أو Sports/Tennis (أو موضوع عشوائي بنسبة% 5) لهذا المستخدم في صفيف الاستجابة.
  • لا يمكن للمتصل أ الوصول إلا إلى الموضوع Home & Garden، لأنّه لم يرصد الموضوع Sports/Tennis مطلقًا. وهذا يعني أنّ الجهة الخارجية لن تعرف عن موضوع اهتمام المستخدم إلا في السياق المحدّد (التطبيق أو الموقع الإلكتروني) الذي يظهر فيه.
مخطّط بياني يوضّح أنّ Topics API لا تضع علامة على المواضيع على أنّها قيد المراقبة إلا إذا كان المتصلون متوفّرين في السياق
تضع Topics API علامة على المواضيع التي لاحظها فقط المتصلون الذين لديهم حضور في سياق هذه المواضيع. ولن يتمكّن المتصلون من الوصول إلا إلى المواضيع التي راقبوها.

استخراج المواضيع

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

وصول المتصل إلى المواضيع التي تهمّ المستخدم

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

الفترات

يجب أن تضمن واجهة برمجة التطبيقات Topics API أنّ المواضيع التي تهمّك يتم تعديلها باستمرار. يتم استنتاج المواضيع للمستخدم استنادًا إلى نشاطه خلال فترة زمنية تُعرَف باسم "الحقبة"، والتي تكون أسبوعًا واحدًا تلقائيًا. يكون لكل مستخدم فترات تدريب خاصة به (تكون الفترات التدريبية "لكل مستخدم") ويتم اختيار وقت البدء الأولي بشكل عشوائي.

بعد كل حقبة، تحسب Topics API أهم خمسة مواضيع للمستخدم وتحدّد المتصلين الذين لاحظوا هذه المواضيع باستخدام المعلومات على الجهاز فقط. يتم اختيار موضوع كل حقبة بشكل عشوائي من بين أهم خمسة مواضيع للمستخدم في هذه الفترة الزمنية. لتعزيز الخصوصية بشكل أكبر وضمان تمثيل جميع المواضيع، هناك احتمال بنسبة% 5 أن يتم اختيار الموضوع عشوائيًا من بين جميع المواضيع المحتملة في تصنيف الاهتمامات.

استخدام ميزة "المواضيع" على Android

تم تصميم Topics API على Android لتتوافق مع حِزم SDK لعرض الإعلانات التابعة لجهات خارجية والتي تعمل عادةً على مستوى تطبيقات متعددة. توفّر Topics للمتصلين مواضيع إعلانية عامة ذات اهتمامات استنادًا إلى استخدام المستخدم للتطبيق، بدون الاعتماد على المعرّفات على مستوى التطبيقات. ويمكن استخدام هذه المواضيع لتكملة أي معلومات سياقية ذات صلة بالتطبيق الذي يريد عرض إعلان، ويمكن دمجها للمساعدة في اختيار إعلان مناسب للمستخدم.

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

يُرجى الرجوع إلى دليل تنفيذ Topics API للحصول على عيّنات رموز برمجية توضّح كيفية إعداد إمكانية جلب المواضيع للإعلانات المستندة إلى الاهتمامات.

دمج المواضيع حسب نوع النشاط التجاري

فعِّل الإعلانات التي تستهدف الاهتمامات باستخدام Topics API. اتّبِع الخطوات استنادًا إلى نوع نشاطك التجاري في مجال تكنولوجيا الإعلان لدمج Topics API والاستعداد للإطلاق.

لجميع تكنولوجيات الإعلان

  • راجِع تصنيف المواضيع وقدِّم ملاحظاتك.
  • جرِّب عيّنات التطبيقات التي تستخدم Topics API لمعرفة البيانات التي يتم عرضها من خلال الموضوعات من خلال أداة التصنيف على الجهاز.
  • عدِّل مسارات التطبيق وحزمة SDK لبدء الاتصال بواجهة برمجة التطبيقات Topics API.
  • عدِّل البروتوكولات لبدء إرسال المواضيع في طلبات الإعلانات.
  • تسجيل تكنولوجيا الإعلان في "مبادرة حماية الخصوصية"

بالنسبة إلى تكنولوجيات الإعلان من جهة البيع

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

بالنسبة إلى تكنولوجيات الإعلان من جهة الشراء

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

كيفية استنتاج واجهة برمجة التطبيقات للمواضيع المتعلّقة بالتطبيق

على نظام التشغيل Android، تستنتج Topics API مواضيع التطبيق استنادًا إلى معلومات التطبيق، وذلك باستخدام نموذج تصنيف. في التنفيذ الحالي، تستخدم Topics أسماء التطبيقات والحِزم لتحديد المواضيع التي تهمّ المستخدمين لتطبيق معيّن، ولكن قد يتم توسيع نطاق ذلك لاحقًا ليشمل معلومات أخرى، مثل وصف التطبيق.

أداة تصنيف المواضيع

يتم استخراج المواضيع التي تهمّك من نموذج تصنيف تم تدريبه على معلومات التطبيق المتاحة للجميع.

  • عند استخدام نموذج التصنيف للاستنتاج من أجل احتساب المواضيع لفترة زمنية معيّنة، تبقى مجموعة الإشارات المستخدَمة على الجهاز. قد تتضمّن هذه المجموعة من الإشارات التطبيقات المثبّتة أو المستخدَمة مؤخرًا، وقد يتم توسيع نطاقها لاحقًا لتشمل إشارات أخرى.
  • درّبت Google الإصدار 5 من النموذج باستخدام 540,000 معلومة متاحة للجميع عن التطبيقات تم تصنيفها يدويًا و17 مليون معلومة تم تصنيفها باستخدام الذكاء الاصطناعي من متاجر التطبيقات، مثل "متجر Google Play". يستخدم النموذج أسماء التطبيقات وأسماء الحِزم كإشارات إدخال، وهو متاح مجانًا لمطوّري التطبيقات لاختباره والاطّلاع على المواضيع التي يصنف تطبيقاتهم ضمنها.
  • من الممكن أن يتم ربط التطبيق بأكثر من موضوع واحد أو بعدم ربطه بأي مواضيع أو عدم إضافته إلى سجلّ المواضيع الخاص بالمستخدم. في حال ربط تطبيق بأكثر من موضوع واحد في التصنيف، سيتم اقتصار عدد المواضيع التي يتم اختيارها لهذا التطبيق على أهم ثلاثة مواضيع.

لفهم آلية عمل نموذج التصنيف بشكل أفضل، يمكنك اختبار مدى تأثير بيانات التطبيقات المختلفة في التصنيف باستخدام نموذج تصنيف مواضيع Android في Colab.

التصنيف

يتم اختيار المواضيع من تصنيف مفتوح المصدر محدّد مسبقًا. التصنيف متاح للجميع، وهو عرضة للتغيير. يمكن إرسال الاقتراحات باستخدام زر الملاحظات في أعلى هذه الصفحة. يتم تنظيم هذا التصنيف من قِبل فريقنا كي لا تكون المواضيع الحسّاسة جزءًا منه. وسيتم تصميمه ليناسب فئات الإعلانات التي يمكن عرضها على التطبيقات المتوافقة مع الأجهزة الجوّالة على Android.

استخدام ميزة "المواضيع" على Android

لنفترض أنّ أحد المستخدمين لديه سبعة تطبيقات مثبّتة على الجهاز: "أ" و"ب" و"ج" و"د" و"هـ" و"و" و"ز". لنفترض أنّ تصنيف المواضيع للتطبيق وحِزم تطوير البرامج (SDK) لتكنولوجيا الإعلان في هذه التطبيقات هو على النحو التالي:

التطبيق تصنيف المواضيع حزمة تطوير البرامج (SDK) لتكنولوجيا الإعلان
A T1 وT5 ad-sdk1، ad-sdk2
B T2 ad-sdk2
C ‫T3 وT6 ad-sdk3 وad-sdk4
D T1 وT4 ad-sdk1
E T5 ad-sdk4 وad-sdk5
F T6 ad-sdk2 وad-sdk3 وad-sdk4
G T7 ad-sdk2

نهاية الأسبوع الأول: تنشئ Topics API أهم 5 مواضيع للمستخدم خلال هذه الحقبة.

Top Topic المتصلون الذين يمكنهم الاطّلاع على الموضوع
T1 ad-sdk1، ad-sdk2
T2 ad-sdk2
T3 ad-sdk3 وad-sdk4
T4 ad-sdk1
T5 ad-sdk1 وad-sdk2 وad-sdk4 وad-sdk5

في الأسبوع الثاني، إذا طلب أحد المتصلين في أي تطبيق واجهة برمجة التطبيقات، لن تتضمّن قائمة المواضيع المعروضة سوى المواضيع التي يكون فيها المتصل مدرَجًا في عمود "المتصلون الذين يمكنهم الاطّلاع على الموضوع" لهذا الموضوع في هذا التطبيق خلال هذه الحقبة.

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

إذا لم يكن هناك استخدام كافٍ للتطبيق ليتمكّن من استنتاج خمسة مواضيع، قد تأخذ المنصة في الاعتبار خيارات مثل إنشاء المواضيع المتبقية بشكل عشوائي.

تشفير المواضيع المعروضة

على منصات تكنولوجيا الإعلان المسجّلة التي تستدعي Topics API أيضًا تقديم مفاتيح التشفير لضمان أنّ المواضيع المعروضة لا يمكن لأحد قراءتها إلا للمستدعي.

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

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

الخطوات التالية

اطّلِع على تفاصيل التنفيذ وعينات الرموز البرمجية التي يمكن للمتصلين من خلالها مراقبة المواضيع والوصول إليها.
تعرَّف على كيفية إدارة المستخدمين والمطوّرين لواجهة Topics API وتخصيصها بما يناسب الإعدادات المفضّلة للمستخدمين واحتياجاتهم.

انظر أيضًا

يمكنك الاطّلاع على مراجعنا لفهم Topics API على Android بشكل أفضل.