Liftoff Monetize 実装ガイド

このガイドでは、Unity LevelPlay で Liftoff Monetize(旧 Vungle )をアドネットワークとして配信するための設定方法を説明します。Liftoff Monetize を使用するには、Vungle SDK が必要になります。

Before you start ironSource SDKの動画リワードインタースティシャル、またはバナーがアプリケーションに正しく実装されていることを確認してください。

Vungle iOS SDK v.6.8.0以降(Vungle アダプター 4.3.6 以降)は Xcode 12 以降をサポートします。 Xcode 11 以前でのビルドはサポートされていません。

ステップ 1. Liftoff Monetize アカウントを作成する

  1. Liftoff Monetize のウェブサイトでアカウントを作成します。
  2. アカウントが認証されると、こちらからログインできるようになります。

ステップ 2. Liftoff Monetize でアプリケーションを作成する

ログインしたら、左上隅の「 Applications 」タブに移動し、「 Add Application 」をクリックします:

ステップ 3. プレースメントを追加する

アプリケーションリストから関連するアプリをクリックし、該当するアプリのページで「 Add Placement 」をクリックします:

次に、Liftoff プレースメントを作成するために必要な詳細を入力、「 Continue 」をクリックし、「 Sounds Good 」ボタンをクリックします:

バナープレースメント
バナー広告のプレースメントを作成するときは、「 Ad Refresh 」オプションを無効にすることをお勧めします。リフレッシュレートは、後に Unity LevelPlay 上で設定可能です。

ステップ 4. LevelPlay ネットワークモジュールで Liftoff Monetize をアクティベートする

Liftoff が LevelPlay と接続して正しく動作するためには、Liftoff アカウントから 4 つのデータを LevelPlay 「 SDK Networks 」モジュールに入力する必要があります:

Liftoff App ID Liftoff システム内のアプリケーション ID
Reporting API ID これは、Liftoff システム内のアプリに紐づく一意の識別子であり、Reporting API でアプリのパフォーマンスを追跡するために使用されます。
Reporting API Key Unity LevelPlay が Liftoff Monetize アカウントからパフォーマンスデータをインポートする際に Reporting API ID とセットで使用される Liftoff アカウントのユニークキーです。
Placement Reference ID これは広告ユニットの一意の識別子であり、動画リワードをインタースティシャル広告やバナー広告と区別するために必要です。

これらの情報を取得したら、LevelPlay で Liftoff のパラメータを設定する必要があります。上記のパラメータを正しく追加すると、Liftoff の広告在庫と Unity LevelPlay メディエーションのレポートデータを最大限に活用できるようになります。

  1. Reporting API Key

    画面の右上隅にある「 My Account 」に移動すると、レポート API キーが表示されます:

  2. Liftoff Monetize Application ID

    左側のメニューの「 Applications 」タブに移動し、LevelPlay ダッシュボードで設定するアプリケーションをクリックすると、Liftoff App ID が表示されます:

  3. Reporting API ID

    同様に、左側のメニューの「 Applications 」タブに移動し、LevelPlay ダッシュボードで設定するアプリケーションをクリックすると、Reporting API ID が表示されます:

  4. Placement Reference ID

    左側のメニューの「 Placements 」タブに移動し、LevelPlay ダッシュボードで設定したいアプリケーションのプレースメントを選択します:

Liftoff Monetize を LevelPlay 上でアクティベートする

全ての必要なパラメータを取得したら、LevelPlay にログインします。

  • MonetizeSetupSDK Networks へ移動します:
    1
  • 「 Available Networks 」の表から Liftoff を選択し、 Liftoff の「 Reporting API Key 」を入力します。この入力は初回のみ必要です:
  • 自動セットアップ機能を有効にするには、Liftoff Monetize 自動セットアップツールをオンに切り替え、Secret Token を入力します。これにより、Liftoff Monetize プラットフォーム上でアプリケーションと Bidder プレースメントを自動的に作成し、LevelPlay が Liftoff からプレースメントの詳細を取得できるようになります。
  • Save 」をクリックすると、 Liftoff は「 Available Networks 」テーブルで有効になります:

ステップ 5. アプリレベルでLiftoffマネタイズを設定する

Non-bidder ウォーターフォール設定

  • SDK Networks ページの左側のリストから実装したいアプリを選択します。
  • Liftoff の「 Setup 」ボタンをクリックし、関連する広告ユニット設定で「 Reporting API Key 」、「 App ID 」、「 Reporting API ID 」、「 Placement Reference ID 」を入力します。
  • 「保存」をクリックすると、ダッシュボードに、Liftoff Monetize がアクティブであることが表示されます。

Bidder 設定

