此页面由 Cloud Translation API 翻译。

請求歐洲用戶的同意

警告：系統已停止維護個人化廣告個人化廣告 SDK。並由 User Messaging Platform SDK ，符合 IAB 規範。{/17

根據 Google 的《歐盟地區使用者同意授權政策》規定，您必須向歐洲經濟區 (EEA) 境內的使用者揭露特定資訊；且依據法規要求，使用 Cookie 或其他本機儲存空間，並可使用個人資料 (例如 AdID) 放送廣告。本政策反映出《歐盟地區電子通訊隱私指令》和《一般資料保護規則》(GDPR) 的規定。

為協助發布商根據這項政策履行自身責任，Google 提供了 Consent SDK。Consent SDK 是一項開放原始碼程式庫，提供可向使用者收集同意聲明的公用程式函式。您可以在 GitHub 上查看完整的原始碼。

Google 放送的廣告可分為「個人化」或「非個人化廣告」兩種類型，兩者必須取得歐洲經濟區使用者的同意。根據預設，傳送給 Google 的廣告請求會放送個人化廣告，並依據使用者先前收集的資料選擇廣告。此外，Google 也支援設定廣告請求來放送非個人化廣告。進一步瞭解個人化和非個人化廣告。

本指南說明如何使用 Consent SDK 取得使用者的同意聲明。也會說明如何在取得使用者同意後將同意聲明轉寄至 Google Mobile Ads SDK。

事前準備

登入 AdMob 帳戶，然後選取廣告技術供應商。

匯入 Consent SDK

應用程式可透過 Gradle 依附元件匯入 Consent SDK，該 SDK 指向指向 Google 的 Maven 存放區。如要使用該存放區，您必須在應用程式的專案層級 build.gradle 檔案中參照該存放區。開啟專屬頁面並尋找 allprojects 區段：

專案層級的 build.gradle (摘錄)

allprojects {
    repositories {
        google()
        jcenter()
    }
}

將 google() 指令加入上方 (如果還沒有的話)。

接著，開啟應用程式層級的 build.gradle 檔案，然後尋找「附屬」部分。

應用程式層級的 build.gradle (摘錄)

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'androidx.appcompat:appcompat:1.2.0'
    implementation 'com.google.android.ads.consent:consent-library:1.0.6'
}

在上方新增粗體字行，指示 Gradle 提取最新版 Consent SDK。完成後，請儲存檔案並執行 Gradle 同步功能。

同意聲明 SDK 的使用訣竅

使用 Consent SDK 中的任何其他方法之前，建議您更新同意聲明狀態，確保 Consent SDK 含有您在AdMob UI 中選取的廣告技術供應商最新相關資訊。如果廣告技術供應商清單自使用者上次提供同意聲明後有所變更，同意聲明狀態會重設為不明狀態。

如果您不使用中介服務

若您目前未使用中介服務，有兩種方式可以導入同意聲明 SDK，藉此收集同意聲明。

其中一個選項是使用 Consent SDK，為使用者提供 Google 提供的同意聲明表單。同意聲明表單會列出您在 UI 中選擇的廣告技術供應商。 AdMobConsent SDK 會儲存使用者同意聲明回應。

另一個方法是使用 Consent SDK 來動態擷取 AdMob中的廣告技術供應商完整清單 (如發布商管理同意聲明集合所述)。然而，在這種情況下，您必須決定向使用者提供供應商清單的方式，並向使用者顯示您自己的同意表單。

使用者表示同意選項後，您可以要求同意聲明 SDK 儲存使用者的同意聲明選項，方法如「儲存發布商管理同意聲明」所述。

收集同意聲明後，如果使用者同意只接收非個人化廣告，您就必須向 Google Mobile Ads SDK 轉寄同意聲明。

如果採用 AdMob 中介服務

您可以使用 Consent SDK 從 AdMob以動態方式擷取廣告技術供應商的完整清單，如發布商管理的同意聲明集合所述。您必須決定要向其他廣告聯播網提出其他廣告技術供應商的同意聲明。

