LINE 広告ネットワークをメディエーションと統合する(ベータ版)

このガイドでは、Google Mobile Ads SDK を使用して、メディエーションを介して Line から広告を読み込んで表示する方法について説明します。ウォーターフォール統合についても説明します。広告ユニットのメディエーション構成に Line を追加する方法と、Line SDK とアダプタを Android アプリに統合する方法について説明します。

LINE 広告ネットワークのダッシュボード インターフェースでは、ラベル、ボタン、説明に日本語のテキストが使用されます。このガイドのスクリーンショットは翻訳されていません。ただし、このガイドの説明と手順では、ラベルとボタンは翻訳され、英語の同義語が括弧内に示されています。

サポートされている統合と広告フォーマット

LINE 広告ネットワークのメディエーション アダプタには、次の機能があります。

統合
単価設定
 1
フォーマット
バナー
インタースティシャル
特典
ネイティブ
1ウォーターフォールの統合はオープンベータ版です。

要件

  • Android API レベル 21 以降
  • 最新の Google Mobile Ads SDK

  • メディエーションのスタートガイドを完了していること

ステップ 1: LINE Ads Network の管理画面で設定を行う

LINE Ads Network アカウントにログインします。

新しいアプリを追加する

[広告枠管理] > [メディア] をクリックします。[新規作成] をクリックします。

フォームに記入して [登録] をクリックします。

アプリケーション ID をメモします。

広告プレースメントを作成する

広告プレースメントを追加するアプリケーションの ID をクリックします。[詳細] を選択します。

[スロット 追加] をクリックします。

フォームに入力し、完了したら [登録] をクリックします。

スロット ID をメモします。

ステップ 2: アド マネージャーの管理画面で LINE 広告ネットワークのデマンドを設定する

アド マネージャー アカウントにログインします。

企業に LINE 広告ネットワークを追加する

単価設定

この手順は、入札の統合では必要ありません。

[管理] > [会社] に移動し、[すべての会社] タブで [新しい会社] ボタンをクリックします。[広告ネットワーク] を選択します。

[広告ネットワーク] として [LINE 広告ネットワーク] を選択し、一意の名前を入力して [メディエーション] を有効にします。

[ユーザー名] や [パスワード] を入力する必要はありません。完了したら、[保存] をクリックします。

セキュア シグナルの共有を有効にする

単価設定

[管理者] > [全般設定] に移動します。[Ad Exchange アカウントの設定] タブに移動し、[セキュア シグナルの共有] を確認してオンに切り替えます。[保存] をクリックします。

この手順は、ウォーターフォール統合では必要ありません。

LINE 広告ネットワークの入札を設定する

単価設定

[配信] > [入札者(ビッダー)] に移動し、[SDK 入札] タブで [新しいビッダー] をクリックします。

ビッダーとして [LINE 広告ネットワーク] を選択します。

[許可したシグナルのリストにこのビッダーのシグナル ライブラリを追加する] と [このビッダーとのシグナルの共有を許可する] をオンにします。その後、[続行] をクリックします。

[続行] をクリックします。

[完了] をクリックします。

この手順は、ウォーターフォール統合では必要ありません。

広告ユニットのマッピングを設定する

単価設定

[配信] > [入札者(ビッダー)] に移動し、[SDK 入札] タブで LINE 広告ネットワークの会社を選択します。

[広告ユニットのマッピング] タブに移動し、[新しい広告ユニットのマッピング] をクリックします。

[特定の広告ユニット] を選択します。広告ユニットとフォーマットを選択し、[広告枠のタイプ] で [モバイルアプリ] を選択し、モバイルアプリを選択します。次に、前のセクションで取得したアプリケーション IDスロット ID を入力します。確認したら、[保存] をクリックします。

[配信] > [収益グループ] に移動し、[新しい収益グループ] ボタンをクリックします。モバイルアプリを選択します。

下にスクロールして [収益パートナーを追加] をクリックします。

前のセクションで LINE 広告ネットワーク用に作成した企業を選択します。[統合タイプ] で [モバイル SDK メディエーション]、[プラットフォーム] で [Android]、[ステータス] で [有効] を選択します。

前のセクションで取得したアプリケーション IDスロット IDデフォルトの CPM 値を入力します。[保存] をクリックします。

ステップ 3: LINE Ads Network SDK とアダプターをインポートする

アプリレベルの build.gradle.kts ファイルで、次の実装依存関係と構成を追加します。LINE Ads Network SDK とアダプタの最新バージョンを使用します。

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.6.0")
    implementation("com.google.ads.mediation:line:2.9.20241129.0")
}

手動による統合

  1. 最新バージョンの LINE Ads Network SDK.aar ファイルをダウンロードして、プロジェクトに追加します。

  2. Google の Maven リポジトリで LINE Ads Network アダプター アーティファクトに移動します。最新バージョンを選択し、LINE 広告ネットワーク アダプターの .aar ファイルをダウンロードしてプロジェクトに追加します。

ステップ 4: 必要なコードを追加する

LINE 広告ネットワークの統合に追加のコードは必要ありません。

ステップ 5: 実装をテストする

テスト広告を有効にする

アド マネージャーでテストデバイスを登録してください。

テスト広告を確認する

LINE 広告ネットワークからテスト広告が配信されていることを確認するには、広告インスペクタで LINE 広告ネットワーク(ウォーターフォール)広告ソースを使用して単一の広告ソースのテストを有効にします。

省略可能なステップ

ネットワーク固有のパラメータ

