تخصيص Topics API وإيقافها

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

عناصر تحكم المستخدم

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

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

لتسهيل اختبار تجربة المستخدم النهائي، يمكن للمطوّرين تشغيل هدف داخل التطبيق لعرض واجهة مستخدم الإعدادات الخاصة بميزة "المواضيع" بطريقة مشابهة لما يراه المستخدم النهائي:

//Button that launches settings UI
private Button mSettingsAppButton;
private static final String RB_SETTING_APP_INTENT = "android.adservices.ui.SETTINGS";

//Does setup for button on screen that will launch settings UI to observe Topics
private void registerLaunchSettingsAppButton() {
    mSettingsAppButton.setOnClickListener(
        new View.OnClickListener() {

            @Override
            public void onClick(View view) {
                Context context = getApplicationContext();
                Intent activity2Intent = new Intent(RB_SETTING_APP_INTENT);
                activity2Intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
                context.startActivity(activity2Intent);
            }
        });
}

عناصر التحكّم للمطوّرين

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

يمكن لأي تطبيق إيقاف Topics API بشكلٍ إعلاني من خلال عناصر جديدة في ملف البيان وملف XML، وذلك لمنع حِزم SDK للإعلانات من استخدام واجهة برمجة التطبيقات لهذا التطبيق:

<ad-services-config>
  <topics allowAllToAccess="false" />
</ad-services-config>

لن تساهم المواضيع المرتبطة بالتطبيقات التي تم إيقاف ميزة "المواضيع الرائجة" فيها في احتساب المواضيع الأسبوعية. سيتم تعديل هذا المستند ليشمل تفاصيل التنفيذ ذات الصلة.

انظر أيضًا

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