Personalizzazione e disattivazione dell'API Topics

Utenti e sviluppatori dovrebbero essere in grado di perfezionare l'API Topics per migliorare la pertinenza dei contenuti. Questa pagina è una guida su come gestire e personalizzare l'API Topics in base alle preferenze e alle esigenze degli utenti e degli sviluppatori.

Controlli utente

La progettazione dell'API intende fornire agli utenti la possibilità di visualizzare e rimuovere gli argomenti associati all'utilizzo dell'app. L'implementazione di questa funzionalità di controllo degli utenti è ancora in fase di sviluppo e verrà inclusa in un aggiornamento futuro.

Se l'utente disinstalla un'app che ha contribuito alla selezione di un argomento dedotto nelle ultime tre epoche, l'argomento non verrà rimosso dall'elenco degli argomenti restituiti nelle ultime tre epoche, per evitare di divulgare informazioni sulla disinstallazione.

Per facilitare i test relativi all'esperienza dell'utente finale, gli sviluppatori possono avviare un intent in-app per visualizzare l'UI delle impostazioni di Topics, in modo simile a come la vedrebbe un utente finale:

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

Controlli per gli sviluppatori

Gli sviluppatori di app possono gestire gli sviluppatori di tecnologia pubblicitaria che possono accedere alle API Topics includendo l'ID registrazione dello sviluppatore di tecnologia pubblicitaria all'interno del manifest dell'app.

Un'app può disattivare in modo dichiarativo l'API Topics tramite nuovi elementi manifest e XML per impedire agli SDK pubblicitari di utilizzare l'API per l'app:

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

Gli argomenti associati alle app per le quali è stata disattivata la funzionalità non contribuiscono al calcolo settimanale degli argomenti. Questo documento verrà aggiornato per includere i dettagli di implementazione correlati.

See also

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