將 nend 與中介服務整合

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

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

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

Nend 的 Ad Manager 中介服務轉接程式具有下列功能：

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

需求條件

  • Android API 級別 19 以上

  • 最新版 Google Mobile Ads SDK

  • 完成中介服務 入門指南

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

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

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

建立應用程式

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

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

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

建立刊登位置

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

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

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

插頁式

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

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

已獲得獎勵

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

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

原生

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

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

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

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

記下 apiKey 和 spotID。

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

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

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

登入 Ad Manager 帳戶。

依序前往「廣告放送」>「收益群組」，然後按一下「新增收益群組」按鈕。

輸入收益群組的專屬「名稱」、將「狀態」設為「有效」、選取「廣告格式」，然後將「廣告空間類型」設為「行動應用程式」。接著在「指定目標」>「廣告空間」部分下，在「廣告空間」和「行動應用程式」下方，選取要新增中介服務的廣告單元。

接著，按一下「新增收益夥伴」按鈕。

如果您已經有nend的收益夥伴，則可以選取。否則，請選取「建立新的收益夥伴」。

選取「nend」做為「廣告聯播網」，然後輸入不重複的名稱並啟用「中介服務」。

開啟「自動資料收集」，然後輸入上一節中取得的Reporting API Key from the API Key for Scraping 。

選取 [收益夥伴] 後，請選擇「Mobile SDK 中介服務」做為整合類型，選擇 Android 做為平台，狀態則選為「Active」。輸入上一節中取得的Slot ID and API Key 。然後輸入「預設千次曝光出價」的值。

完成後，按一下頁面下方的「儲存」。

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

在專案層級的 settings.gradle.kts 檔案中，新增下列存放區：

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://fan-adn.github.io/nendSDK-Android-lib/library")
    }
  }
}

接著，在應用程式層級的 build.gradle.kts 檔案中，新增下列實作依附元件和設定。使用最新版本的 Nend SDK 和轉接程式：

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.0.0")
    implementation("com.google.ads.mediation:nend:10.0.0.0")
}

手動整合

  1. 下載最新版本的 Android SDK，並將其新增至專案。

  2. 前往 Google Maven 存放區中的自然轉接器構件。選取最新版本，下載 Nend 轉接程式的 .aar 檔案，然後將其新增至專案。

步驟 5：新增必要程式碼

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

步驟 6：測試導入狀態

啟用測試廣告

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

驗證測試廣告

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

選擇性步驟

聯播網專屬參數

nend 轉接程式支援額外的要求參數，可使用 NendExtrasBundleBuilder 類別傳遞至轉接程式。此類別包含下列方法：

  • setInterstitialType(InterstitialType)：Nend 可選擇針對一般插頁式廣告選取 TYPE_NORMAL，或為插頁式影片廣告選取 TYPE_VIDEO。如未新增這個額外參數，Nend 會預設使用 TYPE_NORMAL 做為插頁類型。

  • setNativeAdsType(nativeAdsType)：Nend 可讓您選擇為一般原生廣告選取 TYPE_NORMAL，或為原生影片廣告選取 TYPE_VIDEO。如果沒有新增這項額外參數，則預設會使用 TYPE_NORMAL 做為原生廣告類型。

Java

Bundle bundle = new NendAdapter.NendExtrasBundleBuilder()
                        .setInterstitialType(InterstitialType.TYPE_NORMAL)
                        .setNativeAdsType(FormatType.TYPE_NORMAL)
                        .build();

AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(NendAdapter.class, bundle)
    .build();

adLoader.loadAd(adRequest);

Kotlin

val bundle = NendAdapter.NendExtrasBundleBuilder()
                     .setInterstitialType(InterstitialType.TYPE_NORMAL)
                     .setNativeAdsType(FormatType.TYPE_NORMAL)
                     .build()

val adRequest = AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(NendAdapter.class, bundle)
    .build()

adLoader.loadAd(adRequest)

使用原生廣告

顯示廣告

Nend 轉接程式會傳回原生廣告做為 NativeAd 物件。這個欄位會為 NativeAd 填入下列 欄位 。

欄位 由 Nend 轉接程式填入
廣告標題
圖片 1
Body
應用程式圖示 2
行動號召
廣告主名稱
星級評等
儲存
價格