LINE 広告ネットワーク アダプタは、LineExtras クラスを使用してアダプタに渡すことができる追加のリクエスト パラメータをサポートしています。このクラスのコンストラクタには、次のパラメータが含まれています。

enableAdSound
バナー広告、インタースティシャル広告、リワード広告のデフォルトの音声開始状態を指定する boolean

これらのパラメータを設定する広告リクエストを作成するコードの例を次に示します。

Java

LineExtras lineExtras = new LineExtras(true);
Bundle extras = lineExtras.build();

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(LineMediationAdapter.class, extras)
   .build();

Kotlin

val lineExtras = LineExtras(true)
val extras = lineExtras.build()

val request = AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(LineMediationAdapter::class.java, extras)
   .build()

ネイティブ広告を使用する

広告のレンダリング

LINE 広告ネットワーク アダプタは、NativeAd の次のフィールドに値を入力します。

フィールド LINE Ads Network アダプタによって常に含まれるアセット
広告見出し
画像
本文
アプリのアイコン 1
行動を促すフレーズ
評価
ストア
価格

1 ネイティブ広告の場合、LINE Ads Network SDK はアプリアイコン アセットを提供しません。代わりに、LINE Ads Network アダプタはアプリアイコンに透明な画像を配置します。

エラーコード

アダプターが LINE 広告ネットワークから広告を受信できない場合は、次のクラスの ResponseInfo.getAdapterResponses() を使用して、広告レスポンスから根本的なエラーを確認できます。

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

広告の読み込みに失敗したときに LINE 広告ネットワーク アダプタからスローされるコードとメッセージは次のとおりです。

エラーコード ドメイン 理由
1-10 com.five_corp.ad LINE Ads Network SDK が SDK 固有のエラーを返しました。詳しくは、LINE 広告ネットワークのドキュメントをご覧ください。
101 com.google.ads.mediation.line アプリケーション ID がない、または無効です。
102 com.google.ads.mediation.line スロット ID がないか、無効です。
103 com.google.ads.mediation.line リクエストされた広告サイズが、LINE Ads Network でサポートされているバナー広告サイズと一致しません。
104 com.google.ads.mediation.line アクティビティ コンテキストがないため、インタースティシャル広告またはリワード広告を読み込めませんでした。
105 com.google.ads.mediation.line LINE Ads Network SDK がインタースティシャル広告またはリワード広告を表示できなかった。
106 com.google.ads.mediation.line アセットがないため、ネイティブ広告を読み込めませんでした。

LINE Android メディエーション アダプタの変更履歴

次のバージョン

  • シグナルの収集プロセスを修正しました。

バージョン 2.9.20241129.0

  • バナー広告、インタースティシャル広告、リワード広告、ネイティブ広告フォーマットの入札サポートを追加しました。
  • FiveAd SDK バージョン 2.9.20241129.0 との互換性を確認しました

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 23.5.0。
  • FiveAd SDK バージョン 2.9.20241129.0

バージョン 2.8.20240827.0

  • FiveAd SDK バージョン 2.8.20240827.0 との互換性を確認しました

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 23.3.0。
  • FiveAd SDK バージョン 2.8.20240827.0

バージョン 2.8.20240808.0

  • FiveAd SDK バージョン 2.8.20240808.0 との互換性を確認しました

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 23.2.0。
  • FiveAd SDK バージョン 2.8.20240808.0

バージョン 2.8.20240722.0

  • FiveAd SDK バージョン 2.8.20240722.0 との互換性が確認済み

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 23.2.0。
  • FiveAd SDK バージョン 2.8.20240722.0

バージョン 2.7.20240515.0

  • FiveAd SDK バージョン 2.7.20240515.0 との互換性が確認されました

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 23.1.0。
  • FiveAd SDK バージョン 2.7.20240515.0

バージョン 2.7.20240214.1

  • 必須の Google Mobile Ads SDK バージョンを 23.0.0 に更新しました。
  • FiveAd SDK バージョン 2.7.20240214.0 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 23.0.0。
  • FiveAd SDK バージョン 2.7.20240214.0。

バージョン 2.7.20240214.0

  • FiveAd SDK バージョン 2.7.20240214.0 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 22.6.0。
  • FiveAd SDK バージョン 2.7.20240214.0。

バージョン 2.7.20240126.0

  • FiveAd SDK バージョン 2.7.20240126.0 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 22.6.0。
  • FiveAd SDK バージョン 2.7.20240126.0。

バージョン 2.7.20240112.0

  • 非推奨の FiveAdViewEventListener を削除し、FiveAdCustomLayoutEventListenerFiveAdVideoRewardEventListenerFiveAdInterstitialEventListenerFiveAdNativeEventListener に置き換えました。
  • FiveAd SDK バージョン 2.7.20240112 との互換性が確認されました。
  • 必要最小限の Google Mobile Ads SDK バージョンを 22.6.0 に更新しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 22.6.0。
  • FiveAd SDK バージョン 2.7.20240112。

バージョン 2.6.20230607.1

  • パブリッシャーがバナー広告、インタースティシャル広告、リワード広告フォーマットのデフォルトの音声設定を定義できるように、LineExtras クラスを追加しました。
  • 必須となる Google Mobile Ads SDK のバージョンを 22.4.0 に更新しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 22.4.0。
  • FiveAd SDK バージョン 2.6.20230607。

バージョン 2.6.20230607.0

  • 初回リリース。
  • バナー広告、インタースティシャル広告、リワード広告、ネイティブ広告フォーマットのサポートを追加しました。
  • FiveAd SDK バージョン 2.6.20230607 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 22.1.0。
  • FiveAd SDK バージョン 2.6.20230607。