指定目標

指定目標功能可讓您向 Google Mobile Ads SDK for React Native 提供情境和目標對象資訊，向使用者放送相關廣告。

您可以在下列層級設定指定目標：

  • 全域請求設定：將設定套用至應用程式中的所有廣告請求，包括兒童和青少年年齡處理方式、廣告內容分級上限、發布商隱私權處理方式，以及測試裝置 ID。
  • 按請求指定：使用廣告 請求物件 (包括內容網址和聯播網額外資訊) 自訂個別廣告請求。

本指南說明如何向 Google Mobile Ads SDK for React Native 提供指定目標資訊。

必要條件

請先設定 Google Mobile Ads SDK for React Native，再繼續操作。

設定要求

RequestConfiguration 物件會收集全面套用至所有廣告請求的指定目標資訊。

如要套用第一個廣告請求的指定目標設定，請在呼叫 initialize 方法時設定 requestConfiguration 屬性：

const requestConfiguration: RequestConfiguration = {
  maxAdContentRating: MaxAdContentRating.G,
  ageRestrictedTreatment: AgeRestrictedTreatment.CHILD,
  publisherPrivacyPersonalizationState:
    PublisherPrivacyPersonalizationState.DISABLED,
  testDeviceIds: ["TEST_DEVICE_HASHED_ID"],
};

initialize({requestConfiguration}, (_status: InitializationStatus) => {
  // SDK initialization is complete.
});

將 TEST_DEVICE_HASHED_ID 替換為經雜湊處理的測試裝置 ID。這個 ID 會指定應接收測試廣告的裝置。

如要在初始化 Google Mobile Ads SDK for React Native 後更新指定目標設定，請呼叫 setRequestConfiguration 方法。setRequestConfiguration 方法會取代現有設定，並在後續的廣告請求中生效。

以下範例會修改 RequestConfiguration 物件，更新指定目標設定，並將設定套用至廣告請求：

const requestConfiguration: RequestConfiguration = {
  ...getRequestConfiguration(),
  maxAdContentRating: MaxAdContentRating.PG,
  ageRestrictedTreatment: AgeRestrictedTreatment.TEEN,
};

setRequestConfiguration(requestConfiguration);

設定年齡處理方式

為協助您遵循兒童與青少年適用的相關隱私權法規，Google Mobile Ads SDK for React Native 提供了年齡處理設定。您可以設定年齡處理方式，指定 Google Mobile Ads SDK for React Native 是否應針對兒童、青少年或未指定年齡套用特定的廣告放送保護措施。

您可以在 RequestConfiguration 上使用 ageRestrictedTreatment 屬性設定年齡處理方式。

下列範例說明如何為廣告請求設定兒童年齡處理方式：

const requestConfiguration: RequestConfiguration = {
  // Indicate that ad requests should have child age treatment.
  ageRestrictedTreatment: AgeRestrictedTreatment.CHILD,
};

setRequestConfiguration(requestConfiguration);

如要指定青少年或未指定年齡對象的處理方式，請將 AgeRestrictedTreatment.CHILD 設定替換為下列內容：

啟用這項設定後，Google Mobile Ads SDK for React Native 會在廣告請求中納入 tfat 參數。請諮詢法律顧問，根據您應盡的法律與法規義務，決定要對使用者採取的年齡處理方式。詳情請參閱「將應用程式的廣告請求標記為依年齡限制處理」。

篩選廣告素材

您可利用廣告內容分級上限，控管向使用者放送的廣告內容。您可以設定內容分級上限，以利遵守平台政策。

您可以使用 RequestConfiguration 物件的 maxAdContentRating 屬性，為應用程式中的廣告請求設定廣告內容分級上限。完成這項設定後，系統傳回的廣告內容分級會等於或低於該分級。這項設定可能的值取決於數位內容標籤分類，且須為下列任一常數：

以下範例演示如何設定 RequestConfiguration 物件，指定傳回廣告素材時，所對應的數位內容標籤不得高於 G 常數：

const requestConfiguration: RequestConfiguration = {
  maxAdContentRating: MaxAdContentRating.G,
};

setRequestConfiguration(requestConfiguration);

詳情請參閱以下說明：

選用：設定 PPT API (Beta 版)

Publisher Privacy Treatment (PPT) API 可讓您使用 RequestConfiguration 物件的 publisherPrivacyPersonalizationState 屬性，指定是否停止對所有廣告請求傳回廣告個人化。如果採用這項功能，Google Mobile Ads SDK for React Native 會在工作階段後續所有的廣告請求中，加入 Publisher Privacy Treatment (PPT) 參數。

根據預設，Google 會對廣告請求提供個人化廣告。下列範例會停用所有廣告請求的廣告個人化設定：

const requestConfiguration: RequestConfiguration = {
  publisherPrivacyPersonalizationState:
    PublisherPrivacyPersonalizationState.DISABLED,
};

setRequestConfiguration(requestConfiguration);

設定 AdRequest 物件

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

與使用 setRequestConfiguration 方法設定的全域設定不同，AdRequest 物件會傳遞至廣告格式類別的 load 方法，例如插頁式廣告的 InterstitialAd.load 或橫幅廣告的 BannerAd.load。

新增聯播網額外資訊

如要將聯播網專屬參數傳遞至 Google Mobile Ads SDK for React Native (例如可收合廣告的參數)，請使用 extras 屬性。

以下範例會將額外資訊參數鍵 collapsible 設為 bottom 值：

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  extras: {
    collapsible: 'bottom',
  },
};

提供內容網址

如要提供內容網址，放送指定內容的廣告並確保品牌安全，請新增 contentUrl 屬性：

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  contentUrl: 'https://www.example.com',
};

內容網址長度不得超過 512 個半形字元。