iOS アドバンスト設定

ユーザー ID の設定

サーバー間コールバックを使用してリワード広告ユニットでユーザーにリワードを提供している場合、または Ad Quality ユーザージャーニーを使用する場合は、setUserID メソッドを使用して各ユーザーにユニークな識別子（ UserID ）を定義する必要があります。

userID 設定はユーザーデータのロスを防ぐため、init リクエストの前に行う必要があります。userID には、NSString で 1 〜 64 文字のユニークな英数字を使用してください。

[IronSource setUserId:YOUR_USERID];

IronSource.setUserId(userID)

セグメントの定義

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

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

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

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

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

まず、セグメントを初期化します：

ISSegment *segment = [[ISSegment alloc]init];

let segment: ISSegment = ISSegment()

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

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

   [segment setSegmentName:YOUR_SEGMENT_NAME];

   segment.segmentName = "YOUR_SEGMENT_NAME"

2. ユーザーの詳細を送信します。ironSource は、セグメントにユーザーを関連付けるために設定できる一連の標準ユーザープロパティを API で提供します。説明については、以下の表を参照してください。

   // Set user age
   [segment setAge:USER_AGE]; 
   // Set user gender
   [segment setGender:USER_GENDER];
   // Set user level
   [segment setLevel:USER_LEVEL];
   // Set user's paying status
   [segment setPaying:USER_PAYING];
   // Set user's total in-app purchase history
   [segment setIapTotal:YOUR_IAP_TOTAL];
   // Set user creation date
   [segment setUserCreationDate:YOUR_DATE];

   // Set user age
   segment.age = USER_AGE
   // Set user gender
   segment.gender = ISGender.IRONSOURCE_USER_FEMALE
   // Set user's total in-app purchases
   segment.iapTotal = USER_IAP_TOTAL
   // Set user's level
   segment.level = USER_LEVEL
   // Set user's paying status
   segment.paying = USER_PAYING_STATUS
   // Set user creation date
   segment.userCreationDate = NSDate() as Date!

   さらに、セグメントごとに最大五つのカスタムユーザープロパティを設定できます：

   [segment setCustomValue:YOUR_CUSTOM_VALUE forKey:YOUR_CUSTOM_KEY];

   segment.setCustomValue("CUSTOM_VALUE", forKey: "CUSTOM_KEY")

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

   [IronSource setSegment:YOUR_SEGMENT];

   IronSource.setSegment(YOUR_SEGMENT);

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

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

1. クラスでこのインターフェースを採用して、セグメント名プロトコルに準拠し、セグメント名の受信を有効にします：ISSegmentDelegate
2. ユーザーが属するセグメント名を受け取るため、次のデリゲートに登録します。それにより、SDK はデリゲートにイベントを通知します

   [IronSource setSegmentDelegate:self];

   IronSource.setSegmentDelegate(self)

3. (void)didReceiveSegement:(NSString *)segment

   func didReceiveSegement(_ segment: String!)

iOS のカスタムパラメーター

ironSource SDK は、動画リワードのカスタムパラメーターをサポートします。広告ユニットの初期化時にカスタムパラメータを渡し、ユーザーの完了イベント時にパラメータを受け取ることができます。

これで、Unity LevelPlay のすべてのメディエーションネットワークにカスタムパラメータを渡すことができます。

実装コード

動画リワード

• カスタムパラメータは、セッションごとに複数回設定できます。
• 値をリセットするには、clearRewardedVideoServerParameters を使用してから、新しい値を設定します。

[IronSource setRewardedVideoServerParameters:(NSDictionary *)parameters];
[IronSource clearRewardedVideoServerParameters];

価格の下限設定

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

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

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

// Define a price floor configuration
LPMInterstitialAdConfig *adConfig = [[[LPMInterstitialAdConfigBuilder new] setBidFloor: 1.23] build]; // Set the price floor in USD
// Apply the configuration to an interstitial ad unit
LPMInterstitialAd *interstitialAd = [[LPMInterstitialAd alloc] initWithAdUnitId:@"adUnitId" config:adConfig];

// Define a price floor configuration
let adConfig = LPMInterstitialAdConfigBuilder()
 .set(bidFloor: 1.23) // Set the price floor in USD
 .build()
// Apply the configuration to an interstitial ad unit
let interstitialAd = LPMInterstitialAd(adUnitId: "adUnitId", config: adConfig)

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

動画リワードでの使用例

// Define a price floor configuration
LPMRewardedAdConfig *adConfig = [[[LPMRewardedAdConfigBuilder new] setBidFloor: 1.23] build]; // Set the price floor in USD
// Apply the configuration to a rewarded ad unit
LPMRewardedAd *rewardedAd = [[LPMRewardedAd alloc] initWithAdUnitId:@"adUnitId" config:adConfig];

// Define a price floor configuration
val adConfig = LevelPlayRewardedAd.Config.Builder()
 .setBidFloor(1.23) // Set the price floor in USD
 .build()
// Apply the configuration to a rewarded ad unit
val rewardedAd = LevelPlayRewardedAd("adUnitId", adConfig)

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

バナー広告での使用例

// Define a price floor configuration
LPMBannerAdViewConfig *adConfig = [[[LPMBannerAdViewConfigBuilder new] setBidFloor: 1.23] build]; // Set the price floor in USD
// Apply the configuration to a banner ad unit
LPMBannerAdView *bannerAd = [[LPMBannerAdView alloc] initWithAdUnitId:@"adUnitId" config:adConfig];

// Define a price floor configuration
let adConfig = LPMBannerAdViewConfigBuilder()
 .set(bidFloor: 1.23) // Set the price floor in USD
 .build()
// Apply the configuration to a banner ad unit
let bannerAd = LPMBannerAdView(adUnitId: "adUnitId", adConfig)

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

ironSource SDK エラーコード

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

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