Topics API 自訂和停用

使用者和開發人員應可微調 Topics API,以改善內容的相關性。本頁內容說明如何管理及自訂 Topics API,符合使用者和開發人員的偏好和需求。

使用者控制項

這項 API 設計的宗旨,是要讓使用者能夠查看和移除與自己的應用程式使用情形相關聯的主題。這項使用者控制功能的實作方式仍在開發階段,相關資訊將於日後更新時提供。

如果使用者解除安裝某個應用程式,但系統在過去 3 個週期中因為該應用程式而選取了某個推斷出的主題,則該主題不會從針對過去 3 個週期傳回的主題清單中移除,這是為了避免揭露與解除安裝事件相關的資訊。

為了進行使用者體驗測試,開發人員可以啟動應用程式內意圖,以便查看主題的設定使用者介面,就像使用者看到的畫面:

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

開發人員控制項

應用程式開發人員可在應用程式資訊清單中加入廣告技術開發人員註冊 ID,以管理哪些廣告技術開發人員可以存取 Topics API。

應用程式也可以透過新的資訊清單和 XML 元素,以宣告的方式選擇停用 Topics API,禁止廣告 SDK 針對該應用程式使用 Topics API:

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

如果主題與選擇停用的應用程式有關,則不會計入每週主題計算結果。我們日後會更新本文件,加入相關的實作詳細資料。

See also

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