身為應用程式開發人員，您必須收集同意聲明 SDK 傳回的廣告技術供應商和其他廣告聯播網供應商的同意聲明。此外，如果使用者同意只接收非個人化廣告，您也需要手動儲存使用者同意聲明回應，並向 Google Mobile Ads SDK 轉寄同意聲明。

Google 目前無法取得並處理中介服務聯播網的同意聲明，因此您需要分別取得並處理每個廣告聯播網的同意聲明。請參閱各中介服務合作夥伴的整合指南，瞭解詳細的導入資訊。

更新同意聲明狀態

使用 Consent SDK 時，建議您在每次應用程式發布時確認使用者的同意聲明狀態。方法是在 ConsentInformation 的執行個體上呼叫 requestConsentInfoUpdate()。

import com.google.ads.consent.*;

public class MainActivity extends Activity {
    ...

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        ...
        ConsentInformation consentInformation = ConsentInformation.getInstance(context);
        String[] publisherIds = {"pub-0123456789012345"};
        consentInformation.requestConsentInfoUpdate(publisherIds, new ConsentInfoUpdateListener() {
            @Override
            public void onConsentInfoUpdated(ConsentStatus consentStatus) {
                 // User's consent status successfully updated.
            }

            @Override
            public void onFailedToUpdateConsentInfo(String errorDescription) {
                 // User's consent status failed to update.
            }
        });
        ...
    }
    ...
}

呼叫 requestConsentInfoUpdate() 需要兩個引數：

應用程式請求廣告的有效、完整啟用發布商 ID 陣列，找出您的發布商 ID。
ConsentInfoUpdateListener 的執行個體。

如果同意聲明資訊更新成功，系統會透過 ConsentInfoUpdateListener 的 onConsentInfoUpdated() 方法提供更新的同意聲明狀態。傳回的 ConsentStatus 可能包含下列值：

同意聲明狀態	定義
`ConsentStatus.PERSONALIZED`	使用者已同意啟用個人化廣告。
`ConsentStatus.NON_PERSONALIZED`	使用者已同意啟用非個人化廣告。
`ConsentStatus.UNKNOWN`	使用者尚未同意或拒絕接收個人化廣告或非個人化廣告。

成功更新同意聲明資訊後，您也可以查看 ConsentInformation.getInstance(context).isRequestLocationInEeaOrUnknown()，確認使用者位於歐洲經濟區或要求位置不明。

如果 isRequestLocationInEeaOrUnknown() 方法傳回 false，表示使用者不在歐洲經濟區，因此依據《EU 使用者同意授權政策》規定不需要取得同意聲明。您可以向 Google Mobile Ads SDK 發出廣告請求。

如果 isRequestLocationInEeaOrUnknown() 方法傳回 true：

如果傳回的 ConsentStatus 是 PERSONALIZED 或 NON_PERSONALIZED，表示使用者已提供同意聲明。您現在可以將同意聲明轉寄至 Google Mobile Ads SDK。
如果傳回的 ConsentStatus 是 UNKNOWN，請參閱下方「收集同意聲明」一節，其中說明使用公用程式方法收集同意聲明。

Google 的同意聲明 SDK。您可以透過兩種方式提供使用者的同意聲明：

向使用者顯示 Google 顯示的同意聲明表單。
使用發布商管理的同意聲明收集選項，要求廣告技術供應商清單並自行收集同意聲明。

請記得為使用者提供變更或撤銷同意聲明的選項。

Google 提供的同意聲明表單是全螢幕的設定，可顯示在應用程式內容上方。您可以設定表單，向使用者顯示下列選項的組合：

同意查看個人化廣告
同意查看非個人化廣告
使用付費版應用程式，而不觀看廣告

請仔細閱讀同意授權文字：根據預設，如果系統透過 Google 透過您的應用程式營利，「可能」顯示的訊息應該屬於適當訊息，但我們無法針對適合您的同意文字提供法律建議。如要更新 Google 提供的同意聲明表單的同意聲明文字，請視需要修改 Consent SDK 中的 consentform.html 檔案。

系統會使用 ConsentForm 類別來設定及顯示 Google 提供的同意聲明表單。下列程式碼示範如何使用全部三個同意聲明選項來建構 ConsentForm：

