Adobe AIR の詳細設定
GDPRおよびCCPAへの準拠、ユーザーセグメント化、カスタムユーザーIDなど、Adobe AIRの高度な設定を行います。
読み終わるまでの所要時間 19 分最終更新 8日前
GDPR - 同意の管理
Unity LevelPlay とネットワーク サポート パブリッシャーは、ユーザーの同意に基づいて通信を行います。これには、メディエーション ネットワーク(サポート対象ネットワークの場合)にこの情報を渡すことも含まれます。
LevelPlay の API を使用してユーザーの同意状態を更新するには、次の機能を使用します。
ユーザーが同意した場合は、以下のフラグを true に設定します。
IronSource.instance.setConsent(true);
ユーザーが同意しない場合は、以下のフラグを false に設定します。
IronSource.instance.setConsent(false);
SDK 初期化期化の前に API を設定することをお勧めします。
CCPA への準拠
Unity LevelPlay プラットプラットフォーム (SDK バージョン 6.14.0 以降) では、パブリッシャーがカリフォルニア州コンシューマー者プライバシー法 (CCPA) に基づいてエンドユーザーの個人情報の販売を制限できます。
カリフォルニア州にある特定のユーザーの個人情報に関する通知は、「do not sell(販売しない)」設定に基づいて、その値を「true」または「false」に設定して処理する必要があります。
SDK を初期化する前に API を設定する必要があります。
ユーザーが個人情報の「販売」をオプトアウトした場合:
IronSource.instance.setMetaData("do_not_sell","true");
個人情報の「販売」が許可されている場合
IronSource.instance.setMetaData("do_not_sell","false");
UserID の設定
サーバー間のコールバックを使用して、リワード広告ユニットをユーザーに付与する場合は、UserID を設定する必要があります。
userID は、各ユーザーの一意の識別子です。userIDパラメーターを設定するか、省略して生成します。コードでの userID の設定のスキップを選択した場合、SDK は公平な userID を生成します。
1 ~ 64 文字の文字列(Android)または NSString(iOS)をサポートします。GAID(Google Advertising ID)またはIDFA(Apple Advertising ID)を使用するのが一般的です。
IronSource.instance.setUserId(YOUR_USER_ID);
セグメントの定義
特定のオーディエンスに合わせて広告の配信方法をカスタマイズできるようになりました。ユーザーの詳細をサーバーに通知して、ユーザーが属するセグメントに応じてSDKが広告を配信するようにする必要があります。
LevelPlay は、ユーザーセグメントのアウトラインを作成するためにサーバーにデータを送信する 3 つの方法をサポートしています。
- デバイスプロパティ: LevelPlay SDK は、デバイスモデル、デバイス製造元、アプリケーションバージョン、OS など、ユーザーのデバイスに関連する特定の標準パラメータを自動的に収集します。このデータを当社に送信する必要はありません
- ユーザープロパティ: SDKによって収集されないユーザーデータ(例えば、年齢、性別、作成日)は、APIを通じてリレーする必要があります。(サポートされているセグメント プロパティの全リストと以下のセクションの説明を参照してください)。指示に従ってこれらの詳細を送信し、LevelPlay プラットフォームで定義したセグメントに関連する広告設定を SDK が適用できるようにします。
- カスタムセグメント: ユーザーの詳細をサーバに送信せずにカスタムセグメントを作成し、そのユーザーセグメントの広告設定を調整できます。
Pass ユーザープロパティ
LevelPlay プラットフォームでセグメントを定義したら、サーバーにユーザーの詳細情報を通知する必要があります。
まず、ironsource セグメントクラスをインポートしてユーザをセグメント化する必要があります。
import com.ironsource.adobeair.IronSourceSegment;
セグメントのベースとなるサーバーに送信するプロパティを定義します。この情報は以下のいずれかの方法で送信できます。
-
ユーザーが属するセグメントに精通している場合は、セグメント名を入力します。IronSourceSegment segment = new IronSourceSegment (); segment.segmentName = "nameOfSegment";
-
ユーザーの詳細を送信してください。Ironsource は、API でユーザーをセグメントにアトリビュートするように設定できる、範囲な標準ユーザープロパティを提供します。サポートユーザーセグメントのプロパティの表を下にスクロールします。// Create segment objectvar segment:IronSourceSegment = new IronSourceSegment();// Set user agesegment.age = age;// Set user gendersegment.gender = "gender";// Set user's levelsegment.level = levelnumber;// Set user creation datesegment.userCreationDate=creationData// Set user's total in-app purchasessegment.iapt = numberOfInAppPurchases;// Set user's paying status, 1 is yes 0 is nosegment.isPaying = payingStatus;さらに、セグメントごとに最大5つのカスタムユーザープロパティを設定できます。// Set custom parameters (up to 5)segment.setCustom("customKey1", "value1");segment.setCustom("customKey2", "value2");
次に、セグメントに基づいて広告ユニットを配信するには、セグメント名またはユーザープロパティーのいずれかを指定して以下の機能を呼び出します。
IronSource.instance.setSegment(segment);
サポートされるユーザーセグメントプロパティ
セグメントプロパティ | Type (タイプ) | 制限 | 説明 |
|---|---|---|---|
| segmentName | String | - 英数字 - 最大 32 文字 | ironsource アカウントのセグメントの名前 |
| 年齢 | Int | 1-99 | ユーザーの年齢 |
| 性別 | String | 女性または男性 | ユーザーの性別 |
| 支払い | Boolean | true または false | - ユーザーがアプリケーション内課金にお金を使ったことがない場合は true - ユーザーがアプリケーション内課金にお金を使ったことがない場合は false |
| iap_total | ダブル | 1-999999.99 | ユーザーがアプリケーション内課金に費やした金額の合計 |
| userCreationDate | ロング | 0 より小さい値にすることはできません | ユーザーがアプリケーションをインストールした日付 (例えば、NSDate date) |
| カスタムパラメーター | key=string, value=string | - LevelPlay は、最大 5 つのカスタムパラメーター (英数字 - 最大 32 文字) をサポートします。 | サーバにディスパッチする追加データ |
ユーザーが属するセグメント名を受け取るには、以下のコールバックに登録します。コールバック文字列 (セグメント名) が空を返す場合、ironsource セグメントモジュールにユーザーに関連するセグメントが見つかりませんでした。
IronSource.instance.addEventListener(“onSegmentReceived”, onSegmentReceived);
サンプル実装:
function onSegmentReceived(event:DataEvent):void { trace (“onSegmentReceived: ” + event.data); }
Adobe AIR のカスタムパラメーター
LevelPlay SDK では、動画リワード広告単位の初期化期化時にカスタムパラメーターを渡す機能がサポートされます。その後、ユーザーの完了イベントでこのデータを受け取ります。
実装コード
動画リワード
IronSource.instance.setRewardedVideoServerParameters(YOUR_CUSTOM_PARAMETERS);
さらに、この機能を呼び出すことで、リワード動画のカスタムパラメーターを削除できます。
IronSource.instance.clearRewardedVideoServerParameters();
ウォーターフォール設定を使用した価格制限 (ベータ)
ウォーターフォール設定 は、ウォーターフォールの制限を動的に設定するために使用できる API です。上限価格と下限価格を設定できます。これを使用して制限を設定し、ユーザーごとに返される WF に動的に影響し、ロード時間と待ち時間を削減できます。
制限には以下が含まれ、これらのパラメーターを任意に組み合わせることができます。
プロパティ | Type (タイプ) | 説明 |
|---|---|---|
| 天井 | double | 従来のインスタンスに適用される最大 eCPM を定義する米ドルの価格 |
| 床 | double | 従来のインスタンスと入札者に適用される最小 eCPM を定義する米ドルの価格 |
ウォーターフォール設定の作成
WaterfallConfiguration クラスは、ウォーターフォールをカスタマイズまたはフィルタリングするための設定オブジェクトを表します。ウォーターフォール設定を作成するには、以下の実装します。
var builder:WaterfallConfigurationBuilder = new WaterfallConfigurationBuilder(); builder.SetCeiling(ceiling); builder.SetFloor(floor);var configuration:WaterfallConfiguration = builder.Build(); IronSource.instance.setWaterfallConfiguration(configuration,ISAdFormat.AdUnitName);
ウォーターフォール設定の消去
ウォーターフォール設定はセッション中に変更できます。特定の広告単位の設定を消去するには、 WaterfallConfiguration 機能を使用します。
emptyvar builder:WaterfallConfigurationBuilder = new WaterfallConfigurationBuilder();var configuration:WaterfallConfiguration = builder.Build();IronSource.instance.setWaterfallConfiguration(configuration.Empty(),ISAdFormat.AdUnitName);
LevelPlay SDK のエラーコード
ironsource は、SDK インテグレーションで障害が発生した場合に説明を提供するエラーフィードバックメカニズムを提供します。これらのエラーは、問題が発生したときやインテグレーションのアスペクトが正しく完了しなかったときに発生します。
ironsource 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:広告単位がセッションあたりの日予算の上限に達しました
Show Fail:広告単位がセッションあたりの日予算の上限に達しました |
| 1022 | 動画リワード | Show Fail:別の RV が表示されている間は RV を表示できない |
| 1023 | 動画リワード | Show Fail:Show RV called when there are no available ads to show | (表示できる広告がない場合に呼び出される RV の表示)
| 1036 | インタースティシャル | Show Fail:別のインタースティシャルが表示されている間はインタースティシャルを表示できません |
| 1037 | インタースティシャル | ロード失敗:別のインタースティシャルの表示中にインタースティシャルをロードできません |