為應用程式或 SDK 設定 API 存取權

Stay organized with collections Save and categorize content based on your preferences.

如要在開發人員預覽版期間為應用程式或 SDK 存取隱私權保護 API (PPAPI),必須先執行下列步驟:

您必須具備 API 存取權,才能使用隱私權保護 API 和 SDK 執行階段。

您必須具備這項權限,才能在應用程式或 SDK 中使用特定隱私權保護 API。

啟用 Privacy Sandbox API 存取權

Android 版 Privacy Sandbox 的設計,可讓使用者控制裝置是否啟用 Privacy-Preserve API 和 SDK 執行階段。從開發人員預覽版 5 開始,這些設定皆預設為停用。基於開發作業需求,您可以使用下列 ADB 指令啟用 API 存取權:

adb shell device_config put adservices ppapi_app_allow_list \"*\"

在準備發布正式版時,開發人員預覽版 6 推出了旗標,用於在預設條件下停用 Privacy-Preserve API 存取權。為了進行測試,請執行下列指令,在開發人員預覽版中啟用 Privacy-Preserve API API 存取權:

adb shell device_config put adservices global_kill_switch false

FLEDGE

從開發人員預覽版 6 開始,將強制執行 FLEDGE 註冊。基於開發作業需求,您可以使用下列 ADB 指令啟用 API 存取權:

adb shell "device_config put adservices disable_fledge_enrollment_check true"

設定 AdServices 權限

請按照以下操作說明宣告 API 專屬權限,並設定目標 API 所管理資源的 SDK 存取權。

宣告 AdServices API 專屬權限

存取每個 PPAPI 都必須具備 AdServices 一般權限。在資訊清單中,宣告與應用程式或 SDK 所需 API 對應的適當存取權限。

Attribution Reporting API:

<uses-permission android:name="android.permission.ACCESS_ADSERVICES_ATTRIBUTION" />

FLEDGE/Custom Audience API:

<uses-permission android:name="android.permission.ACCESS_ADSERVICES_CUSTOM_AUDIENCE" />

Topics API:

<uses-permission android:name="android.permission.ACCESS_ADSERVICES_TOPICS" />

設定 API 專屬廣告服務

與 PPAPI 存取權限類似,每個 API 的廣告服務設定都有對應項目。這項設定可讓您精細地控管應用程式或內嵌式 SDK 中 API 所管理的資源存取權。在資訊清單中指定 adservicesConfig 資源,如以下範例所示:

<application ...>
      ...
    <property android:name="android.adservices.AD_SERVICES_CONFIG"
        android:resource="@xml/ad_services_config" />

      ...
</application>

指定資訊清單所參照的廣告服務 XML 資源,例如 res/xml/ad_services_config.xml。針對適用於應用程式 (或內嵌式 SDK) 的每個隱私權保護 API,使用 allowAllToAccess 屬性授予存取權。

廣告技術平台也應確保其應用程式用戶端能正確授予廣告服務設定中必要隱私權保護 API 的存取權。

<ad-services-config>
    <!-- Attribution API -->
    <attribution allowAllToAccess="true" />

    <!-- Topics API -->
    <topics allowAllToAccess="true" />

    <!-- FLEDGE on Android API -->
    <custom-audiences allowAllToAccess="true" />
</ad-services-config>

前景存取權限制

為了提供公開透明的資訊,SDK 執行階段和隱私權保護 API 的存取權僅開放給具有可見 Activity (或透過 IMPORTANCE_FOREGROUND 提供 RunningAppProcessInfo) 的應用程式使用。