3月 05, 2026

新たなアプリ課金の割引と試用期間の延長

3月 05, 2026

タイトル: 新たなアプリ定期課金の割引と試用期間の延長

1. 技術的課題の定義と現状分析

Shopifyのアプリ開発者として、商人へのインセンティブを提供する有効な方法として、アプリの定期課金に対する割引や試用期間の延長が考えられます。しかし、これまではこれらの機能を独自に実装する必要があり、開発コストや複雑性が増す問題がありました。

2. 具体的な技術的ソリューションの提案

GraphQL Admin APIバージョン2022-04の導入により、これらの問題を解決する新たな方法が提供されています。具体的には、開発者はBilling APIを通じて、定期的なアプリ料金に対する一定期間の割引や試用期間の延長を提供できるようになります。

3. 実装手順とコード例

定期的なアプリ割引の実装:

パートナーは、Billing APIを通じて、割引率や固定割引額を定義し、指定の請求サイクルに適用することができます。例えば、次のGraphQLミューテーションを使用して、6つの請求サイクルにわたって20%の割引を適用することができます。

mutation {
  appSubscriptionCreate(
    name: "Super Duper Plan"
    returnUrl: "http://super-duper.shopifyapps.com"
    test: true
    lineItems: [
      {
        plan: {
          appRecurringPricingDetails: {
            price: { amount: 10.0, currencyCode: USD }
            interval: EVERY_30_DAYS
            discount: {
              percentage: 20
              maxCycles: 6
            }
          }
        }
      }
    ]
  )
  {
    userErrors {
      field
      message
    }
    confirmationUrl
    appSubscription {
      id
    }
  }
}

アプリ試用期間の延長の実装:

新たに導入されたappSubscriptionTrialExtendミューテーションを使用することで、開発者は新規商人に対して試用期間を延長することができます。以下にそのコード例を示します。

mutation {
  appSubscriptionTrialExtend(id: "gid://shopify/AppSubscription/12345678", trialDaysToAdd: 7) {
    userErrors {
      field
      message
    }
    appSubscription {
      id
      trialDays
    }
  }
}