Personnalisation et désactivation de l'API Topics

Les utilisateurs et les développeurs doivent pouvoir affiner l'API Topics pour améliorer la pertinence des contenus. Cette page explique comment gérer et personnaliser l'API Topics en fonction des préférences et des besoins des utilisateurs et des développeurs.

Contrôle utilisateur

La conception de l'API vise à permettre aux utilisateurs d'afficher et de supprimer les thèmes associés à l'utilisation de l'application. La mise en œuvre de cette fonctionnalité de contrôle utilisateur est en cours d'élaboration et sera incluse dans une prochaine mise à jour.

Si l'utilisateur désinstalle une application qui a contribué à la sélection d'un thème déterminé au cours des trois dernières epochs, ce thème ne sera pas supprimé de la liste des thèmes renvoyés pour les trois dernières epochs, afin d'éviter de divulguer des informations sur la désinstallation.

Pour faciliter le test de l'expérience utilisateur, les développeurs peuvent lancer un intent dans l'application afin d'afficher l'UI des paramètres de Topics de la même manière qu'un utilisateur final :

//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);
            }
        });
}

Commandes du développeur

Les développeurs d'applications peuvent gérer quels développeurs de technologie publicitaire peuvent accéder aux API Topics en incluant leur ID d'inscription dans le fichier manifeste de l'application.

Une application peut désactiver l'API Topics de manière déclarative via de nouveaux éléments manifestes et XML, afin d'empêcher les SDK publicitaires d'utiliser l'API pour cette application :

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

Les thèmes associés aux applications désactivées ne sont pas pris en compte dans le calcul hebdomadaire des thèmes. Ce document sera mis à jour pour inclure les détails d'implémentation associés.

See also

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