ルーティングルールの追加
プロバイダー ルーティング ルールを定義して、プレイヤーに提供する支払いプロバイダーとその順序をコントロールします。
読み終わるまでの所要時間 2 分最終更新 8日前
支払いプロバイダーをアクティベートするには、プロバイダーのルーティング ルールを定義する必要があります。ルーティングルールにより、各プレイヤーに提供する支払いプロバイダーをコントロールできます。プラットフォームまたは国ごとにプレイヤーをターゲットとし、プロバイダーの表示順を定義できます。ロールアウトパーセンテージを使用して、完全なロールアウトの前に新しいプロバイダーをプレイヤーのサブセットに徐々に導入することもできます。
注
ルーティング ルールはランタイムに評価されるため、クライアントの更新や新しいアプリケーション リリースの要件なしでプロバイダー ルーティングを変更できます。
重要
ルーティングルールを保存すると、そのルールは即座にアクティブになり、設定された支払いプロバイダーがアクティブになります。準備が整うまでルールを追加しないでください。
- Open In App Purchases (アプリケーション購入)> Payment Providers (支払いプロバイダー)。
- プロバイダー ルーティングで、Add routing rule を選択します。
- ルールの名前を入力します。
- ルールがプレイヤーに適用される順序を定義するルールの優先度番号を選択します。詳細については、ルールの優先順位 を参照してください。
- 以下の設定オプションを入力します。 | 設定オプション | 説明 | | プラットフォーム属性 | このルールを適用する各プラットフォームを選択します。 | | Country attributes | このルールを適用する国を選択します。 | | Webshop に適用 | ルールを Webshop に適用するには、このオプションを選択します。 | | プロバイダー順 | 複数の支払いプロバイダーが接続している場合は、プライマリプロバイダーにする支払いプロバイダーをリストの一番上にドラッグします。支払いプロバイダーでDisabledを選択し、このルールに一致するプレイヤーにそのプロバイダーを提供しないようにします。 | | Rollout | このルールに一致するプレイヤーのうち、ルールを適用するプレイヤーの割合を定義します。詳細については、ロールアウト機能を参照してください。 |
- Save (保存) を選択して、ルールをアクティブにします。
ルールの優先順位
各ルールに優先順位番号を割り当てます。番号が小さいほど優先順位が高くなります。複数のルールがプレイヤーに一致する場合は、そのすべてのルールが適用されます。プレイヤーは、一致するすべてのルールのすべてのプロバイダーに対して適格です。コードでプロバイダーを明示的に指定しない場合、Priority (優先度) によって Unity Iap がデフォルトで選択するプロバイダーが決まります。優先順位が最も高いマッチングルールが優先されます。明確な優先順位の使用
各ルールに個別の優先順位を割り当てることをお勧めします。優先順位を完全にコントロールできるため、同順位の動作に依存する必要がなく、優先順位を明確にすることでルーティングを予測できます。ロールアウト機能
ロールアウト設定を使用して、ルールの条件に一致するプレイヤーのうち、ルールが実際に適用されるプレイヤーの割合をコントロールします。割り当てはプレイヤーごとに決定論的です。つまり、同じプレイヤーがセッション全体で一貫して含まれる/除外されます。 ロールアウトパーセンテージの範囲外のプレイヤーは、ルールが一致しないものとして扱われます。その後、IAP は残りのルールを優先順位で評価して適用し、適用がない場合はデフォルトのフォールバック動作を適用します。注
ローンチ後にロールアウトパーセンテージを変更すると、その変更は、次にターゲットが再計算されたときにプレイヤーごとに効果になります。これは通常、アプリケーションの再起動起動時、またはゲームに特に設定したタイミングで発生します。
プレイヤーに一致するルールがない場合のフォールバック
支払いプロバイダーは、独立したストアです。プレイヤーに一致するルールがないか、ルールに一致するが、設定されている支払いプロバイダーがいずれも利用できない場合、プレイヤーは外部支払いによる購入を完了できません。 プレイヤーが代わりにネイティブ (Apple App Store または Google Play ストア) での購入を完了できるかどうかは、プレイヤー次第であり、プレイヤーの地域の外部購入プログラムの規約に従います。 Webshop での購入の場合、プレイヤーに一致するルールがない場合、Unity Iap はデフォルトで正常な失敗となり、購入がブロックされます。特定のフォールバック プロバイダーを設定する方法については、「フォールバック支払いプロバイダーの設定」を参照してください。コードでのオーバーライドルーティング
デフォルトでは、ルーティングの決定はダッシュボードボードで設定したルールに基づいてサーバー側で行われます。ルーティングを機能させるためにクライアント側を変更する必要はありません。 さらにコントロールが必要な場合は、Unity Iap に 2 つの任意 API が用意されています。- : 現在のプレイヤーが使用できる支払いプロバイダーのリストを、優先順位 (高い順) で返します。リストが空の場合は、適格なプロバイダーがなく、外部支払いが使用できないことを意味します。
IPaymentProvidersExtendedService.GetEligiblePaymentProviders() - : サーバー側のルーティングの決定をオーバーライドし、後続の購入に対して特定の支払いプロバイダーを強制します。オーバーライドでは、プレイヤーが使用可能なプロバイダーが引き続き尊重されます。
IPaymentProvidersExtendedPurchaseService.SetPaymentProviderOverride(string)