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

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

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

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

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

1 ウォーターフォールの統合はクローズド ベータ版です。アクセス権をリクエストするには、アカウント マネージャーにお問い合わせください。

要件

  • Unity 4 以降
  • 最新の Google Mobile Ads SDK
  • Android にデプロイするには
    • Android API レベル 21 以降
  • iOS にデプロイするには
    • iOS デプロイ ターゲットが 12.0 以降
  • Google Mobile Ads SDK で設定された、動作する Unity プロジェクト。詳しくは、スタートガイドをご覧ください。
  • メディエーションのスタートガイドの手順を完了していること

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

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

新しいアプリを追加する

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

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

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

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

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

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

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

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

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

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

Android

手順については、Android のガイドの手順 2 をご覧ください。

iOS

手順については、iOS 向けガイドの手順 2 をご覧ください。

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

OpenUPM-CLI

OpenUPM-CLI がインストールされている場合は、プロジェクトのルート ディレクトリから次のコマンドを実行して、Unity 用 Google モバイル広告ライン メディエーション プラグインをプロジェクトにインストールできます。

openupm add com.google.ads.mobile.mediation.line

OpenUPM

Unity プロジェクト エディタで、[Edit] > [Project Settings] > [Package Manager] を選択して、Unity Package Manager Settings を開きます。

[スコープ付きレジストリ] タブで、OpenUPM をスコープ付きレジストリとして追加し、次の詳細情報を指定します。

  • 名前: OpenUPM
  • URL: https://package.openupm.com
  • スコープ: com.google

OpenUPM の詳細

次に、[Window] > [Package Manager] に移動して Unity Package Manager を開き、プルダウン メニューから [My Registries] を選択します。

Unity レジストリ

[Google Mobile Ads Line Mediation] パッケージを選択し、[Install] をクリックします。

OpenUPM からインストールする

Unity パッケージ

変更ログのダウンロード リンクから、Line 向け Google モバイル広告メディエーション プラグインの最新バージョンをダウンロードし、ZIP ファイルから GoogleMobileAdsLineMediation.unitypackage を抽出します。

Unity プロジェクト エディタで、[Assets] > [Import Package] > [Custom Package] を選択し、ダウンロードした GoogleMobileAdsLineMediation.unitypackage ファイルを探します。すべてのファイルのチェックボックスがオンになっていることを確認して、[インポート] をクリックします。

Unity からインポートする

次に、[Assets] > [External Dependency Manager] > [Android Resolver] > [Force Resolve] を選択します。External Dependency Manager ライブラリは、依存関係の解決を最初から実行し、宣言された依存関係を Unity アプリの Assets/Plugins/Android ディレクトリにコピーします。

強制解決

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

Android

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

iOS

SKAdNetwork の統合

Line のドキュメントに沿って、SKAdNetwork ID をプロジェクトの Info.plist ファイルに追加します。

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

テスト広告を有効にする

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

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

テスト広告を確認する

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

省略可能なステップ

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

Line Unity メディエーション プラグインは、LineMediationExtras クラスを介してアダプタに渡すことができる次の追加リクエスト パラメータをサポートしています。

  • SetEnableAdSound(boolean): バナー広告、インタースティシャル広告、リワード広告のデフォルトの音声開始状態を指定します。

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

using GoogleMobileAds.Api;
using GoogleMobileAds.Mediation.Line.Api;
// ...

var adRequest = new AdRequest();
var lineExtras = new LineMediationExtras();
lineExtras.SetEnableAdSound(true);
adRequest.MediationExtras.Add(lineExtras);

エラーコード

アダプターが Line から広告を受信できない場合、パブリッシャーは次のクラスの ResponseInfo を使用して、広告レスポンスから根本的なエラーを確認できます。

Android

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

iOS

GADMediationAdapterLine

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

Android

エラーコード ドメイン 理由
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 アセットがないため、ネイティブ広告を読み込めませんでした。

iOS

エラーコード ドメイン 理由
1-10 Line SDK によって送信されました Line SDK から SDK 固有のエラーが返されました。詳しくは、Line のドキュメントをご覧ください。
101 com.google.ads.mediation.line 無効なサーバー パラメータ(アプリケーション ID またはスロット ID が欠落しているなど)。
102 com.google.ads.mediation.line リクエストされた広告サイズが、LINE でサポートされているバナー広告サイズと一致しません。
103 com.google.ads.mediation.line ネイティブ広告の情報アイコンの画像アセットを読み込めませんでした。

Line Unity メディエーション プラグインの変更ログ

バージョン 1.4.0

バージョン 1.3.1

バージョン 1.3.0

バージョン 1.2.0

バージョン 1.1.2

バージョン 1.1.1

バージョン 1.1.0

バージョン 1.0.0