参考

订阅事件报告

下表列出了订阅事件报告(版本 1_3)中包含的字段。

提示:请查看报告示例,以便更好地理解各字段的值。

报告字段

数据类型

备注

事件日期

Date

事件发生的日期。

事件

String

发生的事件类型。有关更多信息,请参见订阅事件

App 名称

String

订阅所属 App 的名称。

App Apple ID

BigInt

订阅所属 App 的 Apple ID。

订阅名称

String

订阅的名称。

订阅 Apple ID

BigInt

订阅的 Apple ID。

订阅群组 ID

BigInt

你的订阅群组 ID(以前是家庭 ID)。

标准订阅时限

String

标准订阅的时限:7 天、1 个月、2 个月、3 个月、6 个月或 1 年。

订阅优惠类型

String

推介促销价类型:提前支付、随用随付或免费试用。

订阅优惠持续时间

String

推介促销价的持续时间(如适用)。例如:3 天、7 天、2 周、1 个月、2 个月、3 个月、6 个月或 1 年。

营销参与

String

如果订阅包括营销参与,则此字段为“Yes(是)”。否则为空。

营销参与时限

String

参与时限(如适用):7 天、1 个月、2 个月、3 个月、6 个月或 1 年。

已保留的定价

String

对于续期事件,如果保留原价,则此字段为“Yes(是)”。否则为空。

收入原因

String

对于续期事件,如果有效订阅达一年以上,你会收到顾客价格的 85%,再减去适用税费,此字段为“Rate After One Year(满一年后的比率)”。否则你会收到顾客价格的 70%,且此字段为空。

促销优惠名称

String

促销优惠参考名称,用于在 App Store Connect 中设置促销优惠。

促销优惠 ID

String

你在 App Store Connect 中为订阅优惠设置的标识符。这是你设置订阅优惠时,在“促销优惠标识符”字段输入的值。请参见“Generating a Signature for Promotional Offers(为促销优惠生成签名)”,了解相关详细信息。

连续付费时间段

Int

付费时间段总数,期间订阅已生效未取消。不包括免费试用、营销参与赠送期或宽限期。

初始日期

Date

初次订阅购买日期。

设备

String

用于初次购买订阅的设备类型:iPhone、iPad、Apple TV、iPod touch 或台式电脑。

客户端

String

如果从“新闻”中购买订阅,则此字段为“News(新闻)”。否则为空。

省/自治区/直辖市

String

省/自治区/直辖市字段在顾客注册 Apple ID 时提交的地址中。此字段未验证,可能为空。

国家或地区

String

购买所在的 App Store 地区,以双字符的 ISO 国家或地区代码表示。有关更多信息,请参见财务报告地区和货币

先前订阅名称

String

对于升级订阅、降级订阅和同级转换订阅事件,指先前订阅的名称。

先前订阅 Apple ID

BigInt

对于升级订阅、降级订阅和同级转换订阅事件,指先前订阅的 Apple ID。

取消前订阅天数

Int

对于取消事件,指从开始日期到订阅者取消之间的天数,取消可能发生在订阅期中间。该项仅适用于取消原因为“取消”的取消事件。否则为空。

取消原因

String

取消原因:帐单问题、价格上调、已取消、已下架或其他。有关更多信息,请参见取消原因

取消订阅天数

Int

对于重新激活事件,指订阅者取消订阅的天数。

数量

Int

事件数与其他字段的值相同。

补计付费服务天数

Int

预估因帐单宽限期而应补回的付费服务天数。

下表列出了订阅事件报告(版本 1_2)中包含的字段。

提示:请查看报告示例,以便更好地理解各字段的值。

报告字段

数据类型

备注

事件日期

Date

事件发生的日期。

事件

String

发生的事件类型。有关更多信息,请参见订阅事件

App 名称

String

订阅所属 App 的名称。

App Apple ID

BigInt

订阅所属 App 的 Apple ID。

订阅名称

String

订阅的名称。

订阅 Apple ID

BigInt

订阅的 Apple ID。

订阅群组 ID

BigInt

你的订阅群组 ID(以前是家庭 ID)。

标准订阅时限

String

标准订阅的时限:7 天、1 个月、2 个月、3 个月、6 个月或 1 年。

订阅优惠类型

String

推介促销价类型:提前支付、随用随付或免费试用。

订阅优惠持续时间

String

推介促销价的持续时间(如适用)。例如:3 天、7 天、2 周、1 个月、2 个月、3 个月、6 个月或 1 年。

营销参与

String

如果订阅包括营销参与,则此字段为“Yes(是)”。否则为空。

营销参与时限

String

参与时限(如适用):7 天、1 个月、2 个月、3 个月、6 个月或 1 年。

已保留的定价

String

对于续期事件,如果保留原价,则此字段为“Yes(是)”。否则为空。

收入原因

String

对于续期事件,如果有效订阅达一年以上,你会收到顾客价格的 85%,再减去适用税费,此字段为“Rate After One Year(满一年后的比率)”。否则你会收到顾客价格的 70%,且此字段为空。

促销优惠名称

String

促销优惠参考名称,用于在 App Store Connect 中设置促销优惠。

促销优惠 ID

String

你在 App Store Connect 中为订阅优惠设置的标识符。这是你设置订阅优惠时,在“促销优惠标识符”字段输入的值。请参见“Generating a Signature for Promotional Offers(为促销优惠生成签名)”,了解相关详细信息。

连续付费时间段

Int

付费时间段总数,期间订阅已生效未取消。不包括免费试用、营销参与赠送期或宽限期。

初始日期

Date

初次订阅购买日期。

设备

String

