與中介服務整合

本指南將說明如何使用 Google Mobile Ads SDK 透過中介服務載入並顯示刊登序列整合的廣告。我們會說明如何將外掛程式新增至廣告單元的中介服務設定，以及如何將 Nend SDK 和轉接程式整合到 Unity 應用程式中。

外掛程式的資訊主頁介面為標籤、按鈕和說明使用日文文字，且下方顯示的螢幕截圖尚未翻譯。然而，在本指南的文字中，標籤和按鈕以英文名稱表示。例如「URL ススーム」，例如「URL Scheme」。

支援的整合項目和廣告格式

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

需求條件

  • Unity 4 以上版本
  • 最新版 Google Mobile Ads SDK
  • 如要在 Android 上部署應用程式，請執行下列動作：
    • Android API 級別 19 以上
  • 如何在 iOS 上部署
    • 12.0 以上版本的 iOS 部署目標
  • 使用 Google Mobile Ads SDK 設定的運作中 Unity 專案。詳情請參閱開始使用一文。
  • 完成中介服務 入門指南

步驟 1：在前端 UI 中進行設定

註冊或登入您的代管帳戶。

如要將應用程式新增至前端資訊主頁，請先按一下「刊登位置管理」分頁標籤，然後選取「網站/應用程式」。再按一下「新增應用程式」按鈕，即可將應用程式新增至前端資訊主頁。

建立應用程式

輸入應用程式名稱，並選擇應用程式平台做為應用程式類型。輸入網址，然後檢查您的應用程式是否列在適用的應用程式商店中

如果您的應用程式尚未發布，請參閱尚未發布的應用程式常見問題。選取應用程式的類別，並在完成後按一下「Create」(建立)。

Android

iOS

建立後，應用程式就會顯示在資訊主頁上。

Android

iOS

建立刊登位置

應用程式註冊完成後，您就可以繼續建立刊登位置。如要建立橫幅廣告的刊登位置，請前往「刊登位置管理」分頁，然後按一下「刊登位置」。然後按一下 [建立新的刊登位置] 按鈕。

在下拉式選單中選取您的應用程式。然後根據您偏好的廣告格式，按照對應操作說明進行。

為「廣告類型」選擇「靜態圖片」，針對「廣告空間類型」選擇「橫幅」。完成後，請輸入「刊登位置名稱」、填寫「廣告空間簡介」，選擇「廣告空間格式」，最後選擇「廣告空間大小」。 完成後，按一下 [建立] 按鈕即可建立刊登位置。

插頁式

為「廣告類型」選擇「靜態圖片」，並在「廣告空間類型」部分選擇「插頁式廣告」。完成後，請輸入「刊登位置名稱」、填寫「廣告空間簡介」，然後在下拉式清單中選取「廣告顯示頻率」。 完成後，按一下 [建立] 按鈕即可建立刊登位置。

如果是插頁式影片廣告，請為「廣告類型」選擇「影片」，在「廣告空間類型」部分選擇「插頁式」。完成後，請輸入「刊登位置名稱」、填寫「廣告空間簡介」，然後從下拉式清單中選擇適當的「類別」。完成後，按一下 [建立] 按鈕即可建立刊登位置。

已獲得獎勵

在「廣告類型」中選取「影片」，針對「廣告空間類型」選擇「獎勵」。完成後，請輸入「刊登位置名稱」、填寫「廣告空間簡介」，然後從下拉式清單中選擇適當的「類別」。

在「獎勵設定」下方，使用下拉式清單選取「獎勵內容」，然後輸入您偏好的「虛擬貨幣名稱」。完成後，按一下 [建立] 按鈕即可建立刊登位置。

原生

在「廣告類型」部分，選擇「靜態圖片」，在「廣告空間類型」部分則選擇「原生」。完成後，請輸入「刊登位置名稱」、填寫「廣告空間簡介」，然後選取「廣告圖片選擇」。 完成後，按一下 [建立] 按鈕即可建立刊登位置。

如果是原生影片廣告，請為「廣告類型」選擇「影片」，並為「廣告空間類型」選擇「原生 (自訂)」。完成後，請輸入「刊登位置名稱」、填寫「廣告空間簡介」，然後從下拉式清單中選擇適當的「類別」。

在「原生廣告設定」下方，從清單中選取「影片廣告方向」和「原生廣告類型」。 完成後，按一下 [建立] 按鈕即可建立刊登位置。

如要在下一節設定 AdMob 廣告單元，您需要為每個刊登位置準備 apiKey 和 spotID。如要找出這些代碼，請前往「刊登位置管理」分頁，然後選取應用程式名稱下方的「SDK」按鈕。

記下 apiKey 和 spotID。

您也必須備妥用來執行報告 API 的 API 金鑰，這些 API 會呼叫 API 金鑰用於抓取。您可以在「工具」分頁中找到這項工具。

步驟 2：在使用者介面中設定 AdMob 買方需求

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

Android

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

iOS

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

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

透過變更記錄中的下載連結，下載最新版的 Google 行動廣告中介服務外掛程式，然後從 zip 檔案擷取 GoogleMobileAdsNendMediation.unitypackage 套件。

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

