アドバンスト設定
ユーザー ID の設定
サーバー間コールバックを使用してリワード広告ユニットでユーザーにリワードを提供している場合、または Ad Quality ユーザージャーニーを使用する場合は、setUserID メソッドを使用して各ユーザーにユニークな識別子( UserID )を定義する必要があります。
userID 設定はユーザーデータのロスを防ぐため、init リクエストの前に行う必要があります。userID には、1 〜 64 文字のユニークな英数字を使用してください。
セグメントの定義
特定のオーディエンスに合わせて広告の配信方法を簡単にカスタマイズできるようになりました。ユーザーが属するセグメントに従って SDK が広告を配信できるように、ユーザーの詳細を ironSource のサーバーに通知する必要があります。
ironSource SDK は、ユーザーセグメントのアウトラインのために、サーバーにデータを伝達する三つの方法をサポートしています:
- デバイスのプロパティ:ironSource SDK は、位置情報、デバイスモデル、デバイスの製造元、アプリのバージョン、OS など、ユーザーのデバイスに関連する特定の標準パラメーターを自動的に収集します。したがって、このデータを手動で送信する必要はありません。
- ユーザープロパティ:年齢、性別、作成日などの包括的なユーザーデータ(サポートされている全てのセグメントプロパティのリストと以下の説明を参照)は、API で中継する必要があります。LevelPlay プラットフォームで定義したセグメントに基づいて SDK がさまざまなユーザーを分類できるよう、指示に従ってユーザーの詳細を送信してください。
- カスタムセグメント:ユーザーの詳細をそのままサーバーへ送信せずに、アプリ側で事前に定義された条件でカスタムセグメントを作成し、そのユーザーセグメントの広告設定を調整できます。
これは次に読み込まれる広告に影響するので、各広告ユニットを読み込む前に呼び出すことで動的にウォーターフォールに影響を与えることができます。 LevelPlay セグメントの詳細については、こちらをご覧ください。
ユーザープロパティを渡す
LevelPlay プラットフォームでセグメントを定義したら、サーバーにユーザーの詳細を通知する必要があります。
セグメントのベースとするための、サーバーに送信するプロパティを定義します。この情報は、次のいずれかの方法で送信できます:
- ユーザーが属するセグメントが分かる場合は、セグメント名を入力します:
- ユーザーの詳細を送信します。ironSource SDK は、セグメントにユーザーを関連付けるために設定できる一連の標準ユーザープロパティをAPIで提供します。下にスクロールして、サポートユーザーセグメントのプロパティの表をご覧ください。
サポートされているユーザーセグメントのプロパティ
Segment Properties | Type | Limitation | Description |
segmentName | String |
|
LevelPlay アカウントで設定したセグメント名 |
Age | Int | 1-99 | ユーザーの年齢 |
Gender | String | female または male | ユーザーの性別 |
Paying | Boolean | True または False |
|
iap_total | Double | 1-999999.99 | ユーザーがアプリ内課金に費やした累計金額 |
userCreationDate | Long | 0または0以上 | ユーザーがアプリをインストールした日付のミリ秒 |
Custom Parameters | key=string, value=string |
|
サーバーに送信したい追加データ |
カスタムパラメーター
ironSource SDK は、動画リワードのカスタムパラメーターをサポートします。広告ユニットの初期化時にカスタムパラメータを渡し、ユーザーの完了イベント時にパラメータを受け取ることができます。
これで、LevelPlay メディエーションプラットフォーム上のすべてのメディエーションネットワークにカスタムパラメータを渡すことができます。
- カスタムパラメーターは、サーバー間の完了コールバックとのみ連携して機能し、コールバック文字列の一部としてパラメータを受け取ります。
- init リクエストに複数のカスタムパラメータを挿入できます。
実装コード
動画リワード
- カスタムパラメータは、セッションごとに数回設定できます。
- 値をリセットするには、clearRewardedVideoServerParameters を使用してから、新しい値を設定します。
ironSource SDK エラーコード
ironSource は、SDK実装の失敗の説明を提供するエラーフィードバックメカニズムを提供します。何か問題が発生した場合、または実装の一部が正しく完了しなかった場合に、これらのエラーが発生します。
ironSource Error オブジェクトには、error code と message が含まれています。以下これらはすべて、考えられるエラーとその機能に基づくメッセージです:
Error Codes | Ad Unit | Description |
508 | N/A | • メディエーション・ネットワークの初期化失敗 • Demand Only モード以外で Demand Only API が呼ばれた • Demand Only モードで Demand Only ではない API が呼ばれた |
509 | Interstitial | 表示失敗:表示できる広告が無い |
Rewarded Video | ||
510 | Interstitial | ロード失敗:サーバーレスポンス失敗 |
Rewarded Video | ||
Banner | ||
520 | Interstitial | 表示失敗:インターネット接続無し( ShouldTrackNetworkState が有効の場合) |
Rewarded Video | 表示失敗:インターネット接続無し | |
524 | Interstitial | 表示失敗:プレースメントがペーシング制限に達している 表示失敗:プレースメントがキャッピング制限に達している |
Rewarded Video | ||
526 | Interstitial | 表示失敗:広告ユニットが一日のキャッピング制限に達している |
Rewarded Video | ||
1007 | Interstitial | オークション失敗:オークションリクエストに必要な情報を全て含まれていない |
Rewarded Video | ||
1022 | Rewarded Video | 表示失敗:RV 表示中に新たな RV の表示は不可 |
1023 | Rewarded Video | 表示失敗:表示できる広告がない時に Show RV が呼ばれた |
1036 | Interstitial | 表示失敗:インタースティシャルの表示中に新たなインタースティシャルの表示は不可 |
1037 | Interstitial | ロード失敗:インタースティシャルの表示中に新たなインタースティシャルのロードは不可 |
1055 | Rewarded Video | ロード失敗:タイムアウトによるロードキャンセル |
1056 | Rewarded Video | ロード失敗: RV の表示中に新たな RV のロードは不可 |