创建 iOS 订阅介绍性优惠

GitHub

复制一个包含安装步骤和完整 Markdown 指南的配置提示.

推广活动允许您向符合条件的用户提供免费试用或折扣推广价格，以减少进入障碍并增加订阅转换。

概述

推广活动是增长订阅者基础的最有效工具之一。它们允许用户：

无风险试用您的高级功能
在承诺之前体验价值
以较低的价格点开始
建立对产品的信心

推广类型

iOS 支持三种类型的推广活动：

1. 免费试用

客户在试用期内获得免费访问权限，试用期结束后，如果他们没有取消，会按标准费率收费。

例如：

7 天免费
14 天免费
1 个月免费

适合：

高价值订阅
功能丰富的应用
建立用户习惯

2. 预付费

客户只需支付一次折扣价格，涵盖引导期。

示例：

$1.99/2个月（然后$9.99/月）
$9.99/3个月（然后$19.99/月）

适合：

承诺信号
现金流需求
测试价格敏感性

Section titled “3. 按需付费”

Section titled “2. 预付费” translates to “2. 预付费” because the title is not translated in the source text, so the translation is the same as the source text. However, the description and examples are translated to Simplified Chinese. The same applies to the other sections.

示例：

$1.99/月（3个月后为$9.99/月）
$4.99/月（6个月后为$14.99/月）

适合：

渐进式承诺
长期价值展示
降低风险感

资格要求

用户只有在以下情况下才能接受引导性优惠：

没有之前接受过该产品的引导性优惠
没有在同一订阅组中接受过任何产品的引导性优惠
没有激活的产品订阅

前提条件

您必须先创建一个自动续订订阅然后才能添加一个介绍性优惠券

创建介绍性优惠券

前往订阅

在 App Store Connect 中，前往您的应用的 Monetize > 订阅 部分并选择要添加优惠的订阅。
添加订阅价格

点击 + 图标旁边的“订阅价格”以打开价格模态窗口。
创建引导价

选择 “创建引导价” 从选项中。
配置国家和开始日期

地区和地区: 选择该优惠将可用的地区
- 选择所有国家以实现最大覆盖
- 或限制到特定市场进行测试
开始日期: 优惠可用的时间
- 可以立即或预定为未来
- 有助于与营销活动协调
结束日期（可选）: 优惠过期的时间
- 留空为持续可用
- 设置有限期限的促销活动
选择优惠类型

选择以下三种优惠类型：

免费 (免费试用)
- 选择持续时间（天，周，月）
- 例如：7天，2周，1个月
一次性付款
- 设置单次付款价格
- 设置付款覆盖的持续时间
- 例如：$1.99覆盖2个月
按需付款
- 设置每个周期的折扣价格
- 设置周期数
- 示例：$2.99/月3个月
确认并查看

查看显示的摘要：
- 优惠类型和时长
- 价格细节
- 介绍期后正常价格
- 可用日期和国家
保存

点击保存创建介绍性优惠券后立即在沙盒模式下可供测试。

配置示例

示例 1：标准免费试用

Type: Free
Duration: 7 days
Then: $9.99/month

用户旅程：

第 1-7 天：免费访问
第 8 天：首次收费 $9.99
月度收费继续

示例 2：预付折扣期

Type: Pay Up Front
Price: $4.99
Duration: 3 months
Then: $9.99/month

用户旅程：

第1天：$4.99
90天访问
第91天：每月$9.99

示例3：渐进式介绍

Type: Pay As You Go
Price: $2.99/month
Periods: 6 months
Then: $9.99/month

用户旅程：

第1-6个月：$2.99/月
第7个月及以后：$9.99/月

在您的应用中使用

native-purchases 插件自动处理引导性优惠的呈现和资格：

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';

// Fetch products with intro offer information
const { products } = await NativePurchases.getProducts({
  productIdentifiers: ['com.yourapp.premium_monthly'],
  productType: PURCHASE_TYPE.SUBS,
});

const product = products[0];

// Display intro offer details (StoreKit sends localized metadata)
if (product.introductoryPrice) {
  console.log('Intro price:', product.introductoryPriceString);
  console.log('Intro period:', product.introductoryPricePeriod);
  console.log('Intro cycles:', product.introductoryPriceCycles);
  console.log('Regular price:', product.priceString);
} else {
  console.log('No intro offer configured');
}

// Purchase (StoreKit automatically applies intro pricing if eligible)
try {
  const transaction = await NativePurchases.purchaseProduct({
    productIdentifier: 'com.yourapp.premium_monthly',
    productType: PURCHASE_TYPE.SUBS,
  });

  console.log('Subscription active, receipt length:', transaction.receipt?.length);
  await validateReceiptOnServer(transaction.receipt);
} catch (error) {
  console.error('Purchase failed:', error);
}

向用户展示引导性优惠

UI 最佳实践

清晰的价值提议：

Try Premium Free for 7 Days
Then $9.99/month. Cancel anytime.

强调节省：

Start at Just $1.99
Get 3 months of Premium for only $1.99
Then $9.99/month

透明的沟通：

Your Free Trial
• Access all premium features
• No charge for 7 days
• $9.99/month after trial
• Cancel anytime, even during trial

示例实现

function formatIntroOffer(product: any): string {
  if (!product.introductoryPrice) {
    return `${product.priceString} per ${product.subscriptionPeriod}`;
  }

  const intro = product.introductoryPrice;
  const regular = product.priceString;

  if (intro.price === 0) {
    // Free trial
    return `Try free for ${intro.periodString}, then ${regular}`;
  } else if (intro.cycles === 1) {
    // Pay up front
    return `${intro.priceString} for ${intro.periodString}, then ${regular}`;
  } else {
    // Enterprise
    return `${intro.priceString} for ${intro.cycles} ${intro.periodString}s, then ${regular}`;
  }
}

营销最佳实践

试用长度策略

3-7天:快速决策应用程序、游戏
7-14天:大多数应用程序的标准
14-30天: 高级工具，专业应用
30+ 天: 高值B2B或企业

定价心理学

$0.99-$1.99: 极低的障碍，适合测试
50% 折扣: 强烈的认知价值
首月免费: 常见，熟悉的模式

沟通时机

测试结束前即将收费的提醒
突出价值显示使用统计和成就
取消服务方便透明的取消流程

测试介绍优惠

使用沙盒测试验证行为：

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';

// In sandbox mode, accelerated subscription durations apply:
// - 3 days free trial = 3 minutes
// - 1 week free trial = 3 minutes
// - 1 month free trial = 5 minutes

const { products } = await NativePurchases.getProducts({
  productIdentifiers: ['premium_monthly'],
  productType: PURCHASE_TYPE.SUBS,
});

// Purchase with intro offer
const transaction = await NativePurchases.purchaseProduct({
  productIdentifier: 'premium_monthly',
  productType: PURCHASE_TYPE.SUBS,
});

console.log('Intro purchase transaction:', transaction.transactionId);

// Wait for accelerated renewal
setTimeout(async () => {
  const { purchases } = await NativePurchases.getPurchases({
    productType: PURCHASE_TYPE.SUBS,
  });
  const premium = purchases.find((purchase) => purchase.productIdentifier === 'premium_monthly');
  console.log('After trial state:', premium?.subscriptionState);
}, 180000); // 3 minutes for weekly trial

重要说明

资格规则

每个用户每个订阅组只有一次优惠
仅适用于新订阅者
在取消后不能再使用
不适用于订阅升级/交叉升级

StoreKit API

introductoryPrice 显示引导优惠细节
eligibility 方法检查用户是否符合资格
在购买时自动应用
无需特殊购买方法

限制

一次订阅中只能激活一个优惠
不能与其他折扣类型合并
不能更改资格规则
苹果控制资格检查

故障排除

优惠券未显示：

检查App Store Connect中是否激活了优惠
验证用户之前未使用过优惠
确保用户未订阅该组中的任何内容
测试使用新沙盒账户

资格检查失败：

等待 App Store 同步（可能需要 2-3 小时）
验证产品 ID 是否正确
检查订阅组配置
在沙盒中测试使用新测试账户

显示错误价格：

检查区域定价设置
验证货币转换
确保优惠活动日期为当前
刷新产品信息

沙盒测试问题：

使用加速时长（3 分钟 = 1 周）
为每个测试创建新测试帐户
等待试用自然完成
检查续订次数（sandbox 最多 6 次）

分析和优化

跟踪这些指标

首次收费后保留率
试用转为付费转换率
试用期间取消
首次优惠接受率
Revenue impact

A/B Testing Ideas

Free trial vs. paid intro
Trial length variations
Discount percentage
Single payment vs. recurring discount

Optimization Strategy

// Track offer performance
analytics.track('intro_offer_displayed', {
  product_id: product.identifier,
  offer_type: product.introductoryPriceType,
  offer_duration: product.introductoryPricePeriod
});

analytics.track('intro_offer_accepted', {
  product_id: product.identifier
});

// Monitor conversion
NativePurchases.addListener('transactionUpdated', (transaction) => {
  if (transaction.productIdentifier === product.identifier && transaction.isActive) {
    analytics.track('trial_converted', {
      transactionId: transaction.transactionId,
      productId: transaction.productIdentifier,
    });
  }
});

Next Steps

配置沙盒测试测试您的介绍性优惠
设置促销优惠以激活回归活动
实施订阅分析
创建针对性的营销活动

额外资源

欲了解更多详细信息，请参阅苹果官方文档关于介绍性优惠.

继续从创建iOS订阅介绍性优惠

如果您正在使用 创建iOS订阅引导优惠 连接它来使用 @capgo/native-purchases 使用 @capgo/native-purchases 的原生能力 Capgo 价格使用 Capgo 价格的产品工作流程支付系统支付系统的实现细节 @capgo/native-purchases 的实现细节 for the implementation detail in @capgo/native-purchases, and 开始使用的实现细节. @__CAPGO_KEEP_0__/native-purchases