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

このガイドでは、Google Mobile Ads SDK を使用して AdMob メディエーションで 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: AdMob 管理画面で LINE 広告ネットワークのデマンドを設定する

広告ユニットのメディエーション設定を構成する

広告ユニットのメディエーション構成に LINE Ads Network を追加する必要があります。

まず、AdMob アカウントにログインします。次に、[メディエーション] タブに移動します。既存のメディエーション グループを変更する場合は、そのメディエーション グループの名前をクリックして編集し、LINE 広告ネットワークを広告ソースとして追加するに進みます。

新しいメディエーション グループを作成するには、[メディエーション グループを作成] を選択します。

広告フォーマットとプラットフォームを入力し、[続行] をクリックします。

メディエーション グループに名前を付け、ターゲットとする地域を選択します。次に、メディエーション グループのステータスを [有効] に設定し、[広告ユニットを追加] をクリックします。

このメディエーション グループを、既存の AdMob 広告ユニットに関連付けます。次に [完了] をクリックします。

選択した広告ユニットが広告ユニットカードに表示されます。

LINE 広告ネットワークを広告ソースとして追加する

単価設定


[広告ソース] セクションの [入札] カードで、[広告ソースを追加] を選択します。次に、[LINE 広告ネットワーク] を選択します。
[パートナー契約への署名手順] をクリックし、LINE 広告ネットワークと入札パートナーシップを設定します。
[確認して同意する]、[続行] の順にクリックします。
LINE 広告ネットワークのマッピングがすでにある場合は、そのマッピングを選択できます。それ以外の場合は、[マッピングを追加] をクリックします。
次に、前のセクションで取得したアプリケーション ID とスロット ID を入力します。[完了] をクリックします。

滝


[広告ソース] セクションの [ウォーターフォール] カードで、[広告ソースを追加] を選択します。次に、[LINE 広告ネットワーク] を選択します。

[LINE 広告ネットワーク] を選択します。 次に、LINE 広告ネットワークの eCPM 値を入力し、[続行] をクリックします。



LINE 広告ネットワークのマッピングがすでにある場合は、そのマッピングを選択できます。それ以外の場合は、[マッピングを追加] をクリックします。

次に、前のセクションで取得したアプリケーション ID とスロット ID を入力します。次に [完了] をクリックします。


ステップ 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: 実装をテストする

テスト広告を有効にする

AdMob にテストデバイスを登録してください。

テスト広告を確認する

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

省略可能なステップ

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

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

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

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

Java

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

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

Kotlin

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

val request = AdRequest.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 を削除し、FiveAdCustomLayoutEventListener、FiveAdVideoRewardEventListener、FiveAdInterstitialEventListener、FiveAdNativeEventListener に置き換えました。
  • 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。