1 Nend 只針對設定的原生刊登位置提供圖片素材資源，並將廣告圖片選擇設為橫向 (5: 3) 大型廣告圖片。

2 Nend 不在設定的原生刊登位置提供圖示素材資源，且廣告圖片選項設為「無圖片 (僅限文字)」。

錯誤代碼

如果轉接程式無法接收來自前端的廣告，發布商可以在下列類別中使用 ResponseInfo.getAdapterResponse()，從廣告回應中查看基本錯誤：

形式 類別名稱
橫幅廣告 com.google.ads.mediation.nend.NendAdapter
插頁式 com.google.ads.mediation.nend.NendAdapter
已獲得獎勵 com.google.ads.mediation.nend.NendRewardedAdapter
原生 com.google.ads.mediation.nend.NendMediationAdapter

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

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

簽署 Android 中介服務轉接程式變更記錄

10.0.0.0 版

  • 將 Google Mobile Ads SDK 最低需求更新為 22.3.0 版。
  • 已驗證與 Nend SDK 10.0.0 的相容性。

建構及測試的

  • Google Mobile Ads SDK 22.3.0 版。
  • Nend SDK 10.0.0 版。

9.0.1.0 版

  • 已更新轉接器以使用新的 VersionInfo 類別。
  • 將 Google Mobile Ads SDK 的最低版本更新為 22.0.0。
  • 已驗證與 Nend SDK 9.0.1 的相容性。

建構及測試的

  • Google Mobile Ads SDK 22.0.0 版。
  • Nend SDK 9.0.1 版。

9.0.0.0 版

  • 已驗證與 Nend SDK 9.0.0 的相容性。
  • 將 Google Mobile Ads SDK 的最低版本更新為 21.2.0。

建構及測試的

  • Google Mobile Ads SDK 21.2.0 版。
  • Nend SDK 9.0.0 版。

8.2.0.0 版

  • 已驗證與 Nend SDK 8.2.0 的相容性。

建構及測試的

  • Google Mobile Ads SDK 21.0.0 版。
  • Nend SDK 8.2.0 版。

8.1.0.1 版

  • 將 compileSdkVersion 和 targetSdkVersion 更新為 API 31。
  • 將 Google Mobile Ads SDK 的最低版本更新為 21.0.0。

建構及測試的

  • Google Mobile Ads SDK 21.0.0 版。
  • Nend SDK 8.1.0 版。

8.1.0.0 版

  • 已驗證與 Nend SDK 8.1.0 的相容性。
  • 修正了 nend 傳回 null 廣告圖片或標誌網址時發生的 NullPointerException 當機問題。
  • 將 Google Mobile Ads SDK 的最低版本更新為 20.5.0。

建構及測試的

  • Google Mobile Ads SDK 20.5.0 版。
  • Nend SDK 8.1.0 版。

8.0.1.0 版

  • 已驗證與 Nend SDK 8.0.1 的相容性。
  • 修正了使用錯誤網域傳回部分 AdError 物件的錯誤。
  • 將 Google Mobile Ads SDK 最低需求更新為 20.4.0 版。

建構及測試的

  • Google Mobile Ads SDK 20.4.0 版。
  • Nend SDK 8.0.1 版。

7.1.0.0 版

  • 已驗證與 Nend SDK 7.1.0 的相容性。
  • 已更新錯誤代碼，以便擷取 Nend UNSUPPORTED_DEVICE 錯誤。
  • 將 Google Mobile Ads SDK 的最低版本更新為 20.2.0。

建構及測試的

  • Google Mobile Ads SDK 20.2.0 版。
  • Nend SDK 7.1.0 版。

7.0.3.0 版

  • 已驗證與 Nend SDK 7.0.3 的相容性。
  • 新增描述性的錯誤代碼，以及轉接程式載入/顯示失敗的原因。
  • 將 Google Mobile Ads SDK 的最低版本更新為 20.0.0。

建構及測試的

  • Google Mobile Ads SDK 20.0.0 版。
  • Nend SDK 7.0.3 版。

7.0.0.0 版

  • 已驗證與 Nend SDK 7.0.0 的相容性。
  • 將 Google Mobile Ads SDK 的最低版本更新為 19.4.0。

