構造体

Product.PromotionInfo

デバイス上での順序と表示をカスタマイズする、販売促進対象のアプリ内購入に関する情報。

iOS 16.4+ iPadOS 16.4+

struct PromotionInfo

以下で言及

あなたのアプリ内で販売促進アプリ内購入をサポートする
(Supporting promoted In-App Purchases in your app)

概観

Product.PromotionInfo 構造体は、あなたのアプリで利用できる販売促進対象のアプリ内購入を表します。販売促進対象のアプリ内購入は、デフォルトの表示順序や表示設定などを含め、App Store Connect を使用して設定します。この API を使用して、順序や表示をオーバーライドしてカスタマイズします。オーバーライドはデバイスごとに行われます。オーバーライドは、ユーザがアプリを少なくとも 1 回起動した後に有効になります。

この構造体はインスタンス化しないでください。Product.PromotionInfo オブジェクトのリストを取得するには、あなたの販売促進対象のアプリ内購入を表す製品 ID のリストを使用して静的メソッド updateProductOrder(byID:) を呼び出します。次に、currentOrder を呼び出して Product.PromotionInfo オブジェクトのリストを取得します。順序を変更するには、販売促進対象のアプリ内購入を希望の順序でリストして updateAll(_:) を呼び出します。製品 ID を使用して順序を変更するには、updateProductOrder(byID:) を呼び出します。

販売促進されたアプリ内購入がデバイス上の App Store に表示されないようにするには、以下の 2 つのオプションがあります。

visibility の値を Product.PromotionInfo.Visibility.hidden に設定して update() を呼び出すか、updateProductVisibility(_:for:) を呼び出して製品を非表示にします。

updateAll(_:) または updateProductOrder(byID:) をあなたが呼び出すときに製品を除外してリストから削除します。

オーバーライドをキャンセルしてデフォルトの順序と表示に戻すには、空の配列で updateAll(_:) または updateProductOrder(byID:) を呼び出します。

アプリ内購入の販売促進の詳細については、あなたのアプリ内で販売促進アプリ内購入をサポートする (Supporting promoted In-App Purchases in your app) をご覧ください。