プロパティリストキー

SKIncludeConsumableInAppPurchaseHistory

StoreKit が取引情報に、終了した消耗品アプリ内購入を含めるかどうかを決定するブール値。

iOS 18.0+ iPadOS 18.0+ Mac Catalyst 18.0+ macOS 15.0+

tvOS 18.0+ VisionOS 2.0+ WatchOS 11.0+

詳細

Type

ブール値

議論

デフォルトでは、この値は false です。false の場合、StoreKit は以下の API からの取引情報で、終了した消耗品 (返金または取り消しが行われた場合を除く) を返しません。

Transaction の all シーケンス。あなたのアプリの顧客の取引履歴を返します

Transaction の latest(for:)。特定の製品に関する顧客の最新の取引を返します

製品の最新の取引を提供する Product の latestTransaction。

この値を true に設定すると、all、latest(for:)、および latestTransaction API を使用するときに、StoreKit はすべてのアプリ内購入取引 (すべての完了した消耗品を含む) を取引情報に含めます。

警告

SKIncludeConsumableInAppPurchaseHistory を true に設定する前に、デバイス上だけでなくサーバ上でも顧客の消耗品取引を調整する方法があることを確認してください。たとえば、顧客がアプリを再インストールした場合に意図せずコンテンツを複数回配信しないように、取引の一意の取引識別子 id をその完了状態とともに保存します。未完了の取引を取得して処理するには、unfinished を使用して下さい。