URL privacyUrl = null;
try {
    // TODO: Replace with your app's privacy policy URL.
    privacyUrl = new URL("https://www.your.com/privacyurl");
} catch (MalformedURLException e) {
    e.printStackTrace();
    // Handle error.
}
ConsentForm form = new ConsentForm.Builder(context, privacyUrl)
    .withListener(new ConsentFormListener() {
        @Override
        public void onConsentFormLoaded() {
            // Consent form loaded successfully.
        }

        @Override
        public void onConsentFormOpened() {
            // Consent form was displayed.
        }

        @Override
        public void onConsentFormClosed(
                ConsentStatus consentStatus, Boolean userPrefersAdFree) {
            // Consent form was closed.
        }

        @Override
        public void onConsentFormError(String errorDescription) {
            // Consent form error.
        }
    })
    .withPersonalizedAdsOption()
    .withNonPersonalizedAdsOption()
    .withAdFreeOption()
    .build();

上述方法可為 Google 轉譯的同意聲明表單提供下列選項：

withListener()

註冊 ConsentForm 的監聽器。ConsentFormListener 中的每個可覆寫方法都會對應同意聲明表單生命週期中的事件。

可覆寫的方法
`onConsentFormLoaded`	同意聲明表單已成功載入。
`onConsentFormError`	無法載入同意聲明表單。`errorDescription` 參數會提供錯誤的說明。
`onConsentFormOpened`	同意聲明表單已開啟。
`onConsentFormClosed`	同意聲明表單已關閉。此方法的參數提供以下資訊： `consentStatus` 是一個 `ConsentStatus` 值，用來說明使用者的更新同意聲明狀態。如果使用者選擇使用付費版應用程式 (而不是觀看廣告)，`userPrefersAdFree` 的值為 `true`。

withPersonalizedAdsOption()

用於表示同意表單應顯示個人化廣告選項。

withNonPersonalizedAdsOption()

表示同意表單應會顯示非個人化廣告選項。

withAdFreeOption()

代表同意表單應顯示無廣告的應用程式選項。

載入同意聲明表單

建立 ConsentForm 物件後，叫用 ConsentForm 的 load() 方法載入同意聲明表單，如下所示：

form.load();

顯示同意書

如要向使用者顯示 Google 提供的同意聲明表單，請在 ConsentForm 的執行個體上呼叫 show()，如下所示：

form.show();

在使用者選取選項並關閉表單後，Consent SDK 會儲存使用者的選擇並觸發 onConsentFormClosed 事件。您可以監聽這個事件，並預先同意 Google Mobile Ads SDK。

發布商管理同意聲明收集

如果您選擇自行收集同意聲明，可以使用 ConsentInformation 類別的 getAdProviders() 方法，取得與您應用程式中所用發布商 ID 相關聯的廣告技術供應商。請注意，您必須為發布商 ID 設定的完整廣告技術供應商清單需要取得同意聲明。

在呼叫 getAdProviders() 之前，您必須等待 ConsentInfoUpdateListener 的 onConsentInfoUpdate() 方法如更新同意聲明狀態一節所述。

List<AdProvider> adProviders =
    ConsentInformation.getInstance(context).getAdProviders();

之後，您就能使用廣告技術供應商名單，自行取得同意聲明。

取得同意後，請使用 ConsentInformation 類別的 setConsentStatus() 方法記錄與使用者回應相對應的 ConsentStatus。

ConsentInformation.getInstance(context)
    .setConsentStatus(ConsentStatus.PERSONALIZED);

向同意 SDK 回報同意聲明後，您可以將同意聲明轉寄至 Google Mobile Ads SDK。

變更或撤銷同意聲明

如要允許使用者更新同意聲明，只需在使用者選擇更新同意聲明狀態時，重複收集同意聲明一節所述的步驟即可。

未滿規定年齡的使用者

如果發布商知悉使用者未滿規定年齡，所有廣告請求都必須設定 TFUA (未滿歐洲地區未滿法定同意年齡的使用者廣告代碼)。如要在應用程式發出的所有廣告請求中加入這個代碼，請呼叫 setTagForUnderAgeOfConsent(true)。這項設定會套用至日後的所有廣告請求。

