‫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 على أنّه موضوع رصده المُطلِب B.
  • بحلول نهاية الحقبة، تُعدّل Topics API أهم مواضيع المستخدِم وتحدِّد المُتصلين الذين رصدوا هذه المواضيع استنادًا إلى نشاط المستخدِم.
  • لاحقًا، عندما يُجري المُتصل B طلبًا آخر من Topics API، يمكن أن يحصل على موضوع Home & Garden أو Sports/Tennis (أو موضوع عشوائي بنسبة% 5) لهذا المستخدم في صفيف الاستجابة.
  • لا يمكن للمتصل أ الوصول إلا إلى الموضوع Home & Garden، لأنّه لم يرصد الموضوع Sports/Tennis مطلقًا. وهذا يعني أنّ الجهة الخارجية لن تعرف سوى موضوع اهتمام المستخدم ضمن السياق المحدّد (التطبيق أو الموقع الإلكتروني) الذي يظهر فيه.
مخطّط بياني يوضّح أنّ Topics API لا تضع علامة على المواضيع على أنّها قيد المراقبة إلا إذا كان المتصلون متوفّرين في السياق
تضع Topics API علامة على المواضيع التي لاحظها فقط المتصلون الذين لديهم حضور في سياق هذه المواضيع. ولن يتمكّن المتصلون من الوصول إلا إلى المواضيع التي راقبوها.

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

تستنِد Topics إلى نشاط المستخدِم لتحديد المواضيع التي تهمّه. يتم اختيار المواضيع من تصنيف مفتوح المصدر محدّد مسبقًا. مرّة واحدة في كل حقبة، تُعدّل ميزة "المواضيع" أهم خمسة مواضيع للمستخدم والمتصلين الذين لاحظوها خلال الحقبة. يستنِد نموذج المصنِّف في Topics إلى نشاط المستخدم لتحديد المواضيع: اسم المضيف لزيارة صفحة ويب، ومعلومات التطبيق على 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. توفّر 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 النموذج V5 على 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 مواضيع للمستخدم في هذه الحقبة.

أهم موضوع المتصلون الذين يمكنهم التعرّف على الموضوع
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 بشكل أفضل.