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

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

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

企業にラインを追加する

単価設定

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

滝

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

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

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

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

単価設定

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

滝

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

LINE 入札を設定する

単価設定

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

ビッダーとして [Line] を選択します。

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

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

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

滝

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

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

単価設定

[配信] > [入札者（ビッダー）] に移動し、[SDK 入札] タブで LINE の会社を選択します。

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

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

滝

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

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

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

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

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

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

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

手動による統合

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

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

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

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

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

テスト広告を有効にする

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

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

テスト広告を確認する

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()

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

広告のレンダリング

ライン アダプタは、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 を削除し、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。