接著，依序選取「Assets」>「Play Services Resolver」>「Android Resolver」>「Force Resolve」。Unity Play 服務解析器程式庫會從頭開始執行依附元件解析作業，並將宣告的依附元件複製到 Unity 應用程式的 Assets/Plugins/Android 目錄中。

步驟 4：新增必要程式碼

Android

不需額外的程式碼，即可進行端對端整合。

iOS

SKAdNetwork 整合

按照本文的說明，將 SKAdNetwork ID 新增至專案的 Info.plist 檔案。

步驟 5：測試導入狀態

啟用測試廣告

請務必為 AdMob。 如要取得橫幅、插頁式廣告和獎勵廣告的測試廣告，建議您 修正測試廣告單元 頁面所提供的 API 金鑰和 Spot ID。您可以在測試時輸入這些 ID 做為 AdMob 廣告單元的 API 金鑰和 Spot ID，並在應用程式準備就緒時替換為實際的 API 金鑰和 Spot ID。

驗證測試廣告

如要確認您正在接收來自nend的測試廣告，請使用 nend (Waterfall) 廣告來源在廣告檢查器中啟用單一廣告來源測試。

錯誤代碼

如果轉接程式未能接收來自 Nend 的廣告，發布商可以在下列類別下使用 ResponseInfo 查看廣告回應的基礎錯誤：

Android

com.google.ads.mediation.nend.NendAdapter
com.google.ads.mediation.nend.NendRewardedAdapter
com.google.ads.mediation.nend.NendMediationAdapter

iOS

GADMAdapterNend
GADMAdapterNend
GADMAdapterNendRewarded
GADMediationAdapterNend

以下是廣告無法載入時，Nend 轉接程式擲回的程式碼和隨附的訊息：

Android

錯誤代碼 網域 原因
101 com.google.ads.mediation.nend nend 需要活動內容才能載入及顯示廣告。
102 com.google.ads.mediation.nend 使用者介面中設定的 AdMob 後端參數遺失或無效。
103 com.google.ads.mediation.nend 表示廣告尚未準備好顯示。
104 com.google.ads.mediation.nend 無法播放廣告。
105 com.google.ads.mediation.nend 要求的廣告大小與系統支援的橫幅廣告大小不符。
106 com.google.ads.mediation.nend Context 物件參照為 null，且/或最近已從記憶體釋出。
200-299 net.nend.android nend SDK 傳回插頁式廣告載入錯誤。詳情請參閱程式碼。
300-399 net.nend.android nend SDK 傳回插頁式廣告錯誤。詳情請參閱程式碼。
400-499 net.nend.android nend SDK 傳回廣告錯誤。詳情請參閱程式碼。

iOS

錯誤代碼 網域 原因
101 com.google.mediation.nend nend SDK 傳回載入失敗回呼，但沒有額外的錯誤資訊。
102 com.google.mediation.nend nend SDK 傳回顯示失敗回呼，但未傳回其他錯誤資訊。
103 com.google.mediation.nend 使用者介面中設定的 AdMob 後端參數遺失或無效。
104 com.google.mediation.nend 無法載入原生廣告圖片素材資源。
105 com.google.mediation.nend 廣告尚未就緒，因此無法顯示附屬廣告。
106 com.google.mediation.nend 要求的橫幅廣告大小與支援的橫幅廣告大小不符。
200-699 人 由 Nend SDK 傳送。 nend SDK 傳回錯誤。詳情請參閱 Nend 的文件。

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

8.0.0 版

7.0.0 版

6.0.1 版

6.0.0 版

5.2.0 版

5.1.0 版

5.0.0 版

4.0.1 版

4.0.0 版

版本 3.0.0

2.3.0 版

2.2.0 版

2.1.0 版

  • 更新外掛程式以支援新的獎勵 API。
  • 支援 Android 轉接程式 5.1.0.2 版。
  • 支援 iOS 轉接程式 5.1.1.0 版。

2.0.3 版

  • 支援 Android 轉接程式 5.0.2.1 版。
  • 支援 iOS 轉接程式 5.0.2.0 版。

2.0.2 版

  • 支援 Android 轉接程式 5.0.2.0 版。
  • 支援 iOS 轉接程式 5.0.2.0 版。

2.0.1 版

  • 支援 Android 轉接程式 5.0.2.0 版。
  • 支援 iOS 轉接程式 5.0.1.0 版。

2.0.0 版

  • 支援 Android 轉接程式 5.0.0.0 版。
  • 支援 iOS 轉接程式 5.0.0.0 版。

1.0.2 版

  • 支援 Android 轉接程式 4.0.5.0 版。
  • 支援 iOS 轉接程式 4.0.6.0 版。

1.0.1 版

  • 支援 Android SDK 4.0.4 版。
  • 支援 iOS SDK 4.0.4 版。

1.0.0 版本

  • 首次發布！
  • 支援 Android SDK 4.0.2 版。
  • 支援 iOS SDK 4.0.2 版。