LINE ヤフー広告ネットワークをメディエーションと統合する

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

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

LINE ヤフー広告ネットワークのメディエーション アダプタには、次の機能があります。

前提条件

続行する前に、次のことを確認してください。

• iOS のデプロイ対象のバージョンが 13.0 以降であること。

• [入札の場合]: サポートされているすべての広告フォーマットを入札に統合するには、LY Ads Network アダプタ 2.8.20240827.0 以降（最新バージョンを推奨）を使用します。

• 最新の Google Mobile Ads SDK バージョン。

• AdMob メディエーションを設定する。

ステップ 1: LY 広告ネットワークの UI で設定を行う

LINE ヤフー広告ネットワーク アカウントに登録してログインします。

新しいアプリケーションを追加する

[アプリ] タブに移動し、[新しい登録] ボタンをクリックします。

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

アプリ ID をメモします。

広告スロットを作成する

[アプリ] タブでアプリを選択して、アプリの詳細を表示します。[スロット] セクションで、[追加] をクリックします。

スロットの詳細をフォームに入力します。[入札タイプ（Bidding Type）] で、ウォーターフォール メディエーション用にこのスロットを設定する場合は [標準（Standard）] を、入札用にこのスロットを設定する場合は [Google SDK 入札（Google SDK Bidding）] を選択します。フォームへの入力が完了したら、[作成] をクリックします。

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

最初のスロットを作成したら、アプリの詳細ページで [Review] をクリックして、LY Ads Network の承認を得ます。しばらく時間がかかることがあります。ご不明な点がございましたら、LY Ads Network の担当者にお問い合わせください。

レポート API キーを作成する

[レポート API キーの管理] タブに移動し、[API キーを作成] ボタンをクリックします。

フォームに記入して [保存] をクリックします。

API キー ID と API キー シークレットをメモします。

app-ads.txt を更新する

アプリの認定販売者 app-ads.txt は、IAB Tech Lab が推進するイニシアチブで、承認されたチャネルでのみアプリ広告枠を販売できるようにするものです。広告収入の大幅な減少を防ぐためには、app-ads.txt ファイルを実装する必要があります。まだ設定していない場合は、アプリの app-ads.txt ファイルを設定します。

LY Ads Network に app-ads.txt を実装するには、app-ads.txt についてをご覧ください。

ステップ 2: AdMob の管理画面で LY Ads Network のデマンドを設定する

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

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

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

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

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

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

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

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

広告のソースとして LINE ヤフー広告ネットワークを追加する

入札

[広告のソース] セクションで [入札] カードを見つけて、[広告のソースを追加] を選択します。[LY 広告ネットワーク] を選択します。

[パートナー契約への署名手順] をクリックし、LY 広告ネットワークとの入札パートナーシップを設定します。



[確認して同意する] をクリックし、[続行] をクリックします。



LINE ヤフー広告ネットワークのマッピングがすでにある場合は、それを選択できます。それ以外の場合は、[マッピングを追加] をクリックします。



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

ウォーターフォール

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

[LY 広告ネットワーク] を選択し、[最適化] スイッチをオンにします。前のセクションで取得したAPI キー ID と API キー シークレットを入力して、LY 広告ネットワークの広告のソース最適化を設定します。次に、LY 広告ネットワークの eCPM 値を入力し、[続行] をクリックします。




LY 広告ネットワークのマッピングがすでにある場合は、それを選択できます。それ以外の場合は、[マッピングを追加] をクリックします。



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

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

Swift Package Manager を使用する

続行する前に、サポートされている最小アダプタ バージョン 2.9.20251119 が必要です。

プロジェクトにパッケージの依存関係を追加するには、次の手順を行います。

1. Xcode で、[File] > [Add Package Dependencies...] の順に移動します。

2. 表示されたプロンプトで、次のパッケージ URL を検索します。

   https://github.com/googleads/googleads-mobile-ios-mediation-line.git
   

3. [依存関係ルール] で、[ブランチ] を選択します。

4. テキスト フィールドに「main」と入力します。

CocoaPods を使用

プロジェクトの Podfile に次の行を追加します。

pod 'GoogleMobileAdsMediationLine'

コマンドラインで次のコマンドを実行します。

pod install --repo-update

手動による統合

• LY Ads Network SDK の最新バージョンをダウンロードし、プロジェクトに FiveAd.framework をリンクします。
• 変更履歴のダウンロード リンクから LY Ads Network アダプタの最新バージョンをダウンロードし、プロジェクトに LineAdapter.framework をリンクします。

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

