このガイドでは、Google Mobile Ads SDK でメディエーションを使用して Line から広告を読み込み、表示する方法について説明します。ここでは、ウォーターフォールの統合について説明します。広告ユニットのメディエーション設定に Line を追加する方法と、Line SDK とアダプタを Unity アプリに統合する方法について説明します。
サポートされている統合と広告フォーマット
Line 用 AdMob メディエーション アダプタには次の機能があります。
統合 | |
---|---|
入札 | |
ウォーターフォール | 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 をクリックします。次に、[詳細(詳細)] を選択します。
[スロット追加(スロットを追加)] をクリックします。
フォームに必要事項を記入して、[登録] をクリックします。
スロット ID をメモしておきます。
ステップ 2: 管理画面で AdMob 回線デマンドを設定する
広告ユニットのメディエーション設定を行う
ステップ 3: Line SDK とアダプタをインポートする
変更履歴のダウンロード リンクから Line 用 Google モバイル広告メディエーション プラグインの最新バージョンをダウンロードし、zip ファイルから GoogleMobileAdsLineMediation.unitypackage
を抽出します。
Unity プロジェクト エディタで、[Assets] > [Import Package] > [Custom Package] を選択し、ダウンロードした GoogleMobileAdsLineMediation.unitypackage
ファイルを見つけます。すべてのファイルが選択されていることを確認して、[インポート] をクリックします。
次に、[Assets] > [Play Services Resolver] > [Android Resolver] > [Force Resolve] を選択します。Unity Play 開発者サービス リゾルバ ライブラリは、依存関係の解決をゼロから実行し、宣言された依存関係を Unity アプリの Assets/Plugins/Android
ディレクトリにコピーします。
ステップ 4: 必要なコードを追加する
Android
Line の統合には、追加のコードは必要ありません。
iOS
SKAdNetwork との統合
Line のドキュメントに沿って、SKAdNetwork 識別子をプロジェクトの Info.plist
ファイルに追加します。
ステップ 5: 実装をテストする
テスト広告を有効にする
AdMob。
Line の Android と iOS のドキュメント の手順に沿って、LINE テスト広告を有効にします。
テスト広告を確認する
Lineからテスト広告を受信していることを確認するには、広告インスペクタで Line (Waterfall) 広告ソースを使用して単独の広告ソースのテストを有効にします。
省略可能なステップ
ネットワーク固有のパラメータ
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.1.2
- Line Android アダプター バージョン 2.7.20240515.0 をサポートします。
- Line iOS アダプター バージョン 2.7.20240411.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 9.1.0 でビルド、テストされています。
バージョン 1.1.1
- Line Android アダプター バージョン 2.7.20240214.1 をサポートします。
- Line iOS アダプター バージョン 2.7.20240411.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 9.1.0 でビルド、テストされています。
バージョン 1.1.0
- メディエーションのエクストラの受け渡しをサポートするため、以下のメソッドを持つ
LineMediationExtras
クラスを追加しました。SetEnabledAdSound(bool)
- Line Android アダプター バージョン 2.7.20240214.1 をサポートします。
- Line iOS アダプター バージョン 2.7.20240318.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 9.0.0 でビルド、テストされています。
バージョン 1.0.0
- 初版リリース。
- Line Android アダプター バージョン 2.6.20230607.0 をサポートします。
- Line iOS アダプター バージョン 2.6.20230609.0 をサポートします。
- Google Mobile Ads Unity Plugin バージョン 8.5.1 でビルド、テストされていること。