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

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

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

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

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

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

//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 للإعلانات من استخدام واجهة برمجة التطبيقات لهذا التطبيق. ولن تساهم المواضيع المرتبطة بالتطبيقات التي تم إيقافها في احتساب المواضيع الأسبوعي. سيتم تعديل هذا المستند ليشمل تفاصيل التنفيذ ذات الصلة.

See also

Check out our resources to better understand the Topics API on Android.