Subscriber report

Event Date

Date

Date the event occurred.

App Name

String

Title of your subscription’s parent app.

App Apple ID

BigInt

Apple ID of your subscription’s parent app.

Subscription Name

String

Title of your subscription.

Subscription Apple ID

BigInt

Apple ID of your subscription.

Subscription Group ID

BigInt

Your subscription’s Group ID (formerly Family ID).

Standard Subscription Duration

String

Duration of the standard subscription: 7 Days, 1 Month, 2 Months, 3 Months, 6 Months, or 1 Year.

Subscription Offer Name

String

The promotional offer reference name or the offer code reference name used in App Store Connect when setting up the subscription offer.

Promotional Offer ID

String

A code that you create for customers to enter and redeem the subscription offer.

Introductory Price Type

String

Type of introductory price: Pay Up Front, Pay As You Go, or Free Trial

Subscription Offer Duration

String

Duration of the introductory price if applicable: For example, 3 Days, 1 Week, 2 Weeks, 1 Month, 2 Months, 3 Months, 6 Months, or 1 Year.

Marketing Opt-In Duration

String

Duration of the marketing opt-in if applicable: 7 Days, 1 Month, 2 Months, 3 Months, 6 Months, or 1 Year.

Customer Price

Decimal

The price of your auto-renewable subscription.

Negative values indicate refunds.

Customer Currency

String

Three-character ISO code indicating the customer’s currency. For more information, visit Currency codes.

Developer Proceeds

Decimal

The proceeds for each item delivered.

Proceeds Currency

String

The currency in which your proceeds are earned. For more information, visit Currency codes.

Preserved Pricing

String

For renewals, if the price is preserved then this field equals “Yes”. Otherwise, it is blank.

Proceeds Reason

String

If a subscription has been active for more than a year then you receive 85% of the customer price, minus applicable taxes, and this field equals “Rate After One Year.” Otherwise, you receive 70% and the field is blank.

Client

String

If the subscription was purchased from News then this field equals “News”. Otherwise, it is blank.

Device

String

Type of device used for subscription purchase: iPhone, iPad, Apple TV, iPod touch, or Desktop.

Country

String

Two-character ISO country code indicating the App Store country or region for the purchase. For more information, visit Financial Report Regions and Currencies.

Subscriber ID

BigInt

The randomly generated Subscriber ID that's unique to each customer and developer. This field will be null when a customer requests a refund after the 180-day countdown described in Subscriber ID Reset.

Subscriber ID Reset

String

If a customer cancels all of their subscriptions with you and does not resubscribe within 180 days, the Subscriber ID will be deleted. If the same customer resubscribes after 180 days, then we create a new Subscriber ID and this field equals “Yes.” Otherwise, it is blank.Subscriber IDs are reset when an app is transferred to another developer account.

Refund

String

For full or partial refunds, this field equals “Yes.” Otherwise, it's blank. Refunds with a positive customer price imply a refund reversal.

Purchase Date

Date

For refunds, the date of the original purchase.

Units

Decimal

The aggregated number of units. A value of 0 may indicate a partial refund.