ドキュメント

​
​

Development

User Acquisition

Monetization

産業

LevelPlay SDK - Android

Unity SDK

Android SDK

iOS SDK

Adobe AIR SDK

Flutter SDK

React Native SDK

LevelPlay SDK - Android

Unity LevelPlay
​
​
Android SDK
  • 使用の準備
  • 規制と設定
    • 規制の詳細設定
    • Android の詳細設定
    • インプレッションレベルの収益インテグレーション
    • AdInfo インテグレーションによる LevelPlay リスナー
  • Ad formats (広告フォーマット)
  • メディエーションネットワーク
  • インテグレーションのテスト
  1. ゲームの成長
  2. Unity LevelPlay
  3. LevelPlay SDK
  4. Android 開発者向け LevelPlay SDK

Android の詳細設定

ユーザー・セグメント、カスタム・パラメータ、価格帯など、Androidの詳細設定を構成して、広告の配信とMonetizationを最適化します。
読み終わるまでの所要時間 17 分
最終更新 6日前

セグメントの定義

特定のオーディエンスに合わせて広告の配信方法を簡単に調整できるようになりました。ユーザーの詳細をサーバーに通知して、ユーザーが属するセグメントに応じてSDKが広告を配信するようにする必要があります。
LevelPlay SDK は、データをサーバーに送信してユーザーセグメントのアウトラインを作成する 3 つの方法をサポートしています。
  • デバイスプロパティ: LevelPlay SDK は、場所、デバイスモデル、デバイス製造元、アプリケーションバージョン、OS など、ユーザーのデバイスに自動的に関連する特定の標準パラメータを収集します。このデータを当社に送信する必要はありません。
  • ユーザープロパティ: 包括的なユーザーデータ (例えば、年齢、性別、作成日) は API を通じてリレーする必要があります。(サポートされているセグメント プロパティの全リストと以下のセクションの説明を参照してください。)指示に従ってユーザーの詳細を送信し、LevelPlay プラットフォームで定義したセグメントに基づいて SDK がさまざまなユーザーを分類できるようにします。
  • カスタムセグメント: ユーザーの詳細をサーバに送信せずにカスタムセグメントを作成し、そのユーザーセグメントの広告設定を調整できます。
動的セグメント化
LevelPlay SDK 7.2.0 以降を使用している場合は、LevelPlaySegment API を使用してセッション中にセグメント化を変更できます。
これは次にロードされる広告に影響し、各広告単位をロードする前に呼び出すことで、 ウォーターフォール に動的に影響します。LevelPlay のセグメント化の詳細については、こちらを参照してください。

Pass ユーザープロパティ

LevelPlay プラットフォームでセグメントを定義したら、サーバーにユーザーの詳細情報を通知する必要があります。
セグメントのベースとなるサーバーに送信するプロパティを定義します。この情報は以下のいずれかの方法で送信できます。
  1. ユーザーが属するセグメントに精通している場合は、セグメント名を入力します。
mLPSegment.setSegmentName(name);
  1. ユーザー詳細をお送りください。LevelPlay SDK は、API でユーザーをセグメントにアトリビュートするように設定できる、範囲な標準ユーザープロパティを提供します。サポートユーザーセグメントのプロパティの表を下にスクロールします。
// Create segment objectmLPSegment = new LevelPlaySegment();// Set user's levelmLPSegment.setLevel(level);// Set user creation datemLPSegment.setUserCreationDate(date);// Set user's total in-app purchasesmLPSegment.setIAPTotal(iapt);// Set user's paying statusmLPSegment.setIsPaying(isPaying);
さらに、セグメントごとに最大5つのカスタムユーザープロパティを設定できます。
// Set custom parameters (up to 5)mLPSegment.setCustom(key, value);
次に、セグメントに基づいて広告ユニットを提供し、ユーザーの広告体験を調整するには、セグメント名またはユーザープロパティを指定して以下の機能を呼び出します。
LevelPlay.setSegment(mLPSegment);

サポートされるユーザーセグメントプロパティ

セグメントプロパティ

型

制限

説明

segmentNameString最大 32 文字の英数字LevelPlay アカウントのセグメントの指定された名前
支払いBooleantrue または falseユーザーがアプリケーション内課金に課金した場合は true、ユーザーがアプリケーション内課金に課金しなかった場合は false
iap_totalダブル1-999999.99ユーザーがアプリケーション内課金に費やした金額の合計
userCreationDateロング0 より小さい値にすることはできませんユーザーがアプリケーションをインストールした日付(ミリ秒単位)
カスタムパラメーターkey=string, value=stringLevelPlay SDK は、最大 5 つのカスタムパラメーターと最大 32 文字の英数字をサポートします。サーバにディスパッチする追加データ
ユーザーが属するセグメント名を受け取るには、以下のコールバックに登録します。コールバック文字列 (セグメント名) が空を返す場合、LevelPlay セグメントモジュールでユーザーに関連するセグメントが見つかりませんでした。
SegmentListener onSegmentReceived(文字列セグメント){}

リワードサーバーからサーバーへのコールバックのカスタムパラメーター

LevelPlay 報酬ベースの広告ユニットは、広告完了イベントの成功後にユーザーに付与する必要があるゲーム内報酬を通知するサーバー側のイベントをサポートします。詳細については、こちらを参照してください。
サーバーパラメーターに加えて、実行時のカスタムパラメーターをクライアント経由で共有できます。これを実装するには、setMetaData API を使用してカスタムパラメーターを LevelPlay_Rewarded_Server_Params に渡します。カスタムパラメーターは、セッションを通じて複数回更新され、以前の値がオーバーライドされます。
カスタム パラメータをリセットするには、LevelPlay_Rewarded_Server_Params を空の配列に設定します。

実装コード例

LevelPlay.setMetaData("LevelPlay_Rewarded_Server_Params", List.of("key1=value1", "key2=value2"));
LevelPlay.setMetaData("LevelPlay_Rewarded_Server_Params", listOf("key1=value1", "key2=value2"))
その後、対応するコールバックを受け取ります。例:
http://www.mydomain.com/rewardsCallback?appUserId=[ユーザー ID]&ゲーム内報酬=[ゲーム内報酬]&eventId=[イベント ID]&itemName=[項目名]&custom_key1=値1&custom_key2=値2
注
最低 LevelPlay SDK 8.11.0最大 2,048 文字

Price Floor設定

フロア設定 API では、特定の広告単位に下限を設定できます。ユーザーごとに最低価格を設定することで、ターゲティングの効率を高め、待ち時間を削減し、広告パフォーマンスを最適化できます。
価格下限は広告オブジェクトの作成時に割り当てる必要があり、そのオブジェクトのその後のすべてのロードに適用されます。
ノート:Min SDK 8.9.0

プロパティ

型

説明

入札フロアdouble従来のインスタンスと入札者に適用される最小 eCPM を定義する米ドルの価格。

インタースティシャル広告の例

// Define a price floor configurationvar adConfig = new LevelPlayInterstitialAd.Config.Builder() .setBidFloor(1.23) // Set the price floor in USD .build();// Apply the configuration to an interstitial ad unitvar interstitialAd = new LevelPlayInterstitialAd("adUnitId", adConfig);
インタースティシャルの完全な実装は、こちらで利用できます。

リワード広告の例

// Define a price floor configurationval adConfig = LevelPlayRewardedAd.Config.Builder() .setBidFloor(1.23) // Set the price floor in USD .build()// Apply the configuration to a rewarded ad unitval rewardedAd = LevelPlayRewardedAd("adUnitId", adConfig)
リワード広告の完全実装は、こちらで利用できます。

バナー広告の例

// Define a price floor configurationvar adConfig = new LevelPlayBannerAd.Config.Builder() .setBidFloor(1.23) // Set the price floor in USD .build();// Apply the configuration to a banner ad unitvar bannerAd = new LevelPlayBannerAdView(context, "adUnitId", adConfig);
バナー広告の完全な実装は、こちらで利用できます。

LevelPlay SDK エラーコード

LevelPlay SDK は、SDK インテグレーションの障害を説明するエラーフィードバックメカニズムを提供します。これらのエラーは、問題が発生したときやインテグレーションのアスペクトが正しく完了しなかったときに発生します。
LevelPlay Error オブジェクトには、エラー コードとメッセージが含まれます。以下は、考えられるすべてのエラーと、その機能に基づくメッセージです。
(表示する広告がありません)
(表示できる広告がない場合に呼び出される RV の表示)
の呼び出し中の例外

エラーコード

広告ユニット

説明

508N/A
  • メディエーション/ネットワークの初期化失敗
  • Demand Only API を非 Demand Only モードで呼び出す
  • Demand Only モードで Demand Only 以外の API を呼び出す
509 インタースティシャル、動画リワード Show Fail:No ads to show
510インタースティシャル、動画リワード、バナーロード失敗:サーバー反応失敗
520インタースティシャル、動画リワード
Show Fail:インターネット接続なし。TrackNetworkState が有効になっている必要があります。 Show Fail:インターネット接続なし
524インタースティシャル、動画リワード
Show Fail:配置%@ はペースごとに定義された制限に達しました Show Fail:配置%@ が制限に達しました
526インタースティシャル、動画リワードShow Fail:広告単位がセッションあたりの 1 日の上限に達しました
604バナー配置に上限があるためロードできません
605バナーバナーのロード中に予期しない例外が発生しました
606バナー最初のロード時にすべてのネットワークでバナーが埋められない
1007インタースティシャル、動画リワードオークション失敗:オークションリクエストに必要な情報がすべて含まれていませんでした
1022動画リワードShow Fail:別の RV が表示されている間は RV を表示できない
1023 動画リワード Show Fail:Show RV called when there are no available ads to show
1035インタースティシャルEmpty Waterfall
1036インタースティシャルShow Fail:別のインタースティシャルが表示されている間はインタースティシャルを表示できない
1037インタースティシャルロード失敗:別のインタースティシャルが表示されている間はインタースティシャルをロードできません
1039 インタースティシャル show interstitial

Copyright © 2026 Unity Technologies
法規事項プライバシーポリシークッキーDocumentation Terms of Use私の個人情報を販売または共有しないプライバシーに関する選択 (クッキー設定)

"Unity" の名称、Unity のロゴ、およびその他の Unity の商標は、米国およびその他の国における Unity Technologies またはその関係会社の商標または登録商標です (詳しくはこちら)。その他の名称またはブランドは該当する所有者の商標です。

一部のページは利便性向上のため機械翻訳を使用しており、内容に不正確な表現が含まれる場合があります。内容に齟齬または不一致が生じた場合は、英語版を正本とします。

  • このページ
    • セグメントの定義

      • Pass ユーザープロパティ

      • サポートされるユーザーセグメントプロパティ

    • リワードサーバーからサーバーへのコールバックのカスタムパラメーター

      • 実装コード例

    • Price Floor設定

      • インタースティシャル広告の例

      • リワード広告の例

      • バナー広告の例

    • LevelPlay SDK エラーコード


このページの問題を報告する