SKAdNetwork を実装する

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

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

テスト広告を有効にする

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

LINE ヤフー広告ネットワーク アダプタには、LINE ヤフー広告ネットワークのテストモードを有効にするヘルパー メソッドが含まれています。このオプションは、Google Mobile Ads SDK を初期化する前に設定する必要があります。これにより、LY Ads Network SDK に正しく転送されます。

import LineAdapter
// ...

GADMediationAdapterLine.testMode = true

#import <LineAdapter/LineAdapter.h>
// ...

GADMediationAdapterLine.testMode = YES;

テスト広告を確認する

LY Ads Network からテスト広告を受信していることを確認するには、LY Ads Network の広告のソースを使用して、広告インスペクタで単一の広告ソースのテストを有効にします。

省略可能なステップ

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

LY Ads Network アダプタは、GADMediationAdapterLineExtras クラスを使用してアダプタに渡すことができる追加のリクエスト パラメータをサポートしています。このクラスには次のプロパティが含まれます。

adAudio

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

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

import LineAdapter
// ...

let request = GADRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)

#import <LineAdapter/LineAdapter.h>
// ...

GADRequest *request = [GADRequest request];
GADMediationAdapterLineExtras *extras = [[GADMediationAdapterLineExtras alloc] init];
extras.adAudio = GADMediationAdapterLineAdAudioUnmuted;
// ...
[request registerAdNetworkExtras:extras];

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

広告レンダリング

LINE ヤフー広告ネットワーク アダプタは、GADNativeAd の次のネイティブ アドバンス広告フィールドに値を設定します。

¹ ネイティブ広告の場合、LY Ads Network SDK はアプリアイコン アセットを提供しません。代わりに、LY Ads Network アダプタが透明な画像でアプリアイコンを設定します。

エラーコード

アダプタが LY Ads Network から広告を受け取れない場合は、次のクラスの GADResponseInfo.adNetworkInfoArray を使用して、広告レスポンスからエラーの詳細を確認できます。

GADMediationAdapterLine

広告の読み込みに失敗した場合に LINE ヤフー広告ネットワーク アダプタがスローするコードとメッセージは次のとおりです。

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

バージョン 3.0.1.2

• Google Mobile Ads SDK の依存関係を緩和してマイナー バージョンを許可するため、最小 iOS バージョンを更新しました。
• ネイティブ広告の AdChoices アイコンが大きすぎる問題を修正しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 13.4.0。
• FiveAd SDK バージョン 3.0.1。

バージョン 3.0.1.1

• アダプタが ageRestrictedTreatment Google Mobile Ads SDK フラグを FiveAd SDK の COPPA API に転送するようになりました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 13.3.0。
• FiveAd SDK バージョン 3.0.1。

バージョン 3.0.1.0

• FiveAd SDK バージョン 3.0.1 との互換性を確認しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 13.1.0。
• FiveAd SDK バージョン 3.0.1。

バージョン 3.0.0.1

• Google Mobile Ads SDK の依存関係をバージョン 13.0.0 に更新しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 13.0.0。
• FiveAd SDK バージョン 3.0.0。

バージョン 3.0.0.0

• FiveAd SDK バージョン 3.0.0.0 との互換性を確認しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 12.14.0。
• FiveAd SDK バージョン 3.0.0。

バージョン 2.9.20251119.1

• tagForUnderAgeOfConsent Google Mobile Ads SDK パラメータを FiveAd SDK に転送するサポートを追加しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 12.14.0。
• FiveAd SDK バージョン 2.9.20251119。

バージョン 2.9.20251119.0

• FiveAd SDK バージョン 2.9.20251119 との互換性を確認しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 12.14.0。
• FiveAd SDK バージョン 2.9.20251119。

バージョン 2.9.20250930.0

• FiveAd SDK バージョン 2.9.20250930 との互換性を確認しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 12.12.0。
• FiveAd SDK バージョン 2.9.20250930。

バージョン 2.9.20250912.0

• アダプタが、各広告リクエストの前に FiveAd SDK を初期化するようになりました。
• FiveAd SDK バージョン 2.9.20250912 との互換性を確認しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 12.11.0。
• FiveAd SDK バージョン 2.9.20250912。

バージョン 2.9.20250512.0

• iOS バージョン 13.0 以降が必要になりました。
• FiveAd SDK バージョン 2.9.20250512 との互換性を確認しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 12.4.0。
• FiveAd SDK バージョン 2.9.20250512。

バージョン 2.9.20241106.3

