Personalização e desativação da API Topics

Os usuários e desenvolvedores precisam poder ajustar a API Topics para melhorar a relevância do conteúdo. Esta página é um guia sobre como gerenciar e personalizar a API Topics para atender às preferências e necessidades dos usuários e dos desenvolvedores.

Controles de usuário

O design da API tem como objetivo permitir que os usuários acessem e removam os temas associados ao uso do app. A implementação desse recurso de controle do usuário está em andamento e será incluída em uma atualização futura.

Se o usuário desinstalar um app que contribuiu para a seleção de um tema inferido nas últimas três épocas, esse tema não vai ser removido da lista de temas retornados nessas épocas, a fim de evitar a divulgação de informações sobre a desinstalação.

Para facilitar os testes relacionados à experiência do usuário, os desenvolvedores podem iniciar uma intent no app para conferir a interface de configurações de temas da mesma forma que um usuário 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);
            }
        });
}

Controles do desenvolvedor

Os desenvolvedores de apps podem gerenciar quais desenvolvedores de adtech podem acessar as APIs Topics incluindo o ID de registro do desenvolvedor de adtech no manifesto do app.

Um app pode desativar de maneira declarativa a API Topics usando novos elementos de manifesto e XML para impedir que os SDKs de anúncios usem a API nele:

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

Os temas associados a apps desativados não contribuem para o cálculo semanal de temas. Este documento vai ser atualizado para incluir detalhes de implementação relacionados.

See also

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