整合 ironSource 廣告與中介服務

本指南說明如何使用 Google Mobile Ads SDK 透過中介服務載入並顯示 ironSource Ads 廣告,並涵蓋瀑布流程整合作業。內容包括如何在廣告單元的中介服務設定中加入 ironSource 廣告,以及如何將 ironSource Ads SDK 和轉接程式整合至 Unity 應用程式。

支援的整合和廣告格式

ironSource Ads 的 AdMob 中介服務轉接器具有下列功能:

整合
出價  1
瀑布
格式
橫幅廣告  2
插頁式
已獲得獎勵
插頁式獎勵廣告  2

1出價整合目前仍在 Beta 版封測階段,請向您的客戶經理要求存取權。

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

需求條件

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

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

註冊登入 ironSource Ads 帳戶。

如要將應用程式新增至 ironSource Ads 資訊主頁,請按一下「New App」按鈕。

輸入應用程式詳細資料

選取「Live App」,輸入應用程式名稱,然後按一下「匯入應用程式資訊」

如果您的應用程式尚未上架,請選取「應用程式尚未在應用程式商店上架」,並為應用程式提供暫時名稱。選取平台

填寫表單的其餘部分,然後按一下「新增應用程式」

請記下新的應用程式金鑰,這會在新增應用程式後顯示。您需要這個值才能設定 AdMob 廣告單元 ID。選取應用程式支援的廣告格式。然後按一下「繼續」

Android

iOS

建立執行個體

接著,為所新增的應用程式設定網路例項。

出價

依序前往「LevelPlay」>「設定」>「SDK 聯播網」,然後選取您的應用程式。按一下「出價」下方的編輯圖示,即可查看出價執行個體 ID。

Android

iOS

記下「執行個體 ID」

Android

iOS

瀑布

依序前往「廣告」>「設定」>「執行個體」。選取應用程式,然後按一下「建立執行個體」

輸入必要詳細資料,然後按一下「儲存並關閉」

建立執行個體後,「Instance ID」欄位會列出執行個體 ID。

找出 Reporting API 金鑰

出價

出價整合不需要執行這個步驟。

瀑布

除了「應用程式金鑰」和「執行個體 ID」以外,您還需要自己的 ironSource 廣告密鑰更新憑證,才能設定 AdMob 廣告單元 ID。

前往 ironSource 廣告發布商資訊主頁中的「我的帳戶」,然後按一下「API」分頁標籤。請記下密鑰重新整理權杖

開啟測試模式

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

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

調整廣告單元中介服務設定

Android

如需操作說明,請參閱 Android 指南的步驟 2。

iOS

相關操作說明請參閱 iOS 指南中的步驟 2。

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

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

步驟 3:匯入 ironSource 廣告 SDK 和轉接程式

OpenUPM-CLI

如果您已安裝 OpenUPM-CLI,只要從專案的根目錄執行下列指令,即可將 Google 行動廣告 IronSource 媒合外掛程式 (適用於 Unity) 安裝到專案中:

openupm add com.google.ads.mobile.mediation.ironsource

OpenUPM

在 Unity 專案編輯器中,依序選取「Edit」>「Project Settings」>「Package Manager」,即可開啟 Unity Package Manager Settings

在「Scoped Registries」分頁下方,將 OpenUPM 新增為受限登錄,並提供下列詳細資料:

  • 名稱:OpenUPM
  • 網址:https://package.openupm.com
  • 範圍:com.google

OpenUPM 詳細資料

接著,前往「Window」>「Package Manager」開啟 Unity Package Manager,然後從下拉式選單中選取「My Registries」

Unity 登錄檔

選取「Google Mobile Ads IronSource Mediation」套件,然後按一下「安裝」

透過 OpenUPM 安裝

Unity 套件

變更記錄中的下載連結,下載最新版的 IronSource 專用 Google 行動廣告中介插件,然後從 ZIP 檔案中擷取 GoogleMobileAdsIronSourceMediation.unitypackage

在 Unity 專案編輯器中,依序選取「Assets」>「Import Package」>「Custom Package」,然後找出您下載的 GoogleMobileAdsIronSourceMediation.unitypackage 檔案。確認已選取所有檔案,然後按一下「Import」

從 Unity 匯入

接著,依序選取「Assets」>「External Dependency Manager」>「Android Resolver」>「Force Resolve」。外部依附元件管理員程式庫會從頭執行依附元件解析作業,並將已宣告的依附元件複製到 Unity 應用程式的 Assets/Plugins/Android 目錄中。

強制解析

步驟 4:在 ironSource Ads SDK 上導入隱私權設定

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

ironSource Ads 專用的 Google Mobile Ads 中介服務外掛程式 1.0.0 版 包含 IronSource.SetConsent() 方法。以下程式碼範例說明如何將同意資訊傳遞至 ironSource Ads SDK。如果選擇呼叫此方法,建議先完成此操作,再透過 Google Mobile Ads SDK 請求廣告。

using GoogleMobileAds.Api.Mediation.IronSource;
// ...

IronSource.SetConsent(true);

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

美國州級隱私權法律

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

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

using GoogleMobileAds.Api.Mediation.IronSource;
// ...

IronSource.SetMetaData("do_not_sell", "true");

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

步驟 5:新增必要程式碼

Android

Proguard 規則

如果您縮減、模糊化及最佳化應用程式,專案會需要額外的 ProGuard 規則,以使用 IronSource 廣告。

建構專案時,請選取「Android」做為「Platform」。接著,開啟「Player Settings」,然後勾選「Publishing Settings」分頁下方的「User Proguard File」。Unity 應會顯示自訂 proguard-user.txt 檔案的建立位置,方便您修改。

Unity 使用者 Proguard 檔案

請參閱 IronSource Ads 的 Android SDK 整合指南,進一步瞭解專案需要哪些 ProGuard 規則,並將這些規則新增至 proguard-user.txt 檔案。

iOS

SKAdNetwork 整合

請按照 ironSource Ads 的說明文件將 SKAdNetwork 識別碼新增至專案的 Info.plist 檔案。

步驟 6:測試實作成果

啟用測試廣告

請務必為 AdMob 註冊測試裝置,並在 ironSource Ads UI 中啟用測試模式

驗證測試廣告

為驗證您會從 IonSource Ads 收到測試廣告,請使用 ironSource Ads (Bidding) 和 ironSource 廣告 (Waterfall) 廣告來源在廣告檢查器中啟用單一廣告來源測試

錯誤代碼

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

Android

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

iOS

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

以下是當廣告無法載入時,ironSource Ads 轉接器所擲回的程式碼和隨附訊息:

Android

錯誤代碼 原因
101 在 AdMob 使用者介面中設定的 ironSource Ads 伺服器參數遺失/無效。
102 ironSource Ads 需要活動內容,才能初始化 SDK。
103 ironSource 廣告針對每個 ironSource 執行個體 ID 只能載入 1 則廣告。
105 ironSource 廣告不支援要求的橫幅廣告大小。
106 未初始化 ironSource Ads SDK。
501-1056 ironSource Ads SDK 錯誤。詳情請參閱說明文件

iOS

錯誤代碼 原因
101 在 AdMob 使用者介面中設定的 ironSource Ads 伺服器參數遺失/無效。
102 ironSource Ads Adapter 不支援所要求的廣告格式。
103 系統已為這個聯播網設定檔載入 ironSource 廣告。
104 ironSource 廣告不支援要求的橫幅廣告大小。
508-1037 ironSource Ads SDK 錯誤。詳情請參閱說明文件

IronSource Unity 中介服務外掛程式變更記錄

3.4.0 版

3.3.1 版

3.3.0 版

3.2.1 版

3.2.0 版

3.1.1 版

3.1.0 版

3.0.1 版

3.0.0 版

2.6.1 版

2.6.0 版

2.5.0 版

2.4.0 版

2.3.1 版

2.3.0 版

2.2.7 版

2.2.6 版

2.2.5 版

2.2.4 版

2.2.3 版

2.2.2 版

2.2.1 版

2.2.0 版

2.1.5 版

2.1.4 版

2.1.3 版

2.1.2 版

2.1.1 版

2.1.0 版

2.0.3 版

2.0.2 版

2.0.1 版

2.0.0 版

1.10.0 版

1.9.1 版

1.9.0 版

1.8.2 版

1.8.1 版

1.8.0 版

1.7.0 版

1.6.0 版

1.5.0 版本

1.4.0 版本

1.3.2 版

1.3.1 版本

  • 支援 IronSource Android 轉接器 6.10.0.0 版
  • 支援 IronSource iOS 轉接器 6.8.6.0 版

1.3.0 版本

  • 支援 IronSource Android 轉接器 6.10.0.0 版
  • 支援 IronSource iOS 轉接程式 6.8.4.1.0 版

1.2.0 版本

  • 支援 IronSource Android 轉接器 6.9.0.1 版
  • 支援 IronSource iOS 轉接程式 6.8.4.1.0 版

1.1.2 版本

  • 支援 IronSource Android 轉接器 6.8.4.1 版
  • 支援 IronSource iOS 轉接器 6.8.4.1 版

1.1.1 版

  • 支援 IronSource Android 轉接器 6.8.4.1 版
  • 支援 IronSource iOS 轉接器 6.8.3.0 版

1.1.0 版本

  • 更新外掛程式,以支援新的公開測試版 Rewarded API。
  • 支援 IronSource Android 轉接器 6.8.1.2 版
  • 支援 IronSource iOS 轉接器 6.8.0.1 版

1.0.4 版本

  • 支援 IronSource Android 轉接器 6.7.11.0 版
  • 支援 IronSource iOS 轉接器 6.7.11.0 版

1.0.3 版本

  • 支援 IronSource Android 轉接器 6.7.10.0 版
  • 支援 IronSource iOS 轉接器 6.7.10.0 版

1.0.2 版

  • 支援 IronSource Android 轉接器 6.7.9.1.1 版
  • 支援 IronSource iOS 轉接器 6.7.10.0 版
  • 修正與 Chartboost Unity 中介插件發生的衝突。

1.0.1 版

  • 支援 IronSource Android 轉接器 6.7.9.0 版。
  • 支援 IronSource iOS 轉接程式 6.7.9.2.0 版。

1.0.0 版本

  • 第一版!
  • 支援 IronSource Android 轉接器 6.7.9.0 版。
  • 支援 IronSource iOS 轉接程式 6.7.9.1.0 版。