その他の SDK 設定

セグメントの定義

特定のオーディエンスに合わせて広告の配信方法を簡単にカスタマイズできるようになりました。ユーザーが属するセグメントに従って SDK が広告を配信できるようにするには、ユーザーの詳細を LevelPlay のサーバーに通知する必要があります。

LevelPlay SDK は、ユーザーセグメントのアウトラインのために、以下の3つの方法で LevelPlay サーバーへデータを送信することができます：

• デバイスのプロパティ：LevelPlay SDK は、位置情報、デバイスモデル、デバイスの製造元、アプリのバージョン、OS など、ユーザーのデバイスに関連する特定の標準パラメーターを自動的に収集します。したがって、このデータを手動で送信する必要はありません。
• ユーザープロパティ：作成日などの包括的なユーザーデータ（サポートされている全てのセグメントプロパティのリストと以下の説明を参照）は、API で中継する必要があります。LevelPlay プラットフォームで定義したセグメントに基づいて SDK がさまざまなユーザーを分類できるよう、指示に従ってユーザーの詳細を送信してください。
• カスタムセグメント：ユーザーの詳細をサーバーに伝達せずに、事前定義された条件でカスタムセグメントを作成し、LevelPlay プラットフォームでそのユーザーセグメントの広告設定をカスタマイズすることができます。

ユーザープロパティを渡す

LevelPlay プラットフォームでセグメントを定義したら、サーバーにユーザーの詳細を通知する必要があります。

セグメントのベースとするための、サーバーに送信するプロパティを定義します。この情報は、次のいずれかの方法で送信できます：

1. ユーザーが属するセグメントが分かる場合は、セグメント名を入力します：

   var segment = new LevelPlaySegment();
   segment.SegmentName = "nameOfSegment";

2. それ以外の場合は、ユーザーの詳細を送信します。LevelPlay は、セグメントにユーザーを関連付けるために設定できる一連の標準ユーザープロパティをAPIで提供します。下にスクロールして、サポートユーザーセグメントのプロパティの表をご覧ください。

   var segment = new LevelPlaySegment();
   segment.Level = 5;
   segment.UserCreationDate = 1758100075134;
   segment.IapTotal = 100;
   segment.IsPaying = 1;

また、各セグメントに最大５つのカスタムユーザープロパティを設定することもできます：

var key = "key1";
var val = "value1";

var segment = new LevelPlaySegment();
segment.SetCustom(key, val);

次に、セグメントに基づいて広告ユニットを配信し、ユーザーの広告体験を調整するには、セグメント名またはユーザープロパティを設定し、次の関数を呼び出します：

LevelPlay.SetSegment (segment);

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

動画リワードサーバーコールバック用のカスタムパラメータ

LevelPlay の動画リワード広告ユニットは、広告完了イベントが成功した後にユーザーに付与する必要がある報酬を通知するサーバー側イベントをサポートしています。詳細はこちら。

サーバーパラメータに加えて、クライアントを通じてランタイムカスタムパラメータを共有できます。実装には、setMetadata API を使用して、カスタムパラメータを LevelPlay_Rewarded_Server_Params に渡します。カスタムパラメータはセッション中に複数回更新でき、以前の値を上書きできます。

カスタムパラメータをリセットするには、LevelPlay_Rewarded_Server_Params に空の配列を設定します。

実装例

LevelPlay.SetMetaData("LevelPlay_Rewarded_Server_Params", new [] { "key1=value1", "key2=value2" });

上記例では次のようなコールバックを受信します：

http://www.mydomain.com/rewardsCallback?appUserId=[USER_ID]&rewards=[REWARDS]&eventId=[EVENT_ID]&itemName=[ITEM_NAME]&custom_key1=value1&custom_key2=value2

Pause Game

SetPauseGame API は、LevelPlay SDK バージョン 8.5.0 の一部として LevelPlay Class に導入され、iOS アプリのみに対応しています。

PauseGame ステータスを「 true 」に設定すると、すべての Unity 3D ゲームアクティビティが一時停止されます (広告のコールバックを除く)。広告を閉じると、ゲームアクティビティが自動的に再開されます。

セッション内のすべての広告 (動画リワードおよびインタースティシャルのマルチ広告ユニット API) に影響するため、LevelPlay SDK を初期化する前または後に SetPauseGame API はアプリセッション内で一度呼ぶ必要があります。

LevelPlay.SetPauseGame(true);

SetPauseGame を「 false 」に設定することで、この機能をそのセッション内で無効にする事ができます。

LevelPlay.SetPauseGame(false);

レガシーの LevelPlay SDK (7.2.4 – 8.4.0) を使用している場合は、以下の API を呼びます：

// Pause all game activities except ad callbacks. The game activity will be resumed automatically when the ad is closed
LevelPlay.SetPauseGame(true);

// Deactivate the functionality in this session
LevelPlay.SetPauseGame(false);

価格の下限設定

Floor Configuration API を使用すると、特定の広告ユニットに最低価格を設定できます。ユーザーごとに最低価格を設定することで、ターゲティングの効率性を向上させ、レイテンシを短縮し、広告パフォーマンスを最適化できます。

最低価格を広告オブジェクトの作成時に割り当てる必要があり、そのオブジェクトの後続のすべてのロードに適用されます。

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

// Define a price floor configuration
var adConfig = new LevelPlayInterstitialAd.Config.Builder()
   .SetBidFloor(1.23) // Set the price floor in USD
   .Build()
// Apply the configuration to an interstitial ad unit
var interstitialAd = new LevelPlayInterstitialAd("adUnitId", adConfig);

インタースティシャルの完全な実装についてはこちら。

動画リワードでの使用例

// Define a price floor configuration
var adConfig = new LevelPlayRewardedAd.Config.Builder()
   .SetBidFloor(1.23) // Set the price floor in USD
   .Build()
// Apply the configuration to a rewarded ad unit
var rewardedAd = new LevelPlayRewardedAd("adUnitId", adConfig);

動画リワードの完全な実装についてはこちら。

バナー広告での使用例

// Define a price floor configuration
var adConfig = new LevelPlayBannerAd.Config.Builder()
   .SetBidFloor(1.23) // Set the price floor in USD
   .Build();
// Apply the configuration to a banner ad unit
var bannerAd = new LevelPlayBannerAd("adUnitId", adConfig);

バナーの完全な実装についてはこちら。

LevelPlay SDK エラーコード

LevelPlay は、SDK 実装失敗の説明を提供するエラーフィードバックメカニズムを提供します。何か問題が発生した場合、またはインテグレーションの一部が正しく完了しなかった場合に、これらのエラーが発生します。

LevelPlay Error オブジェクトには、error code と message が含まれています。以下これらはすべて、考えられるエラーとその機能に基づくメッセージです：