ドキュメント

​
​

Development

User Acquisition

Monetization

産業

LevelPlay SDK - iOS

Unity SDK

Android SDK

iOS SDK

Adobe AIR SDK

Flutter SDK

React Native SDK

LevelPlay SDK - iOS

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

iOS の詳細設定

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

セグメントの定義

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

Pass ユーザープロパティ

LevelPlay プラットフォームでセグメントを定義したら、サーバーにユーザーの詳細情報を通知する必要があります。LevelPlay には、API でユーザーをセグメントにアトリビュートするように設定できる、範囲な標準ユーザープロパティが用意されています。
まず、セグメントを初期化します。
LPMSegment *セグメント = [[LPMSegment alloc]init];
let セグメント:LPMSegment = LPMSegment()
セグメントのベースとなるサーバーに送信するプロパティを定義します。 この情報は以下のいずれかの方法で送信できます。
  1. ユーザーが属するセグメントに精通している場合は、セグメント名を入力します。
    [segment setSegmentName:YOUR_SEGMENT_NAME];
    segment.segmentName = "YOUR_SEGMENT_NAME"
  2. ユーザー詳細をお送りください。説明は下の表を参照してください。
    // ユーザーレベルの設定[segment setLevel:USER_LEVEL];// ユーザーの支払い状態の設定[セグメント setPaying:ユーザー_支払い];// ユーザーの合計アプリ内課金履歴の設定[segment setIapTotal:YOUR_IAP_TOTAL];// ユーザー作成日の設定[segment setUserCreationDate:YOUR_DATE];
    // ユーザーのアプリケーション内課金の合計を設定するsegment.iapTotal = USER_IAP_TOTAL// ユーザーのレベルを設定segment.level = USER_LEVEL// ユーザーの支払い状態の設定segment.paying = USER_PAYING_STATUS// ユーザー作成日の設定segment.userCreationDate = NSDate() as Date!
    さらに、セグメントごとに最大5つのカスタムユーザープロパティを設定できます。
    [segment setCustomValue:YOUR_CUSTOM_VALUE forKey:YOUR_CUSTOM_KEY];
    segment.setCustomValue("CUSTOM_VALUE", forKey:"CUSTOM_KEY")
    次に、セグメントに基づいて広告ユニットを配信するには、セグメント名またはユーザープロパティーのいずれかを指定して以下の機能を呼び出します。
    [LevelPlay setSegment:YOUR_SEGMENT];
    LevelPlay.setSegment(YOUR_SEGMENT);

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

セグメントプロパティ

型

制限

説明

segmentNameString- 英数字 - 最大 32 文字LevelPlay アカウントのセグメントの指定された名前
支払いBooleanYes または No- ユーザーがアプリケーション内課金にお金を使ったことがない場合は true - ユーザーがアプリケーション内課金にお金を使ったことがない場合は false
iap_totalダブル1-999999.99ユーザーがアプリケーション内課金に費やした金額の合計
userCreationDateNSDate0 より小さい値にすることはできませんユーザーがアプリケーションをインストールした日付
カスタムパラメーターkey=string, value=string- LevelPlay は、最大 5 つのカスタムパラメーター (英数字 - 最大 32 文字) をサポートします。サーバにディスパッチする追加データ

ユーザーのセグメント名の取得

  1. クラスでこのインターフェースを使用して、セグメント名プロトコルに準拠し、セグメント名
    LPMSegmentDelegate
    の受信を有効にします。
  2. 以下のデリゲートに登録して、ユーザーが属するセグメント名を取得します。その後、SDKはデリゲートにイベントを通知します。
    [LevelPlay setSegmentDelegate:self];
    LevelPlay.setSegmentDelegate(self)
    デリゲートコールバックの実装:例を次に示します。
    - (void)didReceiveSegment:(NSString *)segment;
    func didReceiveSegment(_ segment:文字列!)

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

LevelPlay SDK 8.11.0 から、サーバー間 (S2S) コールバックでサーバーに送信されるリワード広告ユニットにカスタムパラメーターを渡すことができます。キー
LevelPlay_Rewarded_Server_Params
と JSON 文字列値を
setMetaData
してパラメータを設定します。
  • カスタムパラメータは、サーバー間の完了コールバックとともにのみ機能します。パラメーターはコールバックバックの一部として受け取ります。
  • 複数のカスタムパラメーターを挿入できます。
例:
NSDictionary *params = @{ @"key1": @"value1", @"key2": @"value2" };NSData *jsonData = [NSJSONSerialization dataWithJSONObject:params options:0 error:nil];NSString *jsonString = [[NSString alloc] initWithData:jsonData encoding:NSUTF8StringEncoding];[LevelPlay setMetaDataWithKey:@"LevelPlay_Rewarded_Server_Params" value:jsonString];
let params = ["key1": "value1", "key2": "value2"]if let jsonData = try?JSONSerialization.data(withJSONObject: params), let jsonString = String(data: jsonData, encoding: .utf8) { LevelPlay.setMetaData(withKey:"LevelPlay_Rewarded_Server_Params", value: jsonString)}

価格下限の設定

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

プロパティ

型

説明

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

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

// 価格下限設定の定義LPMInterstitialAdConfig *adConfig = [[LPMInterstitialAdConfigBuilder new] setBidFloor:1.23] ビルド]; // 米ドルで最低価格を設定// 設定をインタースティシャル広告単位に適用LPMInterstitialAd *interstitialAd = [[LPMInterstitialAd alloc] initWithAdUnitId:@"adUnitId" config:adConfig];
// 価格下限設定の定義let adConfig = LPMInterstitialAdConfigBuilder() .set(bidFloor:1.23) // 米ドルでの価格下限の設定 .build()// 設定をインタースティシャル広告単位に適用let interstitialAd = LPMInterstitialAd(adUnitId: "adUnitId", config: adConfig)
インタースティシャルの完全な実装は、こちらで利用できます。

リワード広告の例

// 価格下限設定の定義LPMRewardedAdConfig *adConfig = [[LPMRewardedAdConfigBuilder new] setBidFloor:1.23] ビルド]; // 米ドルで下限価格を設定// リワード型広告単位に設定を適用LPMRewardedAd *rewardedAd = [[LPMRewardedAd alloc] initWithAdUnitId:@"adUnitId" config:adConfig];
// 価格下限設定の定義let adConfig = LPMRewardedAdConfigBuilder() .set(bidFloor:1.23) // 米ドルでの価格下限の設定 .build()// リワード型広告単位に設定を適用let rewardedAd = LPMRewardedAd(adUnitId: "adUnitId", config: adConfig)
リワード広告の完全実装は、こちらで利用できます。

バナー広告の例

// 価格下限設定の定義LPMBannerAdViewConfig *adConfig = [[LPMBannerAdViewConfigBuilder new] setBidFloor:1.23] ビルド]; // 米ドルで下限価格を設定// バナー広告単位に設定を適用LPMBannerAdView *bannerAd = [[LPMBannerAdView alloc] initWithAdUnitId:@"adUnitId" config:adConfig];
// 価格下限設定の定義let adConfig = LPMBannerAdViewConfigBuilder() .set(bidFloor:1.23) // 米ドルでの価格下限の設定 .build()// バナー広告単位に設定を適用let bannerAd = LPMBannerAdView(adUnitId: "adUnitId", config: adConfig)
バナー広告の完全な実装は、こちらで利用できます。

LevelPlay SDK のエラーコード

LevelPlay は、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 ユーザープロパティ

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

      • ユーザーのセグメント名の取得

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

    • 価格下限の設定

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

      • リワード広告の例

      • バナー広告の例

    • LevelPlay SDK のエラーコード


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