• GADMediationAdapterLine.h がパブリック ヘッダーではない問題を修正しました。
• -fobjc-arc フラグと -fstack-protector-all フラグを有効にしました。
• 読み込みが成功した後の入札におけるバナー広告サイズの検証を削除しました。
  • ウォーターフォール バナー広告は、読み込みが成功すると、バナー広告のサイズをチェックし続けます。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 12.2.0。
• FiveAd SDK バージョン 2.9.20241106。

バージョン 2.9.20241106.2

• FiveAd SDK をテストモードで初期化するかどうかを示す GADMediationAdapterLine.testMode プロパティを追加しました。このフラグは、Google Mobile Ads SDK を初期化する前に設定する必要があります。
• FiveAd SDK を初期化する前に FiveAd SDK の初期化状態をチェックする処理を削除しました。
• ネイティブ広告アセットをダウンロードする前に、非推奨のネイティブ広告の状態チェックを削除しました。
• Google Mobile Ads SDK バージョン 12.0.0 以降が必要になりました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 12.0.0。
• FiveAd SDK バージョン 2.9.20241106。

バージョン 2.9.20241106.1

• 入札バナー広告に最新の広告読み込み API を使用するようにアダプタを更新しました。
• 入札インタースティシャル広告で広告イベントが正しく転送されない問題を修正しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 11.12.0。
• FiveAd SDK バージョン 2.9.20241106。

バージョン 2.9.20241106.0

• FiveAd SDK バージョン 2.9.20241106 との互換性を確認しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 11.12.0。
• FiveAd SDK バージョン 2.9.20241106。

バージョン 2.8.20240827.1

• CFBundleShortVersionString を更新し、4 つではなく 3 つのコンポーネントを持つようにしました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 11.10.0。
• FiveAd SDK バージョン 2.8.20240827。

バージョン 2.8.20240827.0

• FiveAd SDK バージョン 2.8.20240827 との互換性を確認しました。
• バナー、インタースティシャル、リワード、ネイティブの広告フォーマットの入札サポートを追加しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 11.8.0。
• FiveAd SDK バージョン 2.8.20240827。

バージョン 2.8.20240612.0

• GADVideoOptions を介してネイティブ広告の音声制御を追加しました。
• FiveAd SDK バージョン 2.8.20240612 との互換性を確認しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 11.5.0。
• FiveAd SDK バージョン 2.8.20240612。

バージョン 2.7.20240411.0

• FiveAd SDK バージョン 2.7.20240411 との互換性を確認しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 11.3.0。
• FiveAd SDK バージョン 2.7.20240411。

バージョン 2.7.20240318.0

• FiveAd SDK バージョン 2.7.20240318 との互換性を確認しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 11.2.0。
• FiveAd SDK バージョン 2.7.20240318。

バージョン 2.7.20240214.1

• iOS バージョン 12.0 以降が必要になりました。
• Google Mobile Ads SDK バージョン 11.0 以降が必要になりました。
• LineAdapter.xcframework 内のフレームワークに Info.plist を含めました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 11.0.1。
• FiveAd SDK バージョン 2.7.20240214。

バージョン 2.7.20240214.0

• FiveAd SDK バージョン 2.7.20240214 との互換性を確認しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 11.0.1。
• FiveAd SDK バージョン 2.7.20240214。

バージョン 2.7.20240126.0

• FiveAd SDK バージョン 2.7.20240126 との互換性を確認しました。
• FiveAd SDK の新しいデリゲート プロトコルでアダプタの実装を更新しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 10.14.0。
• FiveAd SDK バージョン 2.7.20240126。

バージョン 2.7.20231115.0

• FiveAd SDK バージョン 2.7.20231115 との互換性を確認しました。
• modulemap に GADMediationAdapterLineExtras ヘッダーを含めました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 10.14.0。
• FiveAd SDK バージョン 2.7.20231115。

バージョン 2.6.20230609.1

• バナー広告、インタースティシャル広告、リワード広告が初めて表示される際の音声の初期状態を管理するために GADMediationAdapterLineAudioState を追加しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 10.14.0。
• FiveAd SDK バージョン 2.6.20230609。

バージョン 2.6.20230609.0

• 初回リリース
• バナー、インタースティシャル、リワード、ネイティブの広告フォーマットのウォーターフォール サポートを追加しました。
• FiveAd SDK バージョン 2.6.20230609 との互換性を確認しました。

構築およびテストに使用したバージョン:

• Google Mobile Ads SDK バージョン 10.9.0。
• FiveAd SDK バージョン 2.6.20230609。