LevelPlay で Liftoff Monetize Bidder を設定するには 2 つの方法があります:

  1. 自動セットアップ – 新しいアプリケーションと bidder プレースメントが自動的に作成され、必要なすべての設定情報が Liftoff Monetize から取得されます。
  2. 手動 – LevelPlay プラットフォームと Liftoff Monetize プラットフォームの両方の管理画面を行き来して必要な情報を取得し、入力します。

自動セットアップ

  • Liftoff Monetize からのインタースティシャル、動画リワード、またはバナーを配信するアプリを選択します。次に、Liftoff Monetize 行の「 Setup 」ボタンまたは「編集」アイコンをクリックします。
  • Add bidder 」 ボタンをクリックすると、Liftoff Monetize プラットフォーム上に新しいアプリと Bidding プレースメントが自動的に作成され、関連する情報がインポートされます。
  • Save 」をクリックしてすべての設定を承認します。保存せずにモジュールを閉じると、アセットは Liftoff Monetize プラットフォーム上に作成されますが、データは LevelPlay プラットフォームにインポートされません。

Important! Liftoff Monetize bidder インスタンスのステータスは、広告ユニットごとに ironSource Ads bidder のステータスと同じになります。たとえば、動画リワードに ironSource Ads bidder を使用していない場合、Liftoff Monetize bidder は有効になりません。動画リワードの Liftoff Monetize bidder インスタンスを有効にするには、「 Liftoff Monetize 」行をクリックし広告ユニットごとのトグルスイッチを有効にします。

手動セットアップ

  • Liftoff Monetize からのインタースティシャル、動画リワード、またはバナーを配信するアプリを選択します。
  • Liftoff Monetize 行の「 Setup 」ボタンまたは「編集」アイコンをクリックし、関連する広告ユニット設定で「 Reporting API Key 」、「 App ID 」、「 Reporting API ID 」、「 Placement Reference ID 」を入力します。
  • Save 」をクリックします。

これで、アカウント内で選択した広告ユニットに対して Liftoff Monetize が有効になっていることが確認できます。

ステップ 5. Vungle アダプターをビルドに追加する

Note: Liftoff Monetize を使用するには、 Vungle SDK をインストールする必要があります。

ironSource SDK は、CocoaPods手動ダウンロードメカニズムの両方をサポートしています。

Cocoapods

InMobi アダプターと SDK を CocoaPods で実装するには、Podfile に次の行を入力します。

pod 'IronSourceVungleAdapter','4.3.38.0'

手動ダウンロード

  1. Vungle アダプターをダウンロード:
    Vungle アダプターと SDK をビルドに追加します。最新の Vungle アダプターはこちら
    Important! Vungle アダプターには Vungle SDK は含まれていません。 Vungle SDK を別途追加する必要があります。
  2. Vungle XCFrameworks をプロジェクトに追加:
    アダプターと SDK ファイルをダウンロードした後、両方の XCframework ファイルを Xcode プロジェクトにドロップします。
  3. iOSステータスバーを削除する:
    最適なユーザーエクスペリエンスを実現するために、Vungle では広告ユニットがユーザーに配信される時に iOS ステータスバーを削除することを強くお勧めしています。これを行うには、Info.plist を開き、「 View controller-based status bar appearance 」キーを追加して、「 No 」に設定します。
広告ネットワークの実装を確認する
  • Integration Helper を使用して広告ネットワークの実装を確認できます。 ironSource SDK は、SDK とネットワークアダプターを正しく実装するためのツールを提供しています。
  • この関数のブール値を使用して、実装されたメディエーションアドネットワークのデバッグログを管理します。
    [IronSource setAdaptersDebug:YES];

    YES 」に設定するとデバッグログが有効になり、デバッグ機能を許可しているすべてのメディエーションアドネットワークのトラブルシューティングに役立ちます。広告を実装したアプリを公開する前に、必ずこのコードを削除してください。この機能は、SDK バージョン 6.5.2 以降でサポートされています。

ステップ 6. Liftoff の追加設定

COPPA ユーザーステータス

Unity LevelPlay を使用すると、パブリッシャーは Vungle COPPA 設定を Liftoff ネットワークに直接通信できます。
この機能は、ironSource SDK 7.2.2 以降、Vungle iOS アダプター 4.3.20 以降で使用できます。Vungle COPPA API の詳細については、こちらをご覧ください。

次の構文を使用して、Vungle の COPPA ユーザーステータスを「 YES 」に設定します:

[IronSource setMetaDataWithKey:@"Vungle_coppa" value:@"Yes"];

次の構文を使用して、Vungle の COPPA ユーザーステータスを「 NO 」に設定します:

[IronSource setMetaDataWithKey:@"Vungle_coppa" value:@"No"];

完了!
これで、アプリで Liftoff Monetize 広告を配信する準備が整いました。


次のステップは?

Unity LevelPlay でさらに他のアドネットワークを活用するには、アダプターを実装し、ガイドに従って設定してください。