建構及測試的

  • Google Mobile Ads SDK 19.4.0 版。
  • Nend SDK 7.0.0 版。

6.0.1.0 版

  • 已驗證與 Nend SDK 6.0.1 的相容性。
  • 將 Google Mobile Ads SDK 的最低版本更新為 19.3.0。

建構及測試的

  • Google Mobile Ads SDK 19.3.0 版。
  • Nend SDK 6.0.1 版。

6.0.0.0 版

  • 已驗證與 Nend SDK 6.0.0 的相容性。
  • 將最低 Android SDK 版本更新為 API 19。

建構及測試的

  • Google Mobile Ads SDK 19.2.0 版。
  • Nend SDK 6.0.0 版。

5.4.2.1 版

  • 更新轉接程式以支援內嵌自動調整橫幅廣告請求。
  • 修正智慧型橫幅廣告遭到刪除時，可能發生的罕見競爭狀況當機問題。
  • 將 Google Mobile Ads SDK 的最低版本更新為 19.2.0。

建構及測試的

  • Google Mobile Ads SDK 19.2.0 版。
  • Nend SDK 5.4.2 版。

5.4.2.0 版

  • 新增對原生廣告的支援。
  • 已驗證與 Nend SDK 5.4.2 的相容性。
  • 將 Google Mobile Ads SDK 的最低版本更新為 19.0.0。

建構及測試的

  • Google Mobile Ads SDK 19.0.0 版。
  • Nend SDK 5.4.2 版。

5.3.0.0 版

  • 已驗證與 Nend SDK 5.3.0 的相容性。
  • 將 Google Mobile Ads SDK 的最低版本更新為 18.2.0。

建構及測試的

  • Google Mobile Ads SDK 18.2.0 版。
  • Nend SDK 5.3.0 版。

5.2.0.0 版

  • 已驗證與 Nend SDK 5.2.0 的相容性。
  • 將 Google Mobile Ads SDK 的最低版本更新為 18.1.1。

5.1.0.4 版

  • 修正橫幅廣告和插頁式廣告不會轉送 onAdClicked() 事件的問題。
  • 修正當附屬橫幅廣告遭到刪除時，系統會擲回 NullPointerException 的問題。
  • 將轉接器遷移至 AndroidX。
  • 將 Google Mobile Ads SDK 的最低版本更新為 18.0.0。

5.1.0.3 版

  • 新增導入功能，在 SmartBanner 中顯示部分結尾橫幅廣告。適當大小的智慧型橫幅廣告
    • 直向和橫向
      • 手機：320×50
      • 平板電腦：728×90 或 320×50

5.1.0.2 版

  • 新增對彈性橫幅廣告大小的支援。

5.1.0.1 版

  • 更新轉接程式以支援新的開放式 Beta 版獎勵 API。
  • 將 Google Mobile Ads SDK 的最低版本更新為 17.2.0。

5.1.0.0 版

  • 已驗證與 Nend SDK 5.1.0 的相容性。

5.0.2.1 版

  • 移除了轉送使用者功能的函式，因為 AdRequest.Builder 已淘汰下列方法。
    • setGender()
    • setBirthday()
    • setIsDesignedForFamiles()

5.0.2.0 版

  • 已驗證與 Nend SDK 5.0.2 的相容性。

5.0.1.0 版

  • 已驗證與 Nend SDK 5.0.1 的相容性。

5.0.0.0 版

  • 已驗證與 Nend SDK 5.0.0 的相容性。

版本 4.0.5.0

  • 已驗證與 Nend SDK 4.0.5 的相容性。

版本 4.0.4.1

  • 支援 獎勵 VideoAdListener 的 on RewardsVideoCompleted() 方法。

版本 4.0.4.0

  • 已驗證與 Nend SDK 4.0.4 的相容性。

版本 4.0.2.1

  • 新增使用 NendExtrasBundleBuilder 類別建立中介服務額外 Bundle 的功能。

版本 4.0.2.0

  • Google 行動廣告中介服務開放原始碼專案的第一個版本。
  • 新增對橫幅廣告、插頁式廣告和獎勵影片廣告的支援。