实现 App Store Offers

实现 App Store Offers

了解如何使用 App Store Connect 通过 App Store Offers 来吸引顾客，以及如何同时运用最新的 StoreKit 功能和 API。探索如何为 Mac App 设置赢回优惠 (重新吸引过往订阅者的全新方式)，并生成优惠代码。此外，了解如何在沙盒和 Xcode 中测试优惠，以确保优惠能够顺畅运作。

章节
- 0:00 - Introduction
- 1:32 - Updates to offers
- 4:37 - Introducing win-back offers
- 7:10 - Configure win-back offers
- 16:50 - Support win-back offers
- 28:44 - Streamlined purchasing
资源
相关视频

WWDC24
WWDC23
- 认识 StoreKit 与 SwiftUI
- StoreKit 2 的新增功能和 Xcode 中的 StoreKit 测试
下载

大家好欢迎观看 “实现 App Store Offers” 我是 App Store Connect 的工程师 Xiaolan 大家好我是 StoreKit 团队的工程师 Ricky 今天我们很高兴与大家分享 App Store 优惠的所有重大更新以及如何利用这些功能吸引顾客首先让我们快速回顾一下 App Store 优惠对于以订阅为基础的业务来说留住顾客是取得长期成功的关键 App Store 优惠是获取、保留以及重新吸引顾客的好方法通过 App Store 优惠可在特定时限内为符合条件的顾客提供免费订阅或折扣订阅
App Store 中有三种优惠：推介促销优惠、促销优惠和优惠代码
设置推介促销优惠可以让新订阅者有机会免费试用订阅或以折扣价体验订阅
促销优惠则更加灵活你可以创建独特的折扣促销活动并根据自己的业务需求确定相应的资格条件对于优惠代码你可以使用 App Store 为你生成的一次性唯一代码也可以创建自己的自定代码通过自己的营销渠道分发我们对订阅优惠 StoreKit API 推出了许多增强功能包括 Transaction 和 RenewalInfo 新增 offer 成员以及 macOS 新增对优惠代码的支持借助 StoreKit 中的一些关键 API 你可以轻而易举地为 App 订阅优惠提供支持而我们要分享的一些增强功能可以让这些 API 功能更强大
首先我们增强了 StoreKit 和 App Store Server API 中的 Transaction API 和 RenewalInfo API Transaction 结构对于了解顾客在 App 中的购买行为非常重要 RenewalInfo 结构可指示订阅状态的未来情况
在 Transaction 中新成员“offer”是一种新类型包含所有与优惠相关的信息如优惠的 ID、类型和 paymentMode paymentMode 可指明优惠属于免费试用、随用随付还是提前支付
offer 成员是可选的这意味着仅当购买订阅的顾客兑换了优惠时 StoreKit 才会将 offer 成员包含在交易中
从 iOS 17.2 开始 StoreKit 中提供了这个新的 API 从 iOS 18.0 开始 RenewalInfo API 中也将提供 offer 成员如果订阅的下一个续订期应用了优惠 StoreKit 就会填充 offer 成员
如果是使用 App Store Server API JWSTransaction 和 JWSRenewalInfo API 中的三个字段也提供相同的优惠数据
在这三个字段中 offerIdentifier 和 offerType 是目前已有的字段而 offerDiscountType 是新增字段也可用于历史交易
offerDiscountType 的值类似于 StoreKit API 中的 paymentMode 它可指明当前优惠属于免费试用、随用随付还是提前支付
有关 App Store Server API 的更多信息请查看“探索适用于 App 内购买项目的 App Store Server API”
接下来如果 App 使用 StoreKit 视图来陈列订阅项目那么有一个新的视图修饰符可在 SubscriptionStoreView 对应的 UI 中显示促销优惠
这个视图修饰符名为 subscriptionPromotionalOffer
使用这个新的视图修饰符可决定视图是否应该显示促销优惠
StoreKit 会提供这个产品的促销优惠列表因此你可以将逻辑重点放在决定返回哪个优惠上
然后为选择的优惠生成签名并返回优惠 StoreKit 会在 UI 中显示详细信息如果顾客选择订阅 StoreKit 还会为购买添加优惠
有关支持促销优惠和生成签名的信息请查看本讲座的相关文档
最后 macOS 15.0 现在与 iOS 和 visionOS 一样可展示优惠代码兑换表
在 SwiftUI App 中你可以使用与 iOS 相同的 API 展示优惠代码兑换表
刚才介绍了我们为现有订阅优惠提供的新 StoreKit API 今年我们推出一种新的优惠类型帮你重新获得以前的订阅者我们很高兴推出赢回优惠
让你更轻松地触达以前的 App 订阅者你可以使用 App Store 提供的顾客资格条件设置赢回优惠还可以利用 App Store 自有渠道推广你的赢回优惠赢回优惠专注于在订阅者的订阅过期并停用自动续订时重新吸引流失的订阅者
与 App 中处理和验证顾客资格的机制不同有了赢回优惠就可以通过 App Store 根据特定规则和条件来细分顾客你可以有效地构建顾客相关度更高的新优惠
与现有优惠一样你也可以通过自己的营销渠道推广赢回优惠
赢回优惠会自动出现在顾客的“订阅”页面上你可以在 App Store 上推广赢回优惠这里有一个例子 App Store 以卡片形式展示新的赢回优惠赢回优惠卡包含优惠说明、价格详情、以及优惠适用的订阅信息
顾客可在你的产品页面上发现赢回优惠 App Store 会在这个页面上显示符合条件的优惠
当顾客轻点优惠卡时就会出现一个详细页面其中包含更详细的描述和更大的图片详情页面为顾客提供有关优惠的更多信息
我们的编辑团队在编辑面向顾客的个性化推荐时可能会在“Today”、“游戏” 和“App”标签页上将你的赢回优惠列入编辑精选
最后顾客可以在“订阅”页面找到符合条件的赢回优惠今天我将深入介绍赢回优惠带大家了解 App Store Connect 配置过程然后 Ricky 将通过示例向大家展示如何在 App 中支持和测试赢回优惠最后我们将讨论简化购买体验以及如何在 App 中支持这种体验
首先让我们来详细了解赢回优惠与现有优惠一样在创建赢回优惠时可以选择随用随付、提前支付或免费试用根据不同的类型和订阅情况可以选择不同的优惠期限你可以控制何时向顾客提供赢回优惠还可以选择指定优惠结束日期通过优惠优先级配置你可以指定是否在普通优先级活动和优惠之前显示这个优惠这也是 App Store 上用于个性化设定赢回推荐的因素之一此外你还可以决定哪些特定国家和地区可以获得这个优惠使用 App Store Connect 定价工具可帮助你为所选的每个国家或地区设定价格
赢回优惠支持不同的顾客资格条件包括付费订阅时长、上次订阅距今的时间以及两次优惠间的等待期
付费订阅时长是指顾客为你的服务付费的时间长短通过设置这种条件你可以根据顾客的订阅时长提供折扣
你可以指定以月为单位的最小值
只有最近连续订阅的付费服务月份才会纳入计算范围
付费订阅时长包括顾客在一个订阅组内订阅任何项目的时间同一订阅组中的升级和降级不会影响资格计算
上次订阅距今的时间表示最近一次有效订阅后已过去的时间需要以月为单位来指定最小值和最大值这样你就可以根据流失顾客的退订时长采用不同的策略来重新吸引他们
让我用一个例子来详细解释一下我们的“Destination Video”App 有一个名为 Streaming Pass 的订阅组提供两种月度方案： Basic 和 Premium
这项赢回优惠可让符合条件的顾客免费使用 Basic 订阅一个月为了符合获得这项优惠的条件顾客必须已连续支付订阅费用至少三个月顾客的订阅必须在过去 2 至 24 个月内处于活跃状态而且自顾客上次兑换这个优惠起至少已过去 6 个月
让我们从顾客的角度来看看一开始顾客订阅了 Premium 方案
后来降级到 Basic 方案
最后两个月后顾客取消了订阅这时这位顾客已经满足了这项赢回优惠的付费订阅时长资格要求
在顾客取消订阅后我们就可以开始计算上次订阅距今的时间
两个月后顾客有资格获得赢回优惠因为我们已将上次订阅距今的最短时间设置为两个月
现在我们来谈谈两次优惠间的等待期这是一项可选要求可设置顾客再次兑换优惠前必须等待的最短时间
赢回优惠期结束后开始计算两次优惠间的等待期
后来顾客续订了这个订阅项目
三个月后顾客取消了订阅
取消后开始计算上次订阅距今的时间
取消两个月后顾客满足了上次订阅距今的时间这项要求但是由于顾客之前已经兑换过优惠而优惠之间至少需要等待六个月因此在优惠结束六个月后这位顾客才有资格享受赢回优惠
刚才我大致介绍了赢回优惠以及顾客资格条件的运作机制下面我们在 App Store Connect 中设置赢回优惠
要为现有订阅创建赢回优惠首先要导航到订阅定价页面
这个页面上有一个新标签名为“Win-Back Offers” 首次点按这个标签时系统会显示类似这样的页面点按“Create Offer”按钮可开始配置新的赢回优惠这时会出现一个模态视图第一步是输入优惠的参考名称以及优惠标识符这两个字段在你的订阅组中必须是唯一的 App 在与 StoreKit API 通信时会使用优惠标识符创建这些字段后就无法修改按照统一的命名惯例为优惠命名以便简化开发工作下一步是选择开始日期和结束日期、优惠优先级以及确定顾客资格条件
要在 App Store 发布优惠需要提供开始日期
你可以随时调整优惠优先级最后指定顾客资格以便系统根据这些条件判定顾客何时有资格获得优惠你可以在优惠生效前调整所有这些设置但在优惠开始日期后这些设置将被锁定
下一步你可以选择提供优惠的国家和地区然后选择优惠的类型是随用随付、提前支付还是免费接下来选择持续时间
如果是付费优惠还要从下拉菜单中选择基于默认货币的价格使用选择的价格 App Store Connect 会为你提供多个最佳价格与你为这个优惠选择的每个国家和地区相匹配你可以点按各自的下拉菜单进行调整创建优惠后优惠价格设置无法更改
最后你可以查看并确认赢回优惠详情如果你想更新设置请点按返回按钮重新查看之前的步骤
如果配置无误请点按“确认” 完成新优惠的创建
现在你的赢回优惠已经创建好了你可以通过自己的营销渠道和 App Store 推广这个优惠
在这里我们还提供一个优惠链接
以便你通过自己的营销渠道发布优惠
如果你想在 App Store 上推广你的赢回优惠则需要为订阅配置一些设置详情
在优惠详情页面有一个部分名为 “Promote on the App Store” 如果你的订阅没有图片你就会看到这个部分点按这里的链接为你的订阅上传图片
然后进入订阅详情页面将图片提交给 App Review 团队
一旦订阅图片通过审核而且你已经为优惠启用了 App Store 推广赢回优惠生效后就会在 App Store 自动进行推广
如果优惠尚未生效你可以取消优惠不在 App Store 上进行推广但是赢回优惠生效后必须删除赢回优惠才能让优惠不再显示在 App Store 上
在 App Store 上已推广的赢回优惠会以新优惠卡的形式显示在详细视图中我们会将已批准的订阅图片和 App 图标组合在一起创建一个新图片就像这样
这就是如何在 App Store Connect 中为订阅设置赢回优惠 App Store Connect API 3.6 提供了丰富的资源让你可以按照自定流程设置赢回优惠
新的 WinBackOffers API 包括创建、读取、更新和删除赢回优惠的端点你可以使用这些 API 轻松管理优惠流程我们还为订阅和 inAppPurchase 添加了两个新的图片资源同时我们还弃用了现有的 PromotedPurchaseImages 资源对于如何在 App Store Connect 中设置赢回优惠相信大家已有所了解下面 Ricky 将讨论如何使用 StoreKit 2 为赢回优惠提供支持感谢 Xiaolan 为我们讲解如何在 App Store Connect 中配置赢回优惠下一步是使用 StoreKit 2 在 App 中添加代码以支持这些新优惠首先让我们回顾一下如何区分赢回优惠和其他现有优惠类型 StoreKit 2 使用 OfferType 模型来标识 SubscriptionOffer 类型支持的类型有：推介促销优惠、促销优惠以及从 iOS 18.0 开始的赢回优惠 App 中优惠的定价和持续时间可在产品模型下的订阅信息中找到其中每个可用优惠类型都有成员：适用的推介促销优惠、促销优惠列表以及从 iOS 18.0 开始提供的赢回优惠列表在 App 中构建对优惠的支持时这些信息非常重要可帮你判断 SubscriptionOffer 对象是哪种优惠并获取为订阅配置的特定优惠类型的信息现在我们看一下如何为使用赢回优惠的订阅提供订阅陈列和购买方面的支持
StoreKit Message API 是向顾客展示赢回优惠的最快速、最简单的方法 StoreKit 视图提供了各种选项可帮助你构建出色的陈列 UI 并显示订阅以及任何优惠的详细信息最后如果你希望进一步掌控订阅陈列和 UI 可以使用核心 StoreKit 2 API 你可以根据想要实现的自定程度选择其中一个或多个选项
当 App 收到 winBackOffer 消息时 StoreKit 会向顾客展示类似这样的表单详细说明订阅和优惠价格顾客可以使用下面的按钮选择接受优惠并重新订阅服务
为了支持这种体验 Message API 现提供一个新 Reason 名为 winBackOffer
当顾客有资格获得赢回优惠时 App 会自动接收这条消息
请确保你也在 App 中侦听交易动态这样你就可以收到购买通知并授予访问解锁内容的权限
之后你就可以进入 iOS 沙盒账户设置在沙盒中测试赢回优惠启用“Display Win-back Offers” 开关以便在有资格获得新优惠时在 App 中收到相应的消息
我们介绍了如何在 iOS 18.0 中使用 StoreKit Message 在 App 中支持赢回优惠以及如何在沙盒中进行测试
如果你希望提升陈列 UI 的自定程度我们在 WWDC23 上为大家展示了如何使用 StoreKit 视图这些精美的现成 API 可帮你更好地显示和陈列 App 内购买项目 StoreKit 视图在顾客符合条件时自动支持在 SubscriptionStoreViews 中显示所有订阅优惠的定价详情包括赢回优惠因此无需额外工作有时一位顾客可能有多个符合条件的优惠你可能需要运行一些额外的逻辑来确定应该在视图中显示哪项优惠为此我们在 StoreKit 视图中新增了一个视图修饰符名为 preferredSubscriptionOffer
将 preferredSubscriptionOffer 与 SubscriptionStoreView 搭配这样有多项可用优惠时就可以控制应该使用哪项优惠 StoreKit 会负责获取优惠元数据并完成购买设置
下面看看如何将这个新的视图修饰符与 SubscriptionStoreView 相结合
为了陈列“Destination Video”App 中提供的订阅方案我使用 Streaming Pass 方案的订阅组 ID 设置了一个 SwiftUI 视图 SubscriptionStoreView 会自动显示可用优惠详情例如这个月度订阅方案在这里你可以看到 StoreKit 会自动选择优惠的定价
添加 preferredSubscriptionOffer 修饰符可检查任何其他可用的优惠并确定要显示哪项优惠
preferredSubscriptionOffer API 只需一个参数那就是 StoreKit 为组中每项订阅调用的函数在这个函数中 StoreKit会提供产品对象、订阅信息以及顾客当前有资格获得的所有优惠的列表
这就是你需要从 StoreKit 提取的所有信息在此基础之上你可以运行自己的业务逻辑确定要使用哪种优惠选定优惠后这里会返回 SubscriptionOffer 对象
请记住如果返回的是 nil 而顾客有资格获得订阅的推介促销优惠 App 就会在视图中始终显示推介促销优惠在本例中我会查找提供最长免费试用期的优惠如果没有免费试用优惠我会选择列表中的第一项优惠在 App 中你可能希望根据优惠的定价和持续时间在这里添加更多逻辑由于顾客有资格获得按月订阅的三个月免费试用优惠你可以在 SwiftUI 视图中看到新的定价详情
这就是如何自定 SubscriptionStoreViews 向顾客显示不同的优惠如果需要更好地控制订阅的陈列体验或者想要创建自定 UI 你可以使用核心 StoreKit API 自行管理优惠陈列
前面介绍了在产品模型中可以从何处查找优惠详情但赢回优惠的资格问题因顾客而异 Xiaolan 向大家展示了如何在 App Store Connect 中配置这种资格
为简化操作并帮助你向顾客显示正确的优惠 StoreKit 推出了一个新 API 可向每位顾客提供个性化的优惠列表显示符合条件的赢回优惠这个 API 名为eligibleWinBackOfferIDs
你可以在订阅状态模型的 RenewalInfo 对象中找到这个新的 API 还可快速访问 ID 列表了解顾客能够立即兑换的赢回优惠有哪些使用这个列表可在订阅信息中搜索相应的优惠并在视图中显示定价详情
我将演示如何使用这些新 API 在“Destination Video”中添加对赢回优惠的支持根据我的 App 现有的逻辑向顾客显示任何陈列内容之前 App 会先检查订阅状态以及是否符合推介促销优惠的资格条件为了实现这一点我使用这个函数来确定顾客当前的订阅状态以及顾客是否有资格获得任何优惠这个函数需要两个参数：需要检查状态的订阅所对应的组 ID 以及产品 ID 列表
首先获取订阅的当前状态
然后使用之前创建的数据结构进行解析确定顾客是否有权使用服务以及是否启用了自动续订功能
有了这些信息我就可以确定是否需要使用这个枚举来显示任何陈列 UI
如果顾客启用了自动续订功能就会返回一个标志表明不应显示任何陈列内容
如果顾客当前没有订阅那么就可以显示陈列 UI 在这种情况下我会首先载入我想要陈列的订阅产品然后我需要确定顾客是否有资格获得推介促销优惠如果有获得优惠的资格则返回订阅产品和优惠并在视图中显示相应的信息
如果顾客没有资格获得推介促销优惠我可以查看之前检索到的订阅状态看看顾客是否有资格获得赢回优惠
由于赢回优惠只适用于不再订阅这个产品的顾客因此我需要查看顾客过往订阅的状态因为顾客也许还可以通过家人共享访问服务
赢回优惠资格可以在这个订阅状态的续订信息中找到有了这些信息我就可以查找最佳赢回优惠 ID 通常是列表中的第一个对象但如果有多个优惠你可能需要查看其他可用优惠如果至少有一个赢回优惠我就可以返回这个优惠以及相应的产品供顾客兑换要获得优惠详情我需要创建视图我可以在订阅信息的所有优惠列表中搜索 SubscriptionOffer 对象
如果符合条件的赢回优惠 ID 列表为空则表示顾客不符合任何优惠的条件因此我可以显示包含常规订阅定价的陈列视图
这就是如何在现有订阅状态工作流中检查顾客是否有资格获得赢回优惠一旦顾客选择兑换优惠你需要做的最后一件事就是将赢回优惠添加到购买中
这样做很简单在 iOS 18.0 中你可以使用一个新的 PurchaseOption API 名为 winBackOffer
使用这个 API 可将表示赢回优惠的 SubscriptionOffer 对象添加到购买中然后将购买选项传递给购买 API StoreKit 在 App 中显示付款单之前 App Store 会检查顾客是否符合优惠资格
这就是在 App 中支持赢回优惠的全部内容！ StoreKit Message 是向顾客显示赢回优惠的最快捷选择利用 StoreKit 视图你可能不需要添加任何代码这取决于你的具体情况而且你还可以创建精美的订阅陈列 UI 要进一步了解 StoreKit 视图中的其他新功能请观看 WWDC24 讲座“StoreKit 和 App 内购买项目的新功能” 如果需要为你的 App 和订阅服务创建自定工作流和 UI 可在 SubscriptionStatus 和 SubscriptionInfo 中使用新的 StoreKit API 查找适合顾客的优惠并在你自己的陈列视图中显示相应的优惠
在 App 中添加代码支持赢回优惠后你需要在不同的场景以及不同的订阅状态下进行测试你可以在沙盒中测试实现赢回优惠的所有支持方法我之前讨论过如何测试赢回优惠 StoreKit Message
如果你决定使用 StoreKit 视图、核心 StoreKit API 或两者的组合这些也可以使用 Xcode 中的 StoreKit 测试功能进行测试这也是在开发 App 时测试优惠的最快方法
这是 Xcode 中的新功能可帮助你立即在 App 中测试赢回优惠
要在 Xcode 中配置赢回优惠首先打开 StoreKit 配置在其中设置本地 App 内购买项目然后在“Auto-Renewable Subscriptions” 标题下找到你的订阅向下滚动到“Win-back Offers” 部分你会看到一个表格
点按加号 (+) 按钮配置新优惠然后输入所需详情：优惠名称、
优惠 ID、
所有其他优惠类型都需要的支付模式、
持续时间
以及适用的价格
在 App Store Connect 中你可以根据不同的规则、状态以及顾客在兑换优惠前需要满足的条件配置赢回优惠的资格为了快速有效地测试顾客资格的结果我们在 Xcode 中添加了一个开关用于更改每项优惠的资格因此无需担心订阅状态和其他资格条件
使用这个顾客资格开关来确定流失的订阅用户是否应在 App 中接收赢回优惠在调试时更改这个开关的状态测试不同情况下顾客的优惠资格看看 App 的反应如何
点按“Save”后我就为这个订阅设置了一项新的赢回优惠要配置更多优惠请根据测试需求使用不同的设置重复这些步骤
就是这样我现在可以开始在 App 中测试赢回优惠了 Xcode 中的 StoreKit 测试功能是测试订阅优惠的好工具你可以快速测试不同设置和顾客状态下的赢回优惠感谢 Ricky！最后一个话题是关于我们为赢回优惠添加的简化购买体验我已经介绍了如何在 App Store 上推广赢回优惠推广赢回优惠时顾客可以使用简化购买功能在 App Store 上一次性兑换优惠并订阅服务你的 App 默认启用简化购买你可以通过 App Store Connect 配置相关设置
如果你在 App 中对赢回优惠使用简化购买当顾客轻点“订阅”按钮兑换优惠时 App Store 将显示付款单顾客可以在付款单中查看订阅和优惠的详细信息一旦顾客确认并完成购买顾客打开 App 就可以立即访问订阅服务你可能需要顾客在 App 中进行某些操作然后才能继续购买和兑换赢回优惠在这种情况下你可以使用 App Store Connect 中的设置关闭赢回优惠的简化购买进入订阅页面你可以在“Billing Grace Period”下看到一个配置简化购买的新部分点按编辑按钮你可以选择关闭简化购买
如果关闭简化购买 App Store 会将购买直接发送到你的 App 而你可以在 App 内创建自定体验为了支持这种体验你需要在 App 中进行一些更改
如果你决定关闭简化购买但仍想在 App Store 上推广赢回优惠你需要在 App 中设置一些代码以接收顾客在 App Store 上发起的购买为此可以使用我们在 WWDC23 讨论过的 PurchaseIntent API 当顾客在 App 之外开始购买时 App Store 就会发送购买意图例如推广的 App 内购买项目或赢回优惠当你收到新的购买意图时你可以立即继续推进购买流程并显示付款单也可以存储这个意图以供日后使用
PurchaseIntent 可用于接收顾客在 App Store 上开始兑换的赢回优惠为此 iOS 18.0 和 macOS 15.0 提供了名为 offer 的新成员这是一个可选的 SubscriptionOffer 类型只有当购买意图包含赢回优惠时才会填充这个类型
收到带有赢回优惠的购买意图时使用所提供的优惠信息向顾客展示完整的优惠详情和陈列内容然后像往常一样发起购买并将所选优惠添加到购买选项中
在 Xcode 16 中使用 Xcode 中的 StoreKit 测试功能测试购买意图侦听器和延迟逻辑请查看 StoreKit 讲座 “StoreKit 和 App 内购买项目的新功能” Rudy 将在讲座中详细介绍相关详情
关于赢回优惠的简化购买以及需要关闭这个功能时如何在 App 中处理这些购买我们就讲到这里这就是我们今天的全部内容！我们讨论了 StoreKit 中的新增和增强版订阅优惠 API 我们还向大家简要概述了赢回优惠并演示了如何配置赢回优惠以及在 App 中支持这种新优惠类型的多种方法最后我们还展示了如何在 App Store 上推广赢回优惠以及顾客如何使用简化购买方式兑换优惠
你现在就可以开始在 App 中添加支持并测试赢回优惠我们期待看到你创造的新体验请使用“反馈助理” 与我们分享你的反馈如果你想了解更多信息请访问我们的开发者网站查阅文档还有许多其他精彩讲座不容错过别忘了观看 “StoreKit 和 App 内购买项目的新功能” 和“App Store Connect 的新动向”！希望这次讲座能给大家带来灵感让你更顺畅地将优惠添加到 App 中感谢你的参与

