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

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

Line のダッシュボード インターフェースでは、ラベル、ボタン、説明に日本語のテキストが使用されています。このガイドのスクリーンショットは翻訳されていません。ただし、このガイドの説明と手順では、ラベルとボタンは英語の対応するものを括弧で囲んで翻訳しています。

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

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

統合
入札
ウォーターフォール  1
形式
バナー
インタースティシャル
特典
ネイティブ

1 ウォーターフォールの統合はオープンベータ版です。

要件

  • iOS デプロイ ターゲットが 12.0 以降であること

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

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

新しいアプリケーションの追加

[所有管理（広告スロット管理）] > [メディア（メディア）] をクリックします。[作成（新規作成）] をクリックします。

フォームに必要事項をご記入のうえ、[登録] をクリックします。

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

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

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

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

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

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

ステップ 2: UI で AdMob 回線需要を設定する

広告ユニットのメディエーション設定を行う

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

AdMob アカウントにログインします。次に、[メディエーション] タブに移動します。既存のメディエーション グループを編集する場合は、そのメディエーション グループの名前をクリックして編集し、広告ソースとして Line を追加するに進んでください。

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

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

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

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

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

広告ソースとして Line を追加

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

[Line] を選択します。 次に、Line の eCPM の値を入力し、[続行] をクリックします。

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

次に、前のセクションで取得した Application ID and Slot IDを入力します。[完了] をクリックします。

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

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

pod 'GoogleMobileAdsMediationLine'

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

pod install --repo-update

手動による統合

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

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

SKAdNetwork との統合

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

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

テスト広告を有効にする

AdMob。

Line のドキュメント の手順に沿って、LINE テスト広告を有効にします。

テスト広告を確認する

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

省略可能なステップ

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

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

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

以下は、これらのパラメータを設定する広告リクエストを作成するコードの例です。

Swift

import LineAdapter
// ...

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

Objective-C

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

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

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

広告レンダリング

ラインアダプタにより、次の ネイティブ広告の高度なフィールドの説明 が GADNativeAd で指定されたユーザー ID。

項目 アセットが常にラインアダプターで含まれる
見出し
画像
Body
アプリアイコン 1
行動を促すフレーズ
評価
格納
Price

1 ネイティブ広告の場合、Line SDK はアプリアイコン アセットを提供しません。代わりに、Line アダプタはアプリアイコンに透明な画像を入力します。

エラーコード

アダプタが Line から広告を受信できない場合は、次のクラスの GADResponseInfo.adNetworkInfoArray:

GADMediationAdapterLine

広告の読み込みに失敗したときに 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 アセットが不足しているため、ネイティブ広告を読み込めませんでした。
1～10 Sent by 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 iOS メディエーション アダプタに関する変更履歴

バージョン 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。