This page was translated by the 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

CocoaPods (建議使用)

將 SDK 匯入 iOS 專案最簡單的方法是使用 CocoaPods。開啟專案的 Podfile，然後將這一行新增至應用程式的目標：

pod 'PersonalizedAdConsent'

接著，透過指令列執行：

pod install --repo-update

如果你是初次使用 CocoaPods，請參閱他們的官方說明文件，瞭解如何建立及使用 Podfiles。

手動下載

您也可以直接下載或複製 SDK 來源，然後按照操作說明將這些 SDK 納入專案中：

從尋找工具中，將 PersonalizedAdConsent.xcodeproj 檔案拖曳至您的專案中。
前往「建構階段」分頁。在「Target Dependities」(目標依附元件) 下方，按一下 [+] 按鈕，然後新增 PersonalizedAdConsent 目標。
在專案上按一下滑鼠右鍵，然後選取 [Add Files to & MyProject]。前往 PersonalizedAdConsent.bundle。請務必勾選 [Create 增加資料夾參照]。

完成後，「複製套件資源」部分的「建構階段」分頁中會列出 PersonalizedAdConsent.bundle。

同意聲明 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 時，建議您在每次應用程式發布時確認使用者的同意聲明狀態。方法是在 PACConsentInformation 的執行個體上呼叫 requestConsentInfoUpdateForPublisherIdentifiers:completionHandler:。

Swift

import PersonalizedAdConsent
...
class ViewController: UIViewController {

  override func viewDidLoad() {
    super.viewDidLoad()
    PACConsentInformation.sharedInstance.
    requestConsentInfoUpdate(
    forPublisherIdentifiers: ["pub-0123456789012345"])
    {(_ error: Error?) -> Void in
      if let error = error {
        // Consent info update failed.
      } else {
        // Consent info update succeeded. The shared PACConsentInformation
        // instance has been updated.
      }
    }
  }

Objective-C

#import <PersonalizedAdConsent/PersonalizedAdConsent.h>
...
@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];

  [PACConsentInformation.sharedInstance
      requestConsentInfoUpdateForPublisherIdentifiers:@[ @"pub-0123456789012345" ]
          completionHandler:^(NSError *_Nullable error) {
            if (error) {
              // Consent info update failed.
            } else {
              // Consent info update succeeded. The shared PACConsentInformation
              // instance has been updated.
            }
          }];
}

呼叫 requestConsentInfoUpdateForPublisherIdentifiers:completionHandler: 需要兩個引數：

應用程式請求廣告的有效、完整啟用發布商 ID 陣列，找出您的發布商 ID。
這個區塊可接受 NSError 做為輸入參數，可提供失敗的同意聲明更新要求相關資訊。

如果同意聲明資訊更新成功，PACConsentInformation.sharedInstance.consentStatus 會提供更新的同意聲明狀態。可能的值如下：

同意聲明狀態	定義
`PACConsentStatusPersonalized`	使用者已同意啟用個人化廣告。
`PACConsentStatusNonPersonalized`	使用者已同意啟用非個人化廣告。
`PACConsentStatusUnknown`	使用者尚未同意或拒絕接收個人化廣告或非個人化廣告。

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

如果 requestLocationInEEAOrUnknown 屬性是 NO，表示使用者不在歐洲經濟區，因此依據《歐盟地區使用者同意授權政策》規定無須取得使用者同意。您可以向 Google Mobile Ads SDK 發出廣告請求。

如果 requestLocationInEEAOrUnknown 屬性是 YES：

如果 PACConsentStatus 是 PACConsentStatusPersonalized 或 PACConsentStatusNonPersonalized，使用者已經提供同意聲明。您現在可以同意 Google Mobile Ads SDK。
如果使用者有 PACConsentStatusUnknown 同意聲明，請參閱下方的「收集同意聲明」一節，其中說明如何使用公用程式收集同意聲明。

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

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

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

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

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

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

Google 提供的同意聲明表單是使用 PACConsentForm 類別來設定和顯示。下列程式碼示範如何使用這三個表單選項建構 PACConsentForm：

Swift

// TODO: Replace with your app's privacy policy url.
guard let privacyUrl = URL(string: "https://www.your.com/privacyurl"),
  let form = PACConsentForm(applicationPrivacyPolicyURL: privacyUrl) else {
    print("incorrect privacy URL.")
    return
}
form.shouldOfferPersonalizedAds = true
form.shouldOfferNonPersonalizedAds = true
form.shouldOfferAdFree = true

Objective-C

// TODO: Replace with your app's privacy policy url.
NSURL *privacyURL = [NSURL URLWithString:@"https://www.your.com/privacyurl"];
PACConsentForm *form = [[PACConsentForm alloc] initWithApplicationPrivacyPolicyURL:privacyURL];
form.shouldOfferPersonalizedAds = YES;
form.shouldOfferNonPersonalizedAds = YES;
form.shouldOfferAdFree = YES;

以下將詳細說明 PACConsentForm 的屬性：

shouldOfferPersonalizedAds: 指出同意聲明表單是否應顯示個人化廣告選項。預設值為 YES。
shouldOfferNonPersonalizedAds: 指出同意聲明表單是否應顯示非個人化廣告選項。預設值為 YES。
shouldOfferAdFree: 指出同意聲明表單是否應顯示無廣告應用程式選項。預設值為 NO。

載入同意聲明表單

建立並設定 PACConsentForm 物件後，叫用 PACConsentForm 的 loadWithCompletionHandler: 方法載入同意聲明表單，如下所示：

Swift

