このガイドでは、Google Mobile Ads SDK for React Native を使用してメディエーションで LY 広告ネットワークの広告を読み込んで表示する方法とウォーターフォール統合について説明します。また、広告ユニットのメディエーション設定に LY Ads Network を追加する方法と、LY Ads Network SDK とアダプターを React Native アプリに統合する方法についても説明します。
サポートされている統合と広告フォーマット
LINE ヤフー広告ネットワークの AdMob メディエーション アダプタには、次の機能があります。
| 統合 | |
|---|---|
| 入札 | |
| ウォーターフォール | |
| フォーマット | |
| アプリの起動 | |
| バナー | |
| インタースティシャル | |
| リワード | |
| リワード インタースティシャル | |
| ネイティブ | |
前提条件
続行する前に、次のことを確認してください。
- 最新の Google Mobile Ads SDK for React Native バージョン。
- React Native フレームワーク バージョン 0.85.0 以降。
- Android にデプロイする場合
- Android API レベル 24 以降。
- iOS にデプロイする場合
- iOS のデプロイ ターゲット 13.0 以降。
- Google Mobile Ads SDK for React Native で構成された正常に動作する React Native プロジェクト。詳細については、Google Mobile Ads SDK for React Native を設定するをご覧ください。
gma-sdk-react-nativeフォルダからadaptersフォルダをダウンロードして解凍していることを確認します。adaptersフォルダがない場合は、Google Mobile Ads SDK for React Native をインストールするの手順 1、2、3 を行います。
- AdMob メディエーションを設定する
ステップ 1: LY 広告ネットワークの UI で設定を行う
LINE ヤフー広告ネットワーク アカウントに登録してログインします。
新しいアプリケーションを追加する
[App] タブに移動し、[New registration] ボタンをクリックします。
フォームに記入して [registration] をクリックします。
アプリ ID をメモします。
Android
iOS
広告スロットを作成する
[アプリ] タブで、アプリを選択してアプリの詳細を表示します。[スロット] セクションで、[追加] をクリックします。
スロットの詳細をフォームに入力します。[入札タイプ(Bidding Type)] で、ウォーターフォール メディエーション用にこのスロットを設定する場合は [標準(Standard)] を、入札用にこのスロットを設定する場合は [Google SDK 入札(Google SDK Bidding)] を選択します。入力が完了したら、[作成] をクリックします。
スロット ID をメモします。
最初のスロットを作成したら、アプリの詳細ページで [審査] をクリックして、LY Ads Network から承認を得ます。しばらく時間がかかることがあります。ご不明な点がございましたら、LY Ads Network の担当者にお問い合わせください。
Reporting API キーを作成する
[レポート API キーの管理] タブに移動し、[API キーを作成] ボタンをクリックします。
フォームに記入して [保存] をクリックします。
API キー ID と API キー シークレットをメモします。
app-ads.txt を更新する
アプリの認定販売者 app-ads.txt は、IAB Tech Lab が推進するイニシアチブで、承認されたチャネルでのみアプリ広告インベントリを販売できるようにするものです。広告収入の大幅な減少を防ぐためには、app-ads.txt ファイルを実装する必要があります。まだ設定していない場合は、アプリの app-ads.txt ファイルを設定します。
LINE ヤフー広告ネットワークに app-ads.txt を実装するには、app-ads.txt についてをご覧ください。
ステップ 2: AdMob の管理画面で LY 広告ネットワークのデマンドを設定する
広告ユニットのメディエーション設定を構成する
ステップ 3: LY 広告ネットワーク SDK とアダプターをインポートする
プロジェクトのルート ディレクトリに、LY Ads 広告ネットワーク用の Google Mobile Ads SDK for React Native メディエーション アダプターをインストールします。次の手順に沿って操作します。
Google Mobile Ads SDK for React Native アダプタの tar ファイルを
gma-sdk-react-native/adapters/line/ディレクトリからプロジェクトのlocal_packages/ディレクトリにコピーします。adaptersフォルダがない場合は、前提条件をご覧ください。mkdir -p local_packages cp EXTRACT_DIR/gma-sdk-react-native/adapters/line/gma-mediation-line-0.1.0.tgz local_packages/EXTRACT_DIR は、アーカイブを抽出したディレクトリのパスに置き換えます。
任意のパッケージ マネージャーを使用して、アダプタ パッケージをインストールします。
npm
npm install ./local_packages/gma-mediation-line-0.1.0.tgz毛糸
yarn add ./local_packages/gma-mediation-line-0.1.0.tgz
ステップ 4: 必要なコードを追加する
Android
LY Ads Network の統合に追加のコードは必要ありません。
iOS
SKAdNetwork の統合
LY 広告ネットワークのドキュメントに沿って、SKAdNetwork 識別子をプロジェクトの Info.plist ファイルに追加します。
ステップ 5: 実装をテストする
テスト広告を有効にする
AdMob 用のテストデバイスを登録してください。
テスト広告を確認する
LY Ads Network からテスト広告を受信していることを確認するには、LY Ads Network の広告ソースを使用して、広告インスペクタで単一の広告ソースのテストを有効にします。
省略可能なステップ
ネットワーク固有のパラメータ
LY 広告ネットワーク React Native メディエーション プラグインは、LineMediationExtras クラスを介してアダプターに渡すことができる次の追加リクエスト パラメータをサポートしています。
-
enableAdSound: バナー広告、インタースティシャル広告、リワード広告のデフォルトの音声開始状態を指定します。
これらのパラメータを設定する広告リクエストを作成する方法のコード例を次に示します。
import { LineMediationExtras } from '@google/gma-mediation-line';
const request = {
// ...
mediationExtras: [
new LineMediationExtras({
enableAdSound: true,
}),
],
};
エラーコード
アダプタが LY Ads Network から広告を受け取れない場合は、次のクラスの ResponseInfo を使用して、広告レスポンスからエラーの詳細を確認できます。
Android
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
iOS
GADMediationAdapterLine
広告の読み込みに失敗した場合に LY Ads Network アダプタがスローするコードとメッセージは次のとおりです。
Android
| エラーコード | ドメイン | 理由 |
|---|---|---|
| 1-10 | com.five_corp.ad | LY 広告ネットワーク SDK が SDK 固有のエラーを返しました。詳しくは、LY Ads Network のドキュメントをご覧ください。 |
| 101 | com.google.ads.mediation.line | アプリケーション ID がないか、無効です。 |
| 102 | com.google.ads.mediation.line | スロット ID がないか、無効です。 |
| 103 | com.google.ads.mediation.line | リクエストされた広告サイズが、LY Ads Network でサポートされているバナー広告サイズと一致しません。 |
| 104 | com.google.ads.mediation.line | アクティビティ コンテキストがないため、インタースティシャル広告またはリワード広告を読み込めませんでした。 |
| 105 | com.google.ads.mediation.line | LY 広告ネットワーク SDK でインタースティシャル広告またはリワード広告を表示できませんでした。 |
| 106 | com.google.ads.mediation.line | アセットが不足しているため、ネイティブ広告を読み込めませんでした。 |
| 107 | com.google.ads.mediation.line | FiveAd SDK が null の広告ローダーを返しました。 |
iOS
| エラーコード | ドメイン | 理由 |
|---|---|---|
| 1-10 | LINE ヤフー広告ネットワーク SDK によって送信されたエラーコード | LY 広告ネットワーク SDK が SDK 固有のエラーを返しました。詳しくは、LY Ads Network のドキュメントをご覧ください。 |
| 101 | com.google.ads.mediation.line | サーバー パラメータが無効です(アプリケーション ID またはスロット ID がないなど)。 |
| 102 | com.google.ads.mediation.line | リクエストされた広告サイズが、LY Ads Network でサポートされているバナー広告サイズと一致しません。 |
| 103 | com.google.ads.mediation.line | ネイティブ広告の情報アイコンの画像アセットを読み込めませんでした。 |
| 104 | com.google.ads.mediation.line | 入札用のシグナルを収集できませんでした。 |
| 105 | com.google.ads.mediation.line | LINE 広告 SDK 広告ローダを初期化できませんでした。 |
バージョン 0.1.0
- 初回リリース。
- LINE Android アダプタ バージョン 3.1.1.2 をサポートします。
- LINE iOS アダプタ バージョン 3.1.1.0 をサポートします。
- Google Mobile Ads React Native プラグイン バージョン 0.1.0 でビルドおよびテスト済みです。