指定目標

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

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

必要條件

  • 完成「開始使用」

RequestConfiguration

RequestConfiguration 是一個結構,可透過 SetRequestConfiguration() 全域函式收集要套用的指定資訊。

如要更新要求設定,請先取得目前的設定,執行所需更新,並按照以下步驟進行設定:

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

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

兒童導向內容設定

根據《兒童網路隱私保護法》(COPPA) 的規定,以下設定稱為「兒童導向內容標記」。設定此標記,即表示您確認這項通知正確無誤,而且您有權代表應用程式的擁有者行事。您瞭解濫用這項設定可能會導致您的 Google 帳戶遭到終止。

如果您是應用程式開發人員,則可指明是否希望 Google 在您提出廣告請求時,將您的內容視為兒童導向內容。如果您不希望 Google 將您的內容視為兒童導向內容,我們會採取相應措施,針對該廣告請求停用 IBA 和再行銷廣告。

只要將 RequestConfiguration 結構的 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 帳戶遭到終止。

您可以替廣告請求設定未滿法定同意年齡的歐洲經濟區 (EEA) 使用者處理方式。這項功能的立意是協助您遵守《一般資料保護規則》(GDPR)。請注意,您可能也需要配合 GDPR 遵守其他法律義務;請詳閱歐盟指南,並諮詢您的法律顧問。在此提醒您,Google 提供工具的用意是協助發布商遵守規定,不是幫忙任何發布商規避其法律義務。進一步瞭解 GDPR 對發布商的影響

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

與兒童導向內容導向的設定一樣,RequestConfiguration 中有一個成員用於設定 TFUA 參數:tag_for_under_age_of_consent,可以使用下列列舉值進行設定:

  • 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,表明您尚未指定廣告請求是否應獲得未滿規定年齡的歐洲經濟區 (EEA) 使用者接受。

以下範例表示您希望廣告請求包含 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);

用來啟用「兒童導向」設定和「未滿規定年齡使用者」的標記不得同時設為「是」。如果這兩者同時設定,系統會優先採用子項導向設定。

廣告素材篩選

應用程式可透過 RequestConfiguration::max_ad_content_rating field 設定廣告請求的廣告內容分級上限。設定了這項設定時,AdMob 廣告傳回的內容分級等於或低於這個層級。可能的值以數位內容標籤分類為基礎,且必須是下列其中一個列舉值:

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

下列程式碼會設定 RequestConfiguration 結構,以指明傳回的廣告內容應對應至不超過 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();