整合 ironSource 廣告與中介服務

本指南說明如何使用 Google Mobile Ads SDK 透過中介服務載入並顯示 ironSource Ads 廣告，並涵蓋瀑布流程整合作業。本篇文章將說明如何將 ironSource Ads 新增至廣告單元的中介設定，以及如何將 ironSource Ads SDK 和轉接程式整合至 Flutter 應用程式。

支援的整合和廣告格式

適用於 ironSource Ads 的 AdMob 中介服務轉接器具有下列功能：

² 此格式僅支援瀑布式整合。

需求條件

• 最新版 Google Mobile Ads SDK
• Flutter 3.7.0 以上版本
• 如何在 Android 上部署
  • Android API 級別 21 以上
• 如何在 iOS 上部署應用程式
  • iOS 部署目標為 12.0 以上版本
• 使用 Google Mobile Ads SDK 設定的正常運作 Flutter 專案。詳情請參閱「開始使用」一文。
• 完成中介服務入門指南

步驟 1：在 ironSource Ads UI 中設定設定

註冊並登入 ironSource Ads 帳戶。

新增應用程式

如要新增應用程式，請依序前往「廣告」 >「應用程式」，然後按一下「新增應用程式」。

填寫表單，然後按一下「新增應用程式」。

記下「App Key」，然後選取應用程式支援的廣告格式，並按一下「Continue」。

建立執行個體

接著，為新增的應用程式設定執行個體。

找出 Reporting API 金鑰

開啟測試模式

請按照 ironSource Ads 整合測試指南中的操作說明，啟用 ironSource Ads 測試廣告。

步驟 2：在 AdMob UI 中設定 ironSource Ads 需求

設定廣告單元的中介服務設定

將 ironSource Mobile 新增至 GDPR 和美國州級法規廣告合作夥伴名單

請按照「歐洲法規設定」和「美國州級法規設定」中的步驟，將 ironSource Mobile 新增至 AdMob 使用者介面中的歐洲和美國州級法規廣告合作夥伴名單。

步驟 3：匯入 ironSource Ads SDK 和轉接程式

透過 pub.dev 整合

(僅限 Android) 將下列存放區新增至專案 android 目錄中的 build.gradle 檔案：

  repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://android-sdk.is.com/")
      }
  }

在套件的 pubspec.yaml 檔案中，新增下列依附元件，其中包含最新版本的 ironSource Ads SDK 和轉接程式：

dependencies:
  gma_mediation_ironsource: ^1.0.0

手動整合

下載最新版的 Google 行動廣告中介插件 (適用於 ironSource 廣告)，解壓縮下載的檔案，然後將解壓縮的插件資料夾 (及其內容) 新增至您的 Flutter 專案。接著，請新增下列依附元件，在 pubspec.yaml 檔案中參照外掛程式：

dependencies:
  gma_mediation_ironsource:
    path: path/to/local/package

步驟 4：在 ironSource Ads SDK 中導入隱私權設定

歐盟同意聲明和 GDPR

根據 Google 的《歐盟地區使用者同意授權政策》，您必須確保向歐洲經濟區 (EEA) 境內使用者揭露特定資訊，並徵得使用者同意聲明，才能使用裝置 ID 和個人資料。本政策是配合《歐盟電子通訊隱私指令》和《一般資料保護規則》(GDPR) 的法規而制定。在徵求同意聲明時，您必須指出中介服務鏈中可能會收集、接收或使用個人資料的每個廣告聯播網，並提供每個聯播網的使用方式相關資訊。Google 目前無法自動將使用者的同意聲明選項傳送至這些網路。

適用於 ironSource Ads 的 Google 行動廣告中介插件包含 GmaMediationIronsource().SetConsent() 方法。以下程式碼範例說明如何將同意資訊傳遞至 ironSource Ads SDK。如果您選擇呼叫這個方法，建議您在透過 Google Mobile Ads SDK 要求廣告之前先呼叫這個方法。

import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...

GmaMediationIronsource().setConsent(true);

如需詳細資訊，請參閱 ironSource Ads 的法規進階設定說明文件。

美國州級隱私權法律

美國州級隱私權法律 規定使用者有權選擇拒絕「販售」自己的「個人資訊」(相關字詞定義請參見法律規定)，且「賣方」必須在首頁提供顯眼的「不要販售我的個人資訊」連結，供使用者進行設定。美國州級隱私權法律遵循指南提供啟用 Google 廣告放送服務的受限資料處理功能，但 Google 無法將這項設定套用至中介鏈中的每個廣告聯播網。因此，您必須在中介服務鏈中找出可能參與個人資訊販售活動的每個廣告聯播網，並遵循各個聯播網的指示，確保符合規定。

適用於 ironSource Ads 的 Google 行動廣告中介插件包含 GmaMediationIronsource().setDoNotSell 方法。以下程式碼範例說明如何將同意資訊傳遞至 ironSource Ads SDK。您必須先設定這些選項，再初始化 Google Mobile Ads SDK，才能確保這些選項能正確轉送至 ironSource Ads SDK。

import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...

GmaMediationIronsource().setDoNotSell(true);

如要進一步瞭解 Regulation Advanced Settings 的詳細資訊，以及可在該方法中提供的值，請參閱 ironSource Ads 的說明文件 (適用於 Android 和 iOS)。

步驟 5：新增必要程式碼

@Override
public void onResume() {
    super.onResume();
    IronSource.onResume(this);
}

@Override
public void onPause() {
    super.onPause();
    IronSource.onPause(this);
}

public override fun onResume() {
    super.onResume()
    IronSource.onResume(this)
}

public override fun onPause() {
    super.onPause()
    IronSource.onPause(this)
}

步驟 6：測試導入作業

啟用測試廣告

請務必為 AdMob 註冊測試裝置，並在 ironSource Ads 使用者介面中啟用測試模式。

驗證測試廣告

如要確認您收到來自 ironSource Ads 的測試廣告，請使用 ironSource Ads (出價) 和 ironSource Ads (刊登序列) 廣告來源，在廣告檢查器中啟用單一廣告來源測試。

錯誤代碼

如果轉接器無法從 ironSource Ads 接收廣告，發布商可以使用下列類別中的 ResponseInfo，檢查廣告回應的底層錯誤：

com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

以下是 ironSource Ads 轉接程式在廣告載入失敗時，所擲回的代碼和隨附訊息：

ironSource Flutter 中介服務轉接器變更記錄

下一個版本

• iOS 外掛程式現在是靜態架構。
• 已確認與 ironSource Android 轉接器 8.6.1.0 版的相容性
• 已確認與 ironSource iOS 轉接器 8.6.0.0.0 相容
• 使用 Google 行動廣告 Flutter 外掛程式 5.3.1 版本建構及測試。

1.0.0

• 第 1 版。
• 已確認與 ironSource Android 轉接器 8.0.0.0 版的相容性
• 已確認與 ironSource iOS 轉接器 8.0.0.0.0 相容
• 使用 Google 行動廣告 Flutter 外掛程式 5.1.0 版進行建構及測試。