نظرة عامة على Topics API for Mobile

تعرَّف على 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 إعلان-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 إعلان-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 بشكل أفضل.