本指南將說明如何使用 Google Mobile Ads SDK 載入及顯示 從 ironSource 廣告 中介服務,涵蓋刊登序列 整合。說明如何在廣告單元的 中介服務設定,以及如何整合 ironSource Ads SDK 和轉接程式 位置 Unity
支援的整合項目和廣告格式
ironSource 廣告的 Ad Manager 中介服務轉接程式 下列功能:
整合 | |
---|---|
出價 | |
瀑布 | |
格式 | |
橫幅廣告 | |
插頁式 | |
已獲得獎勵 | |
插頁式獎勵廣告 |
需求條件
- 最新版 Google Mobile Ads SDK
- Unity 4 以上版本
- 如何在 Android 上部署
- Android API 級別 21 以上
- 如何在 iOS 上部署
- iOS 部署目標為 12.0 以上版本
- 使用 Google 設定的 Unity 有效專案 Mobile Ads SDK詳情請見 詳情請參閱開始使用。
- 完成中介服務 入門指南
步驟 1:在 ironSource 廣告使用者介面中設定設定
如要將應用程式新增至 ironSource Ads 資訊主頁,請按一下「New App」按鈕。
輸入應用程式詳細資料
選取「Live App」,輸入應用程式的 網址,然後按一下「Import App Info」。
如果應用程式無法使用,請選取「App Not Live in Application Store」,然後為應用程式提供「臨時名稱」。選取您的「平台」。
填寫表單的其他部分,然後按一下「Add App」。
請記下新加入應用程式後顯示的應用程式金鑰。設定Ad Manager 廣告單元 ID 時,需要用到這個值。選取您的應用程式支援的廣告格式。然後按一下 [繼續]。
Android
iOS
建立執行個體
接下來,為您新增的應用程式設定網路執行個體。
依序前往「廣告」 >「設定」 >「執行個體」。選取應用程式,然後按一下「Create Instance」。
輸入必要的詳細資料,然後按一下「儲存並關閉」。
執行個體建立完成後,「Instance ID」欄位中會列出執行個體 ID。
找出 Reporting API 金鑰
除了 App Key (應用程式金鑰) 和 Instance ID 以外,您還需要使用 ironSource Ads 密鑰和「Refresh Token」,才能設定Ad Manager 廣告單元 ID。
前往ironSource Ads 發布商資訊主頁中的「我的帳戶」,然後按一下「API」分頁標籤。請記下您的密鑰和更新權杖。
開啟測試模式
請按照 ironSource Ads 的整合測試指南中的操作說明啟用 ironSource Ads 測試廣告。
步驟 2:在使用者介面中設定 ironSource 廣告需求 Ad Manager
調整廣告單元中介服務設定
新增 ironSource Mobile 至 GDPR 和美國州級法規廣告合作夥伴名單
請按照 GDPR 設定 和 美國州級法規設定 ,在 Ad Manager UI 和美國州級法規廣告合作夥伴清單中新增 ironSource Mobile。
步驟 3:匯入 ironSource 廣告 SDK 和轉接程式
下載最新版的 ironSource 專用 Google 行動廣告中介服務外掛程式
點選這個連結,即可從下載連結前往
變更記錄,然後將
ZIP 檔案中的 GoogleMobileAdsIronSourceMediation.unitypackage
。
在 Unity 專案編輯器中,依序選取「Assets」>「Assets」匯入套件 >自訂
套件並找出 GoogleMobileAdsIronSourceMediation.unitypackage
檔案
下載。確認已選取所有檔案,然後按一下「匯入」。
然後選取「素材資源」>「Play 服務解析器 >Android 解析器 >強制
解決。Unity Play 服務解析器程式庫將執行依附元件
然後將宣告的依附元件複製到
Assets/Plugins/Android
目錄。
步驟 4:在 ironSource Ads SDK 上導入隱私權設定
歐盟地區同意授權和 GDPR
根據 Google 歐盟地區使用者同意聲明 Google 政策,您必須確保使用者有揭露特定揭露事項。 只有當歐洲經濟區 (EEA) 使用者提供同意聲明,以及 如何使用裝置 ID 和個人資料這項政策反映的是 歐盟電子通訊隱私指令和一般資料保護規定 法規 (GDPR)。徵求同意時,您必須指明每個廣告聯播網 中介服務鏈中可能收集、接收或使用個人資料,並 提供各個網路用量的相關資訊。Google 目前無法 將使用者的同意聲明選項自動傳送到這類聯播網。
ironSource Ads 專用的 Google 行動廣告中介服務外掛程式
1.0.0 版
包含
IronSource.SetConsent()
方法。下列程式碼範例說明如何
將 ironSource Ads SDK 的同意聲明資訊傳送給 ironSource Ads SDK。如果您選擇將此名稱命名為
方法,建議您在透過
Google Mobile Ads SDK。
using GoogleMobileAds.Api.Mediation.IronSource;
// ...
IronSource.SetConsent(true);
查看 ironSource Ads 的說明文件 法規進階設定 ,掌握更多詳細資訊。
美國州級隱私權法律
美國州級隱私權法律 規定使用者必須提供 即可選擇停用「銷售」功能的「個人資訊」(如同法律定義 該條款中,透過顯眼的「請勿銷售我的個人」 資訊」請點選「銷售」裝置上的「銷售」連結以及派對首頁 美國州級隱私權 法規遵循指南可讓您 受限的資料處理 此設定不適用於每則廣告,但 Google 無法將這項設定套用至每則廣告 中介服務鏈中的聯播網因此,你必須找出每個廣告聯播網。 可參與個人銷售的 並遵循各自的指南 確保符合法規。
ironSource Ads 專用的 Google 行動廣告中介服務外掛程式
2.2.4 版
包含
IronSource.SetMetaData()
方法。下列程式碼範例說明如何
將 ironSource Ads SDK 的同意聲明資訊傳送給 ironSource Ads SDK。這些選項必須早於
您在設定 Google 行動廣告時
SDK
以確保它們正確轉送到 ironSource Ads SDK。
using GoogleMobileAds.Api.Mediation.IronSource;
// ...
IronSource.SetMetaData("do_not_sell", "true");
請參閱 ironSource Ads 的「法規進階設定」說明文件 Android 和 iOS ,以及在方法中提供的值。
步驟 5:新增必要的程式碼
Android
Proguard 規則
如果您縮減、模糊化及最佳化應用程式, 專案必須設定額外的 ProGuard 規則,才能在 IronSource 廣告中使用。
建構專案時,請選取「Android」做為「Platform」。接著:
開啟「Player Settings」,然後勾選「User Proguard File」下方的
Unity 應會顯示
系統為您建立了 proguard-user.txt
個檔案,方便您修改。
諮詢
IronSource Ads 的 Android SDK 整合指南
如要進一步瞭解專案需要哪些 ProGuard 規則,
並在 proguard-user.txt
檔案中新增這些規則。
iOS
SKAdNetwork 整合
請按照 ironSource Ads 的說明文件將 SKAdNetwork ID 加進
專案的 Info.plist
檔案
步驟 6:測試實作成果
啟用測試廣告
請務必為Ad Manager 註冊測試裝置,並在 ironSource 使用者介面中啟用測試模式。
驗證測試廣告
如要確認您正在接收來自ironSource的測試廣告,請使用 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 | 在 UI 中設定的 ironSource Ads 伺服器參數遺失或無效。 Ad Manager |
102 | ironSource 廣告需要 Activity 內容才能初始化 SDK。 |
103 | ironSource 廣告針對每個 ironSource 執行個體 ID 只能載入 1 則廣告。 |
105 | ironSource 廣告不支援要求的橫幅廣告大小。 |
106 | ironSource Ads SDK 未初始化。 |
501-1056 | ironSource 廣告 SDK 錯誤。請參閱說明文件 ,掌握更多詳細資訊。 |
iOS
錯誤代碼 | 原因 |
---|---|
101 | 在 UI 中設定的 ironSource Ads 伺服器參數遺失或無效。 Ad Manager |
102 | ironSource Ads 轉接程式不支援要求的廣告格式。 |
103 | 已載入此網路設定的 ironSource 廣告。 |
104 | ironSource 廣告不支援要求的橫幅廣告大小。 |
508-1037 | ironSource 廣告 SDK 錯誤。請參閱說明文件 ,掌握更多詳細資訊。 |
IronSource Unity 外掛程式變更記錄
3.2.1 版
DummyClient
已重新命名為PlaceholderClient
。- 支援 IronSource Android 轉接器 8.2.1.0 版。
- 支援 IronSource iOS Adapter 8.2.0.0.0。
- 使用 Google 行動廣告 Unity 外掛程式 9.2.0 版建立並測試。
3.2.0 版
- 支援 IronSource Android 轉接器 8.2.0.0 版。
- 支援 IronSource iOS Adapter 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 Adapter 8.1.0.0.1。
- 使用 Google 行動廣告 Unity 外掛程式 9.1.0 版建立並測試。
3.0.1 版
- 支援 IronSource Android 轉接器 8.0.0.1 版。
- 支援 IronSource iOS Adapter 8.0.0.0.1。
- 使用 Google 行動廣告 Unity 外掛程式 9.1.0 版建立並測試。
3.0.0 版
- 支援 IronSource Android 轉接器 8.0.0.0 版。
- 支援 IronSource iOS Adapter 8.0.0.0.0。
- 使用 Google 行動廣告 Unity 外掛程式 9.0.0 版建立並測試。
2.6.1 版
- 支援 IronSource Android 轉接器 7.9.0.0 版。
- 支援 IronSource iOS Adapter 7.9.1.0.0。
- 使用 Google 行動廣告 Unity 外掛程式 9.0.0 版建立並測試。
2.6.0 版
- 支援 IronSource Android 轉接器 7.9.0.0 版。
- 支援 IronSource iOS Adapter 7.9.0.0.0。
- 使用 Google 行動廣告 Unity 外掛程式 9.0.0 版建立並測試。
2.5.0 版
- 支援 IronSource Android 轉接器 7.6.0.0 版。
- 支援 IronSource iOS Adapter 7.6.0.0。
- 請使用 Google 行動廣告 Unity 外掛程式 8.6.0 版建立並測試。
2.4.0 版
- 支援 IronSource Android 轉接器 7.5.2.0 版。
- 支援 IronSource iOS Adapter 7.5.1.0。
- 請使用 Google 行動廣告 Unity 外掛程式 8.6.0 版建立並測試。
2.3.1 版
- 支援 IronSource Android 轉接器 7.3.1.0 版。
- 支援 IronSource iOS Adapter 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 Adapter 7.2.7.0.1。
- 請使用 Google 行動廣告 Unity 外掛程式 7.4.1 版建立並測試。
2.2.6 版
- 支援 IronSource Android 轉接器 7.2.6.0 版。
- 支援 IronSource iOS Adapter 7.2.6.0.0。
- 使用 Google 行動廣告 Unity 外掛程式 7.3.1 版建立並測試。
2.2.5 版
- 支援 IronSource Android 轉接器 7.2.5.0 版。
- 支援 IronSource iOS Adapter 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 Adapter 7.2.4.0。
- 請使用 Google 行動廣告 Unity 外掛程式 7.2.0 版建立並測試。
2.2.3 版
- 支援 IronSource Android 轉接器 7.2.3.1.0 版。
- 支援 IronSource iOS Adapter 7.2.3.1.0。
- 使用 Google 行動廣告 Unity 外掛程式 7.1.0 版建立並測試。
2.2.2 版
- 支援 IronSource Android 轉接器 7.2.2.1.0 版。
- 支援 IronSource iOS Adapter 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 Adapter 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 版本
- 更新外掛程式,以支援新的 Open-beta 獎勵 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 版。