Topics API: دليل الدمج

تم تصميم Topics API لنظام التشغيل Android لإتاحة الإعلانات التي تستهدِف الاهتمامات بدون الاعتماد على معرّفات مختلفة للتطبيقات.

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

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

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

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

هناك اعتبارات عالية المستوى عند تنفيذ الإعلانات التي تستهدف المهتمين باستخدام Topics API:

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

  • يعتمد المشترون والمعلِنون على جانب البيع: للحصول على المواضيع، يجب أن تكون التطبيقات وحِزم تطوير البرامج (SDK) التابعة للبيع بالتجزئة بارزة من خلال مراقبة Topics API لمدة حقبة واحدة على الأقل.

المصطلحات

  • المعلن: شركة تجذب المستخدمين من خلال شراء المستودع الإعلاني
  • الناشر: شركة تبيع مستودع إعلانات متاحًا بجانب المحتوى الخاص بها
  • المشتري (أو جهة الشراء): شركة تكنولوجيا الإعلان التي تسهّل على المعلنين شراء المساحة المتوفّرة للإعلانات
  • البائع (أو جهة البيع): شركة تكنولوجيا الإعلان التي تسهِّل على الناشرين بيع المساحة المتوفّرة للإعلانات
  • الشبكة: شركة لتكنولوجيا الإعلانات تعمل كمشتري وبائع
  • مملوكة وتحت إدارة: شركة تعمل كناشر وبائع ومشتري

الأهداف

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

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

لجميع تقنيات الإعلان

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

لتقنيات الإعلانات من جهة البيع

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

لتقنيات الإعلانات من جهة الشراء

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

المتطلّبات الأساسية والإعداد

على مطوّري التطبيقات والبائعين والمشترين اتّباع هذه الخطوات لبدء استخدام Topics API.

التعرف على واجهة برمجة التطبيقات

  1. ابدأ بقراءة اقتراح التصميم للتعرّف على Topics API وإمكاناتها.
  2. اقرأ دليل المطوِّر لمعرفة طريقة دمج الرموز البرمجية وطلبات البيانات من واجهة برمجة التطبيقات التي تحتاجها لحالات الاستخدام.
  3. راجِع التصنيف وقدِّم ملاحظات عن المواضيع التي تم تضمينها في القائمة.
  4. أرسِل الملاحظات المتعلقة باقتراح التصميم أو المستندات.
  5. الاشتراك لتلقّي آخر الأخبار حول Topics API سيساعدك هذا في البقاء على اطلاع دائم بالميزات الجديدة التي سيتم تقديمها في الإصدارات المستقبلية.

إعداد نموذج التطبيق واختباره

  1. اتّبِع التعليمات الواردة في هذه الصفحة لإعداد "مبادرة حماية الخصوصية" على حزمة تطوير البرامج (SDK) لنظام التشغيل Android في "استوديو Android".
  2. يمكنك إجراء شوكة وتشغيل الرمز في إصدار Java أو Kotlin من نموذج التطبيق للتعرّف على كيفية استرداد المواضيع على الجهاز.
  3. أثناء الاختبار، يمكنك تجربة معلومات التطبيق في ما يتعلّق بالاسم والوصف لتغيير المواضيع التي سيتم عرضها في المصنِّف على الجهاز فقط.
  4. بعد أن تفهم آلية عمل واجهة برمجة تطبيقات العميل والتصنيفات على الجهاز، يمكنك استخدام نموذج التطبيق كمثال لتوجيه عملية الدمج.

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