指定目標

選取平台： Android iOS Unity Flutter

RequestConfiguration 物件會收集每個廣告要求的全域設定，並由 MobileAds.instance.updateRequestConfiguration() 套用。

為確保所有廣告請求都套用請求設定變更，請先更新請求設定，再初始化 Mobile Ads SDK。

兒童導向設定

為遵守《兒童網路隱私保護法》(COPPA)，我們提供「將廣告請求標記為兒童導向內容」設定。

如果您是應用程式開發人員，則可指明是否希望 Google 在您提出廣告請求時將內容視為兒童導向內容。如果您指明希望 Google 將內容視為兒童導向內容，我們會採取相應措施，針對該廣告請求停用按照興趣顯示的廣告和再行銷廣告。透過 RequestConfiguration.tagForChildDirectedTreatment()，這項設定可搭配所有版本的 Google Play 服務 SDK 使用：

  • 使用 TagForChildDirectedTreatment.yes 引數，指明您希望內容視為兒童導向內容並接受 COPPA 規範。
  • 使用 TagForChildDirectedTreatment.no 引數，指明您不希望內容視為兒童導向內容並接受 COPPA 規範。
  • 如果您不想在廣告請求中指出內容的 COPPA 處理方式，請使用 TagForChildDirectedTreatment.unspecified 引數或不設定這個標記。

以下範例表示您希望內容依 COPPA 規定視為針對兒童：

final RequestConfiguration requestConfiguration = RequestConfiguration(
  tagForChildDirectedTreatment: TagForChildDirectedTreatment.yes);
MobileAds.instance.updateRequestConfiguration(requestConfiguration);

您可以替廣告請求設定未滿法定同意年齡的歐洲經濟區使用者標記。這項功能的立意是協助發布商遵守《一般資料保護規則》(GDPR)。請注意，您可能還有 GDPR 所衍生的其他法律義務。請查看歐盟發布的指南並諮詢您的法律顧問。提醒您，Google 提供工具的用意是協助發布商遵守規定，而非方便發布商規避法定義務。進一步瞭解 GDPR 對發布商的影響。

使用這項功能時，廣告請求將會包含未滿法定同意年齡的歐洲使用者標記 (TFUA) 參數。這個參數會針對特定廣告請求停用個人化廣告功能 (包括再行銷)。並且停止向第三方廣告供應商 (例如廣告評估像素和第三方廣告伺服器) 提出其他請求。

使用 RequestConfiguration.tagForUnderAgeOfConsent() 設定代碼：

  • 使用 TagForUnderAgeOfConsent.yes 引數，指出您希望以適合未滿規定年齡使用者的方式處理要求設定。
  • 使用 TagForUnderAgeOfConsent.no 引數，表示您不希望以適合未滿法定同意年齡使用者的方式處理要求設定。

  • 使用 TagForUnderAgeOfConsent.unspecified 引數或不設定這個標記，表示您尚未指定廣告請求是否應針對未滿法定同意年齡的歐洲經濟區使用者進行處理。以下範例表示您希望廣告請求中包含 TFUA：

    final RequestConfiguration requestConfiguration = RequestConfiguration(
  tagForUnderAgeOfConsent: TagForUnderAgeOfConsent.yes);
MobileAds.instance.updateRequestConfiguration(requestConfiguration);

啟用兒童導向設定的標記和 setTagForUnderAgeOfConsent 不得同時設為 true。否則系統將以兒童導向設定為準。

廣告內容篩選

您可以使用下列方式設定廣告內容分級：RequestConfiguration.maxAdContentRating()

系統會針對這些請求傳回內容分級等於或低於該等級的 AdMob 廣告。這個聯播網額外資訊可能的值取決於數位內容標籤分類，可以是下列 MaxAdContentRating 物件之一：

  • MaxAdContentRating.g
  • MaxAdContentRating.pg
  • MaxAdContentRating.t
  • MaxAdContentRating.ma

下列程式碼會設定 RequestConfiguration 物件，指定傳回的廣告內容對應的數位內容標籤指定等級不得高於 G：

final RequestConfiguration requestConfiguration = RequestConfiguration(
  maxAdContentRating: MaxAdContentRating.g);
MobileAds.instance.updateRequestConfiguration(requestConfiguration);

廣告請求

AdManagerAdRequest 物件會收集指定目標資訊，以便隨廣告請求一併傳送。

自訂指定目標

您可以傳遞自訂鍵/值組合，指定 Google Ad Manager 廣告活動 (委刊項)：

// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest = AdManagerAdRequest(
  customTargeting: {'age': '25'},
);

發布商提供的 ID

您可以設定發布商提供的 ID (PPID)，用於展示頻率上限、目標對象區隔和指定目標、廣告依序輪播，以及其他以目標對象為準的跨裝置廣告放送控制項。

以下是設定 PPID 的範例：

AdManagerAdRequest adRequest = AdManagerAdRequest(
  publisherProvidedId: 'AB123456789',
);

內容網址

如要為內容指定廣告和品牌安全提供內容網址，您可以在建立 AdManagerAdRequest 時傳遞 contentUrl：

AdManagerAdRequest request = AdManagerAdRequest(
  contentUrl: 'https://www.example.com',
);

品牌安全

如果應用程式會向不同目標對象顯示動態內容，則在建構 AdManagerAdRequest 時提供 neighboringContentUrls，即可提供簡短的網址清單：

final neighboringContentUrls = [
  'https://www.mycontenturl1.com',
  'https://www.mycontenturl2.com',
  'https://www.mycontenturl3.com',
  'https://www.mycontenturl4.com',
];
AdManagerAdRequest request = AdManagerAdRequest(
    neighboringContentUrls: neighboringContentUrls,
  );

neighboringContentUrls 與 contentUrl 的不同之處在於，前者僅用於品牌安全。