参考

订阅报告

下表列出了订阅报告（版本 1_3）中包含的字段。

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

报告字段	数据类型	备注
App 名称	String	订阅所属 App 的名称。
App Apple ID	BigInt	订阅所属 App 的 Apple ID。
订阅名称	String	订阅的名称。
订阅 Apple ID	BigInt	订阅的 Apple ID。
订阅群组 ID	BigInt	你的订阅群组 ID（以前是家庭 ID）。
标准订阅时限	Int	标准订阅的时限：7 天、1 个月、2 个月、3 个月、6 个月或 1 年。
顾客价格	Decimal	App Store 上显示的且向顾客收取的零售价。
顾客货币	String	顾客使用的货币，以三个字符的 ISO 代码表示。有关更多信息，请参见货币代码。
开发者收入	Decimal	每个订阅的收入。
收入货币	String	你赚取收入所使用的货币。有关更多信息，请参见货币代码。
已保留的定价	String	对于续期事件，如果保留原价，则此字段为“Yes（是）”。否则为空。
收入原因	String	对于续期事件，如果有效订阅达一年以上，你会收到顾客价格的 85%，再减去适用税费，此字段为“Rate After One Year（满一年后的比率）”。否则你会收到顾客价格的 70%，且此字段为空。
订阅优惠名称	String	你在 App Store Connect 中设置促销优惠或优惠代码时输入的优惠参考名称。
促销优惠 ID	String	你在 App Store Connect 中为你的订阅优惠设置的标识符。对于促销优惠，这是设置优惠时在“促销优惠参考名称”栏中填入的值。对于一次性优惠代码，这是设置优惠时在“优惠代码参考名称”栏中填入的值。对于自定优惠代码，这是你分享给用户的代码。
省／自治区／直辖市	String	省／自治区／直辖市字段在顾客注册 Apple ID 时提交的地址中。此字段未验证，可能为空。
国家或地区	String	双字符的 ISO 国家或地区代码，表示购买发生的 App Store 国家或地区。有关更多信息，请参见财务报告地区和货币。
设备	String	用于购买订阅的设备类型：iPhone、iPad、Apple TV、iPod touch 或台式电脑。
客户端	String	如果从“新闻”中购买订阅，则此字段为“News（新闻）”。否则为空。
有效标准价格订阅	Int	当前有效的自动续期标准付费订阅总数，不包括免费试用、订阅优惠、推介促销优惠和营销参与。订阅在顾客已付款且未取消的期间有效。
有效免费试用推介促销优惠订阅	Int	当前为免费试用的推介促销优惠订阅总数。
有效提前支付推介促销优惠订阅	Int	当前为提前支付推介促销价的推介促销优惠订阅总数。
有效随用随付推介促销优惠订阅	Int	当前为随用随付推介促销价的推介促销优惠订阅总数。
免费试用促销优惠订阅	Int	当前为免费试用的促销优惠总数。
提前支付促销优惠订阅	Int	当前为提前支付促销价的促销优惠总数。
随用随付促销优惠订阅	Int	当前为随用随付促销价的促销优惠总数。
营销参与	Int	当前的营销参与赠送期订阅总数。
计费重试	Int	处于“计费重试”状态的订阅总数。表明当出现账单问题（例如，过期的信用卡）时，App Store 仍然尝试自动续期订阅。在从2017年12月7日开始的报告中可用。
帐单宽限期	Int	处于帐单宽限期内的订阅总数。这表示订阅者在一段时间（6 或 16 天）内仍可访问你的内容，同时 Apple 将尝试解决帐单问题。
免费试用优惠代码订阅	Int	当前通过优惠代码免费试用的订阅总数。
提前支付优惠代码订阅	Int	当前通过优惠代码提前支付优惠价格的订阅总数。
随用随付优惠代码订阅	Int	当前通过优惠代码随用随付优惠价格的订阅总数。
订阅者	Int	有权访问自动续期订阅的订阅者数量，包括相应的家庭成员。请注意，如果订阅数小于 3，此字段将留空。进一步了解。

下表列出了订阅报告（版本 1_2）中包含的字段。

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

报告字段	数据类型	备注
App 名称	String	订阅所属 App 的名称。
App Apple ID	BigInt	订阅所属 App 的 Apple ID。
订阅名称	String	订阅的名称。
订阅 Apple ID	BigInt	订阅的 Apple ID。
订阅群组 ID	BigInt	你的订阅群组 ID（以前是家庭 ID）。
标准订阅时限	Int	标准订阅的时限：7 天、1 个月、2 个月、3 个月、6 个月或 1 年。
顾客价格	Decimal	App Store 上显示的且向顾客收取的零售价。
顾客货币	String	顾客使用的货币，以三个字符的 ISO 代码表示。有关更多信息，请参见货币代码。
开发者收入	Decimal	每个订阅的收入。
收入货币	String	你赚取收入所使用的货币。有关更多信息，请参见货币代码。
已保留的定价	String	对于续期事件，如果保留原价，则此字段为“Yes（是）”。否则为空。
收入原因	String	对于续期事件，如果有效订阅达一年以上，你会收到顾客价格的 85%，再减去适用税费，此字段为“Rate After One Year（满一年后的比率）”。否则你会收到顾客价格的 70%，且此字段为空。
促销优惠名称	String	促销优惠参考名称，用于在 App Store Connect 中设置促销优惠。
促销优惠 ID	String	你在 App Store Connect 中为订阅优惠设置的标识符。这是你设置订阅优惠时，在“促销优惠标识符”字段输入的值。请参见“Generating a Signature for Promotional Offers（为促销优惠生成签名）”，了解相关详细信息。
省／自治区／直辖市	String	省／自治区／直辖市字段在顾客注册 Apple ID 时提交的地址中。此字段未验证，可能为空。
国家或地区	String	双字符的 ISO 国家或地区代码，表示购买发生的 App Store 国家或地区。有关更多信息，请参见财务报告地区和货币。
设备	String	用于购买订阅的设备类型：iPhone、iPad、Apple TV、iPod touch 或台式电脑。
客户端	String	如果从“新闻”中购买订阅，则此字段为“News（新闻）”。否则为空。
有效标准价格订阅	Int	当前有效的自动续期标准付费订阅总数，不包括免费试用、订阅优惠、推介促销优惠和营销参与。订阅在顾客已付款且未取消的期间有效。
有效免费试用推介促销优惠订阅	Int	当前为免费试用的推介促销优惠订阅总数。
有效提前支付推介促销优惠订阅	Int	当前为提前支付推介促销价的推介促销优惠订阅总数。
有效随用随付推介促销优惠订阅	Int	当前为随用随付推介促销价的推介促销优惠订阅总数。
免费试用促销优惠订阅	Int	当前为免费试用的促销优惠总数。
提前支付促销优惠订阅	Int	当前为提前支付促销价的促销优惠总数。
随用随付促销优惠订阅	Int	当前为随用随付促销价的促销优惠总数。
营销参与	Int	当前的营销参与赠送期订阅总数。
计费重试	Int	处于“计费重试”状态的订阅总数。表明当出现账单问题（例如，过期的信用卡）时，App Store 仍然尝试自动续期订阅。在从2017年12月7日开始的报告中可用。
帐单宽限期	Int	处于帐单宽限期内的订阅总数。这表示订阅者在一段时间（6 或 16 天）内仍可访问你的内容，同时 Apple 将尝试解决帐单问题。

订阅报告示例

订阅名称	顾客价格	开发者收入	收入原因	有效订阅	有效免费试用	有效提前支付订阅	有效随用随付订阅	计费重试
1 Month Basic	11.99	8.4		364	48	10	0	23
1 Month Basic	11.99	10.2	满一年后的比率	208	0	0	0	0
1 Month Premium	17.99	12.6		194	33	23	17	0

正常价格为 11.99 的“1 Month Basic”共有 572 个有效订阅（364 + 208）。此外，还有 10 个提前支付推介促销价的订阅和 23 个处于“计费重试”状态的订阅。“收入原因”栏中“满一年后的比率”显示，有效时间超过一年且赚取顾客价格的 85%（减去适用税费）的订阅共有 208 个。

价格为 17.99 的“1 Month Premium”共有 267 个有效订阅。此外，共有 73 个推介促销价订阅（33 + 23 + 17）。

订阅名称	标准订阅时限	促销优惠名称	促销优惠 ID	有效标准价格订阅	有效免费试用推介促销优惠订阅	有效提前支付推介促销优惠订阅	有效随用随付推介促销优惠订阅	有效免费试用促销优惠订阅	有效提前支付促销优惠订阅	有效随用随付促销优惠订阅	计费重试
1 Month Basic	1 个月	1 Month Basic Winback Offer A	ExampleOfferIDa	0	0	0	0	0	32	0	0
1 Month Basic	1 个月	1 Month Basic Winback Offer B	ExampleOfferIDb	0	0	0	0	0	0	45	0

上述示例显示了“1 Month Basic”的两种不同订阅优惠。32 个有效订阅属于提前支付“1 Month Basic Winback Offer A”，45 个有效订阅属于随用随付“1 Month Basic Winback Offer B”。