4:25 - Present offer code redemption sheet on macOS - SwiftUI API

// Present offer code redemption sheet on macOS - SwiftUI API

import SwiftUI
import StoreKit

struct MyView: View {

    @State var showOfferCodeRedemption: Bool = false

    var body: some View {
        Button("Redeem Code") {
            showOfferCodeRedemption = true
        }
        .offerCodeRedemption(isPresented: $showOfferCodeRedemption) { result in
            // Handle result
        }
    }
}

20:15 - Choose preferred offer in a SubscriptionStoreView

// Choose preferred offer in a SubscriptionStoreView

import SwiftUI
import StoreKit

struct MyView: View {
    let groupID: String
    
    var body: some View {
        SubscriptionStoreView(groupID: groupID)
            .preferredSubscriptionOffer { product, subscription, eligibleOffers in
                let freeTrialOffer = eligibleOffers
                    .filter { $0.paymentMode == .freeTrial }
                    .max { lhs, rhs in
                        lhs.period.value < rhs.period.value
                    }
                return freeTrialOffer ?? eligibleOffers.first
            }
    }
}

23:05 - Check subscription entitlement and offer eligibility

// Check subscription entitlement and offer eligibility

import StoreKit

func shouldShowMerchandising(
    for groupID: String,
    productIDs: [Product.ID]
) async throws -> MerchandisingVisibility {
    // Get subscription status
    let statuses = try await Product.SubscriptionInfo.status(for: groupID)
    
    // Check if the customer is already entitled to the subscription
    let entitlement = SubscriptionEntitlement(for: statuses)
    if entitlement.autoRenewalEnabled {
        return .hidden
    }
    
    // Check for offers to show in merchandising UI
    let products = try await Product.products(for: productIDs)
    
    let isEligibleForIntroOffer = await Product.SubscriptionInfo.isEligibleForIntroOffer(for: groupID)
    if isEligibleForIntroOffer {
        let subscriptions = products.map {
            ($0, $0.subscription?.introductoryOffer)
        }
        return .visible(subscriptions)
    }
    
    // Check for eligible win-back offers
    let purchasedStatus = statuses.first {
        $0.transaction.unsafePayloadValue.ownershipType == .purchased
    }
    let renewalInfo = try purchasedStatus?.renewalInfo.payloadValue
    let bestWinBackOfferID = renewalInfo?.eligibleWinBackOfferIDs.first
    
    // Return the product with the offer if there is one
    if let bestWinBackOfferID {
        let subscriptions: [(Product, Product.SubscriptionOffer?)] = products.map {
            let winBackOffer = $0.subscription?.winBackOffers.first {
                $0.id == bestWinBackOfferID
            }
            return ($0, winBackOffer)
        }
        return .visible(subscriptions)
    }
    
    // Only return the product if there is no offer
    return .visible(products.map { ($0, nil) })
}