ConsentInformation.getInstance(context).setTagForUnderAgeOfConsent(true);

啟用 TFUA 設定後，Google 轉譯的同意聲明表單就無法載入。包含 TFUA 的所有廣告請求都將不符合個人化廣告和再行銷資格。TFUA 會停止向第三方廣告技術供應商 (例如廣告評估像素和第三方廣告伺服器) 提出其他請求。

如要從廣告請求中移除 TFUA，請呼叫 setTagForUnderAgeOfConsent(false)。

測試

同意聲明 SDK 的行為取決於 ConsentInformation.getInstance(context).isRequestLocationInEeaOrUnknown() 的值。舉例來說，如果使用者不在歐洲經濟區，同意聲明表單就會無法載入。

為了讓您更輕鬆地在歐洲經濟區內外測試應用程式，可以先在 CMP SDK 中呼叫任何其他方法，再設定偵錯選項。

按照更新同意聲明狀態一節中的操作說明呼叫 requestConsentInfoUpdate。然後執行應用程式。請檢查 logcat 輸出內容以獲得下列記錄：
```
I/ConsentInformation: Use
ConsentInformation.getInstance(context).addTestDevice("33BE2250B43518CCDA7DE426D04EE231")
to get test ads on this device.
```
使用 logcat 的廣告 ID 將裝置做為測試裝置：
```
ConsentInformation.getInstance(context).addTestDevice("33BE2250B43518CCDA7DE426D04EE231");
```
重點提示：模擬器會自動新增為測試裝置，您不需進行額外步驟。

最後，呼叫 setDebugGeography 來設定您偏好的地理位置來進行測試。

// Geography appears as in EEA for test devices.
ConsentInformation.getInstance(context).
    setDebugGeography(DebugGeography.DEBUG_GEOGRAPHY_EEA);
// Geography appears as not in EEA for debug devices.
ConsentInformation.getInstance(context).
    setDebugGeography(DebugGeography.DEBUG_GEOGRAPHY_NOT_EEA);

完成這些步驟後，更新同意聲明狀態的呼叫會將您的偵錯地理位置納入考量。

本節中的代碼可用於任何版本的 Google 移動廣告 SDK。無論您是否使用 Consent SDK 來收集同意，它也都可以使用。

Google 移動廣告 SDK 的默認行為是提供個性化廣告。如果用戶已同意僅接收非個性化廣告，您可以配置一個AdRequest對象來指定只應請求非個性化廣告。無論用戶是否在 EEA 中，以下代碼都會導致請求非個性化廣告：

Bundle extras = new Bundle();
extras.putString("npa", "1");

AdRequest request = new AdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter.class, extras)
    .build();

如果請求非個性化廣告，則廣告請求 URL 當前包含&npa=1 。不過請注意，這是 Google 移動廣告 SDK 的內部實施細節，可能會發生變化。

延後應用程式評估 (選用)

根據預設，Google Mobile Ads SDK 會初始化應用程式評估作業，並在應用程式啟動時，立即將使用者層級事件資料傳送給 Google。這項初始化行為可確保您能夠直接啟用 AdMob 使用者指標，無需另外修改程式碼。

不過，如果您的應用程式需要經過使用者同意才能傳送這些事件，您就能延後應用程式評估作業，直到您明確初始化 Mobile Ads SDK 或載入廣告為止。

如要延遲應用程式評估作業，請在您的 AndroidManifest.xml 中加入下列 <meta-data> 標記。

<manifest>
     <application>
        <!-- Delay app measurement until MobileAds.initialize() is called. -->
        <meta-data
            android:name="com.google.android.gms.ads.DELAY_APP_MEASUREMENT_INIT"
            android:value="true"/>
    </application>
</manifest>

常見問題

同意聲明 SDK 支援多少廣告技術供應商？: 同意聲明 SDK 不會限制發布商選擇啟用的廣告技術供應商數量。
如果我在「使用者介面」中變更了選項，SDK 傳回的廣告技術供應商清單會自動更新嗎？ AdMob: 可以，如果您在AdMob UI 中更改廣告技術供應商清單，新的變更大約會在一小時內反映在 Google 的廣告伺服器中。