構造体


PurchaseIntent


購入意図を発行するインスタンス。これは、顧客があなたのアプリ外で購入を開始し、アプリが完了することを示します。


iOS 16.4+ iPadOS 16.4+ Mac Catalyst 16.4+ macOS 14.4+

struct PurchaseIntent





以下で言及


あなたのアプリ内で再獲得提供をサポートする


あなたのアプリ内で販売促進されたアプリ内購入をサポートする


App 内購入のプロモーション (Promoting In-App Purchases)



概観


以下の場合には PurchaseIntent の使用が必須となります。


  • App Store でアプリ内購入を販売促進する場合

  • App Store Connect で Streamlined Purchasing 設定をオフにし、再獲得提供特典や条件付き価格設定を使用する場合

  • これらのオファーと設定は App Store Connect で設定できます。詳しくは、アプリ内課金のプロモーション再獲得オファーの設定ストリームライン購入の管理 をご覧ください。


    重要

    販売促進対象のアプリ内購入を有効にするには、あなたのアプリで PurchaseIntent(iOS 16.4 以降)または paymentQueue(_:shouldAddStorePayment:for:)(iOS 11 以降)のいずれかを使用しなければなりません。両方を同時に使用しないでください。必要に応じて、条件付きコンパイルを使用して、アプリが実行中の OS バージョンを識別してください。詳しくは、特定のプラットフォームまたはOSバージョンでコードを実行する (Running code on a specific platform or OS version) をご覧ください。


    顧客が App Store で販売促進対象製品、またはあなたのアプリ外の再獲得提供品を選択すると、あなたのアプリ内で購入手続きが開始され、完了します。あなたのアプリがインストールされていない場合は、ダウンロードを促すメッセージをシステムに表示されます。アプリのダウンロードが完了すると、アプリ内で取引が継続され、intents シーケンスから購入意図を受け取ります。


    購入意図は、顧客が選択した product を識別します。顧客が購入を完了できるようにするには、この製品インスタンスに対して purchase(options:) を呼び出します。以下のサンプルコードは、購入意図を受け取り、購入ワークフローを完了するためのメソッドを呼び出します。


    func purchaseProduct(_ product: Product) async {
        // Complete the purchase workflow.
        do {
            try await product.purchase()
        }
        catch {
            // Add your error handling here.
        }
        // Add your remaining purchase workflow here.
    }
    
    for await purchaseIntent in PurchaseIntent.intents {
        // Complete the purchase workflow.
        await purchaseProduct(purchaseIntent.product)
    }
    

    詳細については、あなたのアプリ内で販売促進されたアプリ内購入をサポートする および あなたのアプリ内で再獲得提供をサポートする をご覧ください。


    Mac Catalyst で構築された Mac アプリでは、Mac App Store がこの機能をサポートしていないため、このインスタンスは販売促進されたアプリ内購入の購入意図を出力しません。


    注意

    PurchaseIntent および販売促進されたアプリ内購入は、visionOS で実行されている、互換性のある iPad または iPhone アプリでは利用できません。





    トピックス


    製品を識別する


    var id: Product.ID

    顧客がアプリ外で購入することを選択したアプリ内購入の製品 ID。


    let product: Product

    顧客がアプリ外で購入する事を選択したアプリ内購入の製品情報。



    購入意図の取得


    static var intents: PurchaseIntent.PurchaseIntents

    顧客がアプリ外で購入を開始したときに購入意図を発行する非同期シーケンス。


    struct PurchaseIntents

    顧客がアプリ外で開始する購入に対する購入意図の非同期シーケンス。



    オファーの特定


    let offer: Product.SubscriptionOffer?

    顧客があなたのアプリ外で利用するサブスクリプションのオファー。





    関連


    以下に準拠


    Copyable

    Equatable

    Identifiable

    Sendable

    SendableMetatype





    以下も見よ


    販売促進されたアプリ内購入


    あなたのアプリ内で販売促進されたアプリ内購入をサポートする

    販売促進対象のアプリ内購入をあなたの製品ページに表示し、ユーザーが App Store で開始した購入を処理します。


    struct PromotionInfo

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


    販売促進対象のアプリ内購入をテストする

    あなたのアプリを App Store で利用可能にする前に、アプリ内購入をテストしましょう。














    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ












    トップへ