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

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

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

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

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

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

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

要件

  • iOS デプロイ ターゲットが 12.0 以降
  • 最新の Google Mobile Ads SDK

  • メディエーションのスタートガイドを完了していること

ステップ 1: Line UI で構成をセットアップする

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

新しいアプリを追加する

[広告枠管理] > [メディア] をクリックします。次に、[お知らせ(新規作成)] をクリックします。

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

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

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

入札とウォーターフォールの両方の統合で広告プレースメントを作成する手順は同じです。各広告プレースメントは、どちらにも使用できます。

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

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

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

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

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

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

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

pod 'GoogleMobileAdsMediationLine'

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

pod install --repo-update

手動による統合

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

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

SKAdNetwork の統合

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

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

テスト広告を有効にする

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

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

テスト広告を確認する

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

省略可能なステップ

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

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

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

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

Swift

import LineAdapter
// ...

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

Objective-C

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

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

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

広告のレンダリング

Line アダプタは、 GADNativeAd

フィールド ライン アダプタによって常に含まれるアセット
広告見出し
画像
本文
アプリのアイコン 1
行動を促すフレーズ
評価
ストア
価格

1 ネイティブ広告の場合、Line SDK にはアプリアイコン アセットは用意されていません。代わりに、Line アダプタはアプリアイコンに透明な画像を配置します。

エラーコード

アダプターが Line から広告を受信できない場合は、 GADResponseInfo.adNetworkInfoArray 次のクラスに追加します。

GADMediationAdapterLine

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

エラーコード ドメイン 理由
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 iOS メディエーション アダプタの変更履歴

バージョン 2.8.20240827.1

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

以下を使用してビルドとテストを行う:

  • 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。