Line とメディエーションを統合する(ベータ版)

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

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

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

Line のメディエーション アダプタには、次の機能があります。

統合
単価設定
 1
フォーマット
バナー
インタースティシャル
特典
ネイティブ

1ウォーターフォールの統合はオープンベータ版です。

要件

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

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

ステップ 1: Line UI で設定を行う

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

新しいアプリを追加する

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

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

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

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

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

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

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

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

ステップ 2: AdMob UI で LINE デマンドを設定する

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

広告ユニットのメディエーション設定に Line を追加する必要があります。

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

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

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

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

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

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

Line を広告ソースとして追加する

単価設定


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


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

[] を選択します。 次に、Line の eCPM 値を入力し、[続行] をクリックします。



すでにラインのマッピングがある場合は、それを選択できます。それ以外の場合は、[マッピングを追加] をクリックします。

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


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

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

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

手動による統合

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

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

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

LINE の統合に追加のコードは必要ありません。

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

テスト広告を有効にする

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

LINE のドキュメントに記載されている、LINE テスト広告を有効にする手順に沿って操作します。

テスト広告を確認する

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 の次の ネイティブ広告のフィールドについて に値を入力します。

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

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

エラーコード

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

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

広告の読み込みに失敗したときに、Line アダプタからスローされるコードとそれに付随するメッセージは次のとおりです。

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

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

次のバージョン

  • バナー広告で RTB を有効にするために AdLoader を実装しました。
  • インタースティシャル広告の RTB を有効にするために AdLoader を実装しました。
  • リワード広告で RTB を有効にするために AdLoader を実装しました。
  • ネイティブ広告の RTB を有効にするために AdLoader を実装しました。

バージョン 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。