用于初次购买订阅的设备类型:iPhone、iPad、Apple TV、iPod touch 或台式电脑。

客户端

String

如果从“新闻”中购买订阅,则此字段为“News(新闻)”。否则为空。

省/自治区/直辖市

String

省/自治区/直辖市字段在顾客注册 Apple ID 时提交的地址中。此字段未验证,可能为空。

国家或地区

String

购买所在的 App Store 地区,以双字符的 ISO 国家或地区代码表示。有关更多信息,请参见财务报告地区和货币

先前订阅名称

String

对于升级订阅、降级订阅和同级转换订阅事件,指先前订阅的名称。

先前订阅 Apple ID

BigInt

对于升级订阅、降级订阅和同级转换订阅事件,指先前订阅的 Apple ID。

取消前订阅天数

Int

对于取消事件,指从开始日期到订阅者取消之间的天数,取消可能发生在订阅期中间。该项仅适用于取消原因为“取消”的取消事件。否则为空。

取消原因

String

取消原因:帐单问题、价格上调、已取消、已下架或其他。有关更多信息,请参见取消原因

取消订阅天数

Int

对于重新激活事件,指订阅者取消订阅的天数。

数量

Int

事件数与其他字段的值相同。

补计付费服务天数

Int

预估因帐单宽限期而应补回的付费服务天数。

订阅事件报告示例

事件日期

事件

订阅名称

连续付费时间段

初始日期

取消原因

推介促销价类型

数量

2016-09-01

启用推介促销价

1 Month Basic

0

2016-09-01

免费

10

2016-09-01

从推介促销价转为付费订阅

1 Month Basic

1

2016-08-25

免费

8

2016-09-01

续期

1 Month Basic

2

2016-08-01

14

2016-09-01

续期

1 Month Basic

3

2016-07-01

12

2016-09-01

取消

1 Month Basic

1

2016-08-01

账单问题

3

  • 8 个订阅在2016年9月1日由免费试用转为付费订阅。这些订阅的免费试用开始于2016年8月25日

  • 14 个订阅已续期,进入第二个账单周期

  • 在下一行中,12 个订阅已续期,进入第三个账单周期

  • 3 个订阅在一个账单周期后结束,因为尝试续期时遇到了账单问题

事件日期

事件

订阅名称

连续付费时间段

初始日期

取消订阅天数

数量

2016-09-01

退款

1 Month Basic

1

2016-08-15

1

2016-09-01

重新激活

1 Month Basic

1

2016-09-01

7

2

  • 1 个订阅于2016年8月15日开始,但于2016年9月1日结束,剩余账单周期已退款

  • 2 个订阅在取消 7 天后于2016年9月1日重新激活

事件日期

事件

订阅名称

连续付费时间段

初始日期

先前订阅名称

数量

2016-09-01

升级

1 Month Premium

2

2016-08-20

1 Month Basic

2

2016-09-01

降级

1 Month Basic

2

2016-08-01

1 Month Premium

1

  • 2 个订阅于2016年9月1日升级

  • 1 个订阅于2016年9月1日降级

事件日期

事件

订阅名称

连续付费时间段

初始日期

取消前订阅天数

取消原因

数量

2016-09-01

取消

1 Month Premium

1

2016-08-01

15

已取消

2

  • 2 个订阅在一个账单周期后取消。账单周期于2016年9月1日结束,订阅者在2016年8月1日开始订阅的 15 天后轻点了取消按钮,即如“取消之前天数”栏所示

事件日期

事件

订阅名称

连续付费时间段

初始日期

取消原因

数量

2017-10-01

从付费订阅转为计费重试

1 Month Basic

2

2017-09-01

11

  • 11 个订阅由于账单问题无法续期,于2017年10月1日转为“计费重试”状态

事件日期

事件

订阅名称

连续付费时间段

初始日期

取消原因

数量

2017-11-01

计费重试后续期

1 Month Basic

3

2017-08-01

7

2017-11-01

从计费重试转为取消

1 Month Basic

2

2017-07-01

账单问题

4

  • 7 个订阅成功续期,于2017年11月7日不再处于“计费重试”状态

  • 4 个订阅因为无法在“计费重试”状态下续期而取消

事件日期

事件

订阅名称

连续付费时间段

初始日期

推介促销价类型

推介促销价的持续时间

数量

2016-09-01

启用推介促销价

1 Month Basic

0

2016-09-01

提前支付

3 个月

13

2016-09-01

从推介促销价转为付费订阅

1 Month Basic

4

2016-08-25

8

2016-09-01

续期

3 Month Basic

1

2016-08-01

随用随付

6 个月

14

2016-09-01

从推介促销价转为付费订阅

3 Month Basic

3

2016-08-01

17

  • 13 个订阅于2016年9月1日以提前支付推介促销价开始。上述订阅提前支付总时限为 3 个月

  • 8 个订阅由 3 个月的提前支付推介促销价的订阅转为付费订阅

  • 14 个订阅以随用随付推介促销价续期,总时限为 6 个月

  • 17 个订阅也从推介促销价订阅转变为付费订阅

事件日期

事件

订阅名称

促销优惠名称

促销优惠 ID

订阅优惠类型

订阅优惠持续时间

先前订阅名称

数量

2016-09-01

启用促销优惠

1 Month Basic

1 Month Basic Offer A

ExampleOfferIDa

随用随付

1 个月

12

2016-09-01

重新激活促销优惠

1 Month Basic

1 Month Basic Offer B

ExampleOfferIDb

随用随付

1 个月

1 Month Basic

67

  • 12 个促销优惠于2016年9月1日生效

  • 先前取消的 67 个订阅于2016年9月1日重新激活促销优惠