form.load {(_ error: Error?) -> Void in
  print("Load complete.")
  if let error = error {
    // Handle error.
    print("Error loading form: \(error.localizedDescription)")
  } else {
    // Load successful.
  }
}

Objective-C

[form loadWithCompletionHandler:^(NSError *_Nullable error) {
  NSLog(@"Load complete. Error: %@", error);
  if (error) {
    // Handle error.
  } else {
    // Load successful.
  }
}];

顯示同意書

如要向使用者顯示 Google 提供的同意聲明表單，請在載入的 PACConsentForm 上呼叫 presentFromViewController:dismissCompletion:，如下所示：

Swift

form.present(from: self) { (error, userPrefersAdFree) in
      if let error = error {
        // Handle error.
      } else if userPrefersAdFree {
        // User prefers to use a paid version of the app.
      } else {
        // Check the user's consent choice.
        let status =
             PACConsentInformation.sharedInstance.consentStatus
      }
    }

Objective-C

 [form presentFromViewController:self
     dismissCompletion:^(NSError *_Nullable error, BOOL userPrefersAdFree) {
       if (error) {
         // Handle error.
       } else if (userPrefersAdFree) {
         // The user prefers to use a paid version of the app.
       } else {
         // Check the user's consent choice.
         PACConsentStatus status =
             PACConsentInformation.sharedInstance.consentStatus;
       }
     }];

呼叫 presentFromViewController:dismissCompletion: 需要兩個引數：

要分享螢幕畫面的 UIViewController。
可接受 NSError 和 BOOL 做為輸入參數的區塊。如果顯示同意表單時發生錯誤，NSError 會提供相關資訊。如果使用者選擇使用付費版應用程式 (而不是廣告) 時，userPrefersAdFree BOOL 的值為 YES。

在使用者選取選項並關閉表單後，Consent SDK 會儲存使用者的選擇並呼叫 dismissCompletion: 區塊。您可以閱讀使用者選擇的選項，並將同意聲明轉寄給 Google Mobile Ads SDK。

發布商管理同意聲明收集

如果您選擇自行取得同意聲明，可以使用 PACConsentInformation 類別的 adProviders 屬性，取得與您應用程式中所用發布商 ID 相關聯的廣告技術供應商。請注意，您必須為發布商 ID 設定的完整廣告技術供應商清單必須取得同意聲明。

在您存取 PACConsentInformation 的 adProviders 屬性之前，您必須等待「同意聲明狀態」一節所述的使用者同意聲明狀態更新成功。

Swift

let adProviders = PACConsentInformation.sharedInstance.adProviders

Objective-C

NSArray *adProviders = PACConsentInformation.sharedInstance.adProviders;

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

儲存發布商管理同意書

取得同意後，請使用 PACConsentInformation 類別的 status 屬性記錄與使用者回應相對應的 PACConsentStatus。

Swift

PACConsentInformation.sharedInstance.consentStatus = .personalized

Objective-C

PACConsentInformation.sharedInstance.consentStatus = PACConsentStatusPersonalized;

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

變更或撤銷同意聲明

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

未滿規定年齡的使用者

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

Swift

PACConsentInformation.sharedInstance.isTaggedForUnderAgeOfConsent = true

Objective-C

PACConsentInformation.sharedInstance.tagForUnderAgeOfConsent = YES;

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

如要從廣告請求中移除 TFUA，請將 tagForUnderAgeOfConsent 屬性設為 NO。

測試

同意聲明 SDK 的行為取決於 PACConsentInformation.sharedInstance.requestLocationInEEAOrUnknown。舉例來說，如果使用者不在歐洲經濟區，同意聲明表單就會無法載入。

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

取得您的裝置廣告 ID。您可以使用以下程式碼來記錄廣告 ID：

#import <AdSupport/AdSupport.h>
// ...

NSLog(@"Advertising ID: %@",
      ASIdentifierManager.sharedManager.advertisingIdentifier.UUIDString);

然後透過主控台取得：

Advertising ID: 41E538F6-9C98-4EF2-B3EE-D7BD8CAF8339

使用主控台的廣告 ID 將裝置設定為測試裝置：
```
PACConsentInformation.sharedInstance.debugIdentifiers =
    @[ @"41E538F6-9C98-4EF2-B3EE-D7BD8CAF8339" ];
```
警告：我們強烈建議不要將 debugIdentifiers 設為目前裝置的廣告 ID。您不打算讓應用程式發布風險，而其中的程式碼會覆寫每位使用者的地理位置。
重點提示：模擬工具會自動新增為測試裝置，您不需另外執行任何步驟。

最後，請將 debugGeography 設為您偏好的地理位置以進行測試。

// Geography appears as in EEA for debug devices.
PACConsentInformation.sharedInstance.debugGeography = PACDebugGeographyEEA;
// Geography appears as not in EEA for debug devices.
PACConsentInformation.sharedInstance.debugGeography = PACDebugGeographyNotEEA;

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

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

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

迅速

let request = GADRequest()
let extras = GADExtras()
extras.additionalParameters = ["npa": "1"]
request.register(extras)

Objective-C

GADRequest *request = [GADRequest request];
GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{@"npa": @"1"};
[request registerAdNetworkExtras:extras];

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

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

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

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

如要延遲應用程式評估作業，請將具有布林值 YES 的 GADDelayAppMeasurementInit 金鑰新增至應用程式的 Info.plist。您可以透過程式進行這項變更：

<key>GADDelayAppMeasurementInit</key>
<true/>

您也可以在屬性清單編輯器中加以編輯：

常見問題

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