struct SubscriptionEntitlement {
    let isEntitled: Bool
    let autoRenewalEnabled: Bool
    
    init(for statuses: [Product.SubscriptionInfo.Status]) {
        let entitledStatuses = statuses.filter {
            $0.state == .subscribed || $0.state == .inBillingRetryPeriod || $0.state == .inGracePeriod
        }
        isEntitled = !entitledStatuses.isEmpty
        autoRenewalEnabled = entitledStatuses.contains {
            $0.renewalInfo.unsafePayloadValue.willAutoRenew
        }
    }
}

enum MerchandisingVisibility {
    case hidden
    case visible([(Product, Product.SubscriptionOffer?)])
}

25:26 - Add a win-back offer to a purchase

// Add a win-back offer to a purchase

import StoreKit

func purchase(
    _ product: Product,
    with offer: Product.SubscriptionOffer?
) async throws {
    // Prepare the purchase options
    var purchaseOptions: Set<Product.PurchaseOption> = []
    
    // Add win-back offer to the purchase
    if let offer, offer.type == .winBack {
        purchaseOptions.insert(.winBackOffer(offer))
    }
    
    // Make the purchase
    try await product.purchase(options: purchaseOptions)
}

正在查找特定内容？在上方输入一个主题，就能直接跳转到相应的精彩内容。

提交你查询的内容时出现错误。请检查互联网连接，然后再试一次。

章节

资源

相关视频

WWDC24

WWDC23