本指南說明如何使用 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 資訊主頁,請按一下「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 需求
調整廣告單元中介服務設定
將 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
接著,前往「Window」>「Package Manager」開啟 Unity Package Manager,然後從下拉式選單中選取「My Registries」。
選取「Google Mobile Ads IronSource Mediation」套件,然後按一下「安裝」。
Unity 套件
從變更記錄中的下載連結,下載最新版的 IronSource 專用 Google 行動廣告中介插件,然後從 ZIP 檔案中擷取 GoogleMobileAdsIronSourceMediation.unitypackage
。
在 Unity 專案編輯器中,依序選取「Assets」>「Import Package」>「Custom Package」,然後找出您下載的 GoogleMobileAdsIronSourceMediation.unitypackage
檔案。確認已選取所有檔案,然後按一下「Import」。
接著,依序選取「Assets」>「External Dependency Manager」>「Android Resolver」>「Force Resolve」。外部依附元件管理員程式庫會從頭執行依附元件解析作業,並將已宣告的依附元件複製到 Unity 應用程式的 Assets/Plugins/Android
目錄中。
步驟 4:在 ironSource Ads SDK 上導入隱私權設定
歐盟同意聲明和 GDPR
根據 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 的說明文件 (適用於 Android 和 iOS)。
步驟 5:新增必要程式碼
Android
Proguard 規則
如果您縮減、模糊化及最佳化應用程式,專案會需要額外的 ProGuard 規則,以使用 IronSource 廣告。
建構專案時,請選取「Android」做為「Platform」。接著,開啟「Player Settings」,然後勾選「Publishing Settings」分頁下方的「User Proguard File」。Unity 應會顯示自訂 proguard-user.txt
檔案的建立位置,方便您修改。
請參閱 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 版
- 支援 IronSource Android 轉接器 8.4.0.0 版。
- 支援 IronSource iOS 轉接器 8.4.0.0.0 版。
- 使用 Google 行動廣告 Unity 外掛程式 9.2.1 版建構及測試。
3.3.1 版
- 支援 IronSource Android 轉接器 8.3.0.0 版。
- 支援 IronSource iOS 轉接程式 8.3.0.0.1 版。
- 使用 Google 行動廣告 Unity 外掛程式 9.2.0 版進行建構及測試。
3.3.0 版
- 支援 IronSource Android 轉接器 8.3.0.0 版。
- 支援 IronSource iOS Adapter 8.3.0.0.0。
- 使用 Google 行動廣告 Unity 外掛程式 9.2.0 版進行建構及測試。
3.2.1 版
DummyClient
已重新命名為PlaceholderClient
。- 支援 IronSource Android 轉接器 8.2.1.0 版。
- 支援 IronSource iOS 轉接器 8.2.0.0.0 版。
- 使用 Google 行動廣告 Unity 外掛程式 9.2.0 版進行建構及測試。
3.2.0 版
- 支援 IronSource Android 轉接器 8.2.0.0 版。
- 支援 IronSource iOS 轉接器 8.2.0.0.0 版。
- 使用 Google 行動廣告 Unity 外掛程式 9.1.1 版建構及測試。
3.1.1 版
- 支援 IronSource Android 轉接器 8.1.0.0 版。
- 支援 IronSource iOS Adapter 8.1.1.0.0。
- 使用 Google 行動廣告 Unity 外掛程式 9.1.1 版建構及測試。
3.1.0 版
- 支援 IronSource Android 轉接程式 8.1.0.0 版。
- 支援 IronSource iOS 轉接程式 8.1.0.0.1 版。
- 使用 Google 行動廣告 Unity 外掛程式 9.1.0 版進行建構及測試。
3.0.1 版
- 支援 IronSource Android 轉接器 8.0.0.1 版。
- 支援 IronSource iOS 轉接程式 8.0.0.0.1 版。
- 使用 Google 行動廣告 Unity 外掛程式 9.1.0 版進行建構及測試。
3.0.0 版
- 支援 IronSource Android 轉接器 8.0.0.0 版。
- 支援 IronSource iOS 轉接器 8.0.0.0.0。
- 使用 Google 行動廣告 Unity 外掛程式 9.0.0 版建立並測試。
2.6.1 版
- 支援 IronSource Android 轉接程式 7.9.0.0 版。
- 支援 IronSource iOS 轉接程式 7.9.1.0.0 版。
- 使用 Google 行動廣告 Unity 外掛程式 9.0.0 版建立並測試。
2.6.0 版
- 支援 IronSource Android 轉接程式 7.9.0.0 版。
- 支援 IronSource iOS 轉接程式 7.9.0.0.0 版。
- 使用 Google 行動廣告 Unity 外掛程式 9.0.0 版進行建構及測試。
2.5.0 版
- 支援 IronSource Android 轉接程式 7.6.0.0 版。
- 支援 IronSource iOS 轉接程式 7.6.0.0 版。
- 使用 Google 行動廣告 Unity 外掛程式 8.6.0 版進行建構及測試。
2.4.0 版
- 支援 IronSource Android 轉接器 7.5.2.0 版。
- 支援 IronSource iOS 轉接程式 7.5.1.0 版。
- 使用 Google 行動廣告 Unity 外掛程式 8.6.0 版進行建構及測試。
2.3.1 版
- 支援 IronSource Android 轉接程式 7.3.1.0 版。
- 支援 IronSource iOS 轉接程式 7.3.1.0.0 版。
- 使用 Google 行動廣告 Unity 外掛程式 8.3.0 版進行建構及測試。
2.3.0 版
- 已將轉接器內容移至
GoogleMobileAds/Mediation/IronSource/
。 - 重構轉接程式命名空間,以便使用
GoogleMobileAds.Mediation.IronSource
。 - 支援 IronSource Android 轉接程式 7.3.0.1.0 版。
- 支援 IronSource iOS Adapter 7.3.0.0.0。
- 使用 Google 行動廣告 Unity 外掛程式 8.1.0 版進行建構及測試。
2.2.7 版
- 支援 IronSource Android 轉接器 7.2.7.0 版。
- 支援 IronSource iOS 轉接程式 7.2.7.0.1 版。
- 請使用 Google 行動廣告 Unity 外掛程式 7.4.1 版建立並測試。
2.2.6 版
- 支援 IronSource Android 轉接程式 7.2.6.0 版。
- 支援 IronSource iOS 轉接程式 7.2.6.0.0 版。
- 使用 Google 行動廣告 Unity 外掛程式 7.3.1 版建立並測試。
2.2.5 版
- 支援 IronSource Android 轉接器 7.2.5.0 版。
- 支援 IronSource iOS 轉接程式 7.2.5.1.0 版。
- 使用 Google 行動廣告 Unity 外掛程式 7.3.0 版進行建構及測試。
2.2.4 版
- 已新增
IronSource.SetMetaData(string, string)
方法。 - 支援 IronSource Android 轉接程式 7.2.3.1.0 版。
- 支援 IronSource iOS 轉接器 7.2.4.0 版。
- 使用 Google 行動廣告 Unity 外掛程式 7.2.0 版進行建構及測試。
2.2.3 版
- 支援 IronSource Android 轉接器 7.2.3.1.0 版。
- 支援 IronSource iOS 轉接器 7.2.3.1.0 版。
- 使用 Google 行動廣告 Unity 外掛程式 7.1.0 版進行建構及測試。
2.2.2 版
- 支援 IronSource Android 轉接程式 7.2.2.1.0 版。
- 支援 IronSource iOS 轉接器 7.2.2.1.0 版。
- 使用 Google 行動廣告 Unity 外掛程式 7.0.2 版進行建構及測試。
2.2.1 版
- 支援 IronSource Android 轉接程式 7.2.1.1.0。
- 支援 IronSource iOS Adapter 7.2.1.2.0。
- 使用 Google 行動廣告 Unity 外掛程式 7.0.0 版建立並測試。
2.2.0 版
- 支援 IronSource Android 轉接器 7.2.1.0 版。
- 支援 IronSource iOS 轉接程式 7.2.1.0 版。
- 使用 Google 行動廣告 Unity 外掛程式 7.0.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 版。