تخصيص 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) الإعلانية من استخدام واجهة برمجة التطبيقات لهذا التطبيق:

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

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

See also

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