Flutter の詳細設定
ユーザー・セグメント、カスタム・パラメータ、価格帯など、FlutterのSDKの詳細設定を構成して、広告の配信とMonetizationを最適化します。
読み終わるまでの所要時間 15 分最終更新 6日前
セグメントの定義
特定のオーディエンスに合わせて広告の配信方法を簡単に調整できるようになりました。ユーザーの詳細をサーバーに通知して、ユーザーが属するセグメントに応じてSDKが広告を配信するようにする必要があります。
Unity LevelPlay SDK は、Unity でユーザーセグメントのアウトラインを作成する以下の方法をサポートします。
メソッド | 説明 | ノート |
|---|---|---|
| デバイス プロパティ | Unity LevelPlay SDK は、場所、デバイスモデル、デバイス製造元、アプリケーションバージョン、OS など、ユーザーのデバイスに関連する特定の標準パラメーターを自動的に収集します。 | このデータを Unity と共有する必要はありません。 |
| ユーザープロパティ | 作成日などの包括的なユーザーデータ (後述のサポートされているセグメントプロパティの完全なリストを参照) は、API を通じてリレーする必要があります。 | 指示に従ってユーザーの詳細を送信し、LevelPlay プラットフォームで定義したセグメントに基づいて SDK がさまざまなユーザーを分類できるようにします。 |
| カスタムセグメント | ユーザーの詳細をサーバーに送信せずにカスタムセグメントを作成し、そのユーザーセグメントの広告設定を調整できます。 |
注
LevelPlay SDK 7.2.0 以降を使用している場合は、LevelPlaySegment API を使用してセッション中にセグメントを変更できます。これは次にロードされる広告に影響し、各広告単位をロードする前に呼び出すことでウォーターフォールに動的に影響します。LevelPlay のセグメント化の詳細については、こちらを参照してください。
Pass ユーザープロパティ
LevelPlay プラットフォームでセグメントを定義したら、Unity のサーバーにユーザーの詳細を通知する必要があります。
セグメントのベースとなる Unity サーバに送信するプロパティを定義します。この情報は、以下のいずれかの方法で送信できます。
-
ユーザーが属するセグメントに精通している場合は、セグメント名を入力します。segment.setSegmentName(name);
-
Unity にユーザー詳細を送信します。LevelPlay SDK は、API でユーザーをセグメントにアトリビュートするように設定できる、範囲な標準ユーザープロパティを提供します。サポートユーザーセグメントのプロパティの表を下にスクロールします。final segment = LevelPlaySegment();segment.level = levelParam;segment.isPaying = isPayingParam;segment.userCreationDate = dateTimeParam;segment.iapTotal = iaptParam;// up to 5 custom paramssegment.setCustom(key:'CustomKey1', 値:'CustomVal1');// Set LevelPlay SegmentLevelPlay.setSegment(segment);
サポートされるユーザーセグメントプロパティ
セグメントプロパティ | Type (タイプ) | 制限 | 説明 |
|---|---|---|---|
| String |
| LevelPlay アカウントで指定されたセグメント名 |
| 支払 | Boolean | true または false |
|
| iap_total | Double | 1-999999.99 | ユーザーがアプリ内課金に費やした金額の合計 |
| userCreationDate | Long | 0 より小さい値にすることはできません | ユーザーがアプリケーションをインストールした日付（ミリ秒単位） |
| Custom Parameters | key=string, value=string |
| サーバにディスパッチする追加データ |
リワードサーバーからサーバーへのコールバックのカスタムパラメーター
LevelPlay 報酬ベースの広告ユニットは、広告完了イベントの成功後にユーザーに付与する必要があるゲーム内報酬を通知するサーバー側のイベントをサポートします。詳細については、サーバ間コールバック設定 を参照してください。
ランタイム カスタム パラメータをクライアント経由で共有することもできます。これを実装するには、 API を使用してカスタムパラメーターをに渡します。カスタム パラメータは、以前の値を上書きしてセッションを通じて複数回更新できます。
setMetadataLevelPlay_Rewarded_Server_Paramsカスタム パラメータをリセットするには、 を空の配列に設定します。
LevelPlay_Rewarded_Server_Params実装コード例
LevelPlay.setMetaData({ 'LevelPlay_Rewarded_Server_Params': ['key1=value1', 'key2=value2'],});
その後、以下のようなコールバックを受け取ります。
http://www.mydomain.com/rewardsCallback?appUserId=[ユーザー ID]&ゲーム内報酬=[ゲーム内報酬]&eventId=[イベント ID]&itemName=[項目名]&custom_key1=値1&custom_key2=値2
LevelPlay SDK のエラーコード
Unity LevelPlay は、SDK インテグレーションで障害が発生した場合に説明を提供するエラーフィードバックメカニズムを提供します。これらのエラーは、問題が発生したときやインテグレーションのアスペクトが正しく完了しなかったときに発生します。
LevelPlay Error オブジェクトには、エラー コードとエラー メッセージが含まれます。以下は、考えられるすべてのエラーと、その機能に基づくメッセージです。
エラーコード | 広告ユニット | 説明 |
|---|---|---|
| 508 | N/A |
|
| 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 | (表示できる広告がない場合に呼び出される RV の表示)
| 1035 | インタースティシャル | Empty Waterfall |
| 1036 | インタースティシャル | Show Fail:別のインタースティシャルが表示されている間はインタースティシャルを表示できない |
| 1037 | インタースティシャル | ロード失敗:別のインタースティシャルが表示されている間はインタースティシャルをロードできません |
| 1039 | インタースティシャル | show interstitial | の呼び出し中の例外