Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

指定目標

本指南說明如何提供廣告請求的指定目標資訊。

必要條件

完成入門指南步驟。

`RequestConfiguration`

RequestConfiguration 是一種 struct，用來收集指定目標資訊，這些資訊會透過 SetRequestConfiguration() 全域函式在全域套用。

如要更新請求設定，請先取得目前的設定，進行所需更新，再依下列方式設定：

  firebase::gma::RequestConfiguration retrieved_configuration =
    firebase::gma::GetRequestConfiguration();

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

兒童導向內容設定

為符合《兒童網路隱私保護法》(COPPA)，系統支援「兒童導向內容標記」設定。設定此標記，代表您保證這項通知資訊正確無誤，且您有權代表應用程式擁有者行事。您知悉濫用這項設定可能導致 Google 帳戶遭終止。

應用程式開發人員可以在傳送廣告請求時，指明是否希望 Google 將內容標為兒童導向。如果希望 Google 將內容視為兒童導向，我們就會採取相關行動，對廣告請求停用「按照興趣顯示廣告」(IBA) 功能和再行銷廣告。

如要調整這項設定，請將 RequestConfiguration struct 的 tag_for_child_directed_treatment 成員指派為下列其中一個列舉值：

將 RequestConfiguration::tag_for_child_directed_treatment 指派給 RequestConfiguration::kChildDirectedTreatmentTrue，表示要依據 COPPA 規定將內容視為兒童導向。
將 RequestConfiguration::tag_for_child_directed_treatment 指派給 RequestConfiguration::kChildDirectedTreatmentFalse，表示不要依據 COPPA 規定將內容視為兒童導向。
如果不想在廣告請求中指明應如何依據 COPPA 處理內容，請將 RequestConfiguration::tag_for_child_directed_treatment 設為 RequestConfiguration::kChildDirectedTreatmentUnspecified。

以下示範如何指明要根據 COPPA 將內容標為兒童導向。

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.tag_for_child_directed_treatment =
    firebase::RequestConfiguration::kChildDirectedTreatmentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

設定此標記，代表您保證提供的資訊屬實，而且您有權代表應用程式擁有者行事。您也明白，濫用此設定可能導致 Google 帳戶遭到終止。

未滿規定年齡的使用者

針對未滿規定年齡的歐洲經濟區使用者，您可以在廣告請求中加上相關處理標記。這項功能是為協助發布商遵守《一般資料保護規則》(GDPR)。請注意，根據 GDPR 規定，您可能還有其他法律義務。建議您參閱歐盟官方指引，並諮詢您的法律顧問。提醒您，Google 提供工具的用意是協助發布商遵守規定，而非方便發布商規避法定義務。進一步瞭解 GDPR 對發布商的影響。

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

就像兒童導向內容設定，您可以使用 RequestConfiguration 中的成員 tag_for_under_age_of_consent 設定 TFUA 參數，可用的列舉值包括：

將 RequestConfiguration::tag_for_under_age_of_consent 指派給 RequestConfiguration::kUnderAgeOfConsentTrue，表示您希望廣告請求對歐洲經濟區 (EEA) 未滿規定年齡的使用者，採取相應措施。
將 RequestConfiguration::tag_for_under_age_of_consent 指派給 RequestConfiguration::kUnderAgeOfConsentFalse，表示您不希望廣告請求對歐洲經濟區 (EEA) 未滿規定年齡的使用者，採取相應措施。
將 RequestConfiguration::tag_for_under_age_of_consent 指派給 RequestConfiguration::kUnderAgeOfConsentUnspecified，表示您未指定是否要對涉及歐洲經濟區內未滿規定年齡使用者的廣告請求，套用相關模式。

以下示範如何在廣告請求中加入 TFUA：

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.tag_for_under_age_of_consent =
    firebase::RequestConfiguration::kUnderAgeOfConsentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

啟用「兒童導向內容設定」和「未滿規定年齡的使用者」的標記，不可同時設為 true，否則系統會優先採用兒童導向內容設定。

廣告內容篩選

應用程式可透過 RequestConfiguration::max_ad_content_rating field，設定廣告請求的廣告內容分級上限。設定完上限後，AdMob 傳回的廣告內容分級會等於或低於該層級。可能的值取決於數位內容標籤分類，且須為下列任一列舉值：

RequestConfiguration::kMaxAdContentRatingG
RequestConfiguration::kMaxAdContentRatingPG
RequestConfiguration::kMaxAdContentRatingT
RequestConfiguration::kMaxAdContentRatingMA

下列程式碼會設定 RequestConfiguration struct，指定傳回的廣告素材所對應的數位內容標籤分級不得高於 G：

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.max_ad_content_rating =
    firebase::RequestConfiguration::kMaxAdContentRatingG;

  firebase::gma::SetRequestConfiguration(request_configuration);

`AdRequest`

AdRequest 物件會收集指定目標資訊，並與廣告請求一併傳送。

內容網址

應用程式發送廣告請求時，可以同時傳遞目前顯示內容的網址，這可讓系統依指定關鍵字提供相關廣告。

舉例來說，如果應用程式在顯示 https://www.example.com 的內容時請求廣告，您可以傳遞這個網址，讓系統依關鍵字放送相關廣告：

  // AdRequest with content URL:
  firebase::admob::AdRequest ad_request(/*content_url=*/"https://www.example.com");

  // AdRequest without content URL:
  firebase::admob::AdRequest ad_request();