- 27 Dec 2022
- 1 Minute to read
- Print
- DarkLight
Data Source - App Store Connect API
- Updated on 27 Dec 2022
- 1 Minute to read
- Print
- DarkLight
This is a machine-translated version of the original Japanese article.
Please understand that some of the information contained on this page may be inaccurate.
Overview
This is a help page for setting up transferring report data from the App Store.
Importable Data
We are retrieving data using the App Store Connect API.
"Financial Report" and "Sales and Trends" can be obtained.
Each report can be linked with the same reports that can be downloaded from "Payments and Financial Reports" and "Sales and Trends" in App Store Connect.
* The help page for sales and trends is here.
* The financial report help page is here.
Supported Protocols
- Data Transfer (Embulk)
Using embulk-input-http
Settings
STEP 1: General Settings
Field Name | Required | Default Value | Description |
---|---|---|---|
App Store Connect API connection information | Yes | - | From the connection information registered in advance, select the one that has the necessary permissions for this transfer setting. |
API Endpoint | Yes | - | Specify the URL to connect to the API. |
Input file format | Yes | .CSV | Specifies the format of the input file. ・CSV ・JSON Lines ・JSONPath You can choose from: |
Query Parameters | No | - | You can specify query parameters to include in requests to the API. See Query parameter types below for parameter types. Parameter values can also be set dynamically during trocco data transfer using custom variables. |
Types of Query Parameters
The parameters that can be specified differ depending on the type of report (API Endpoint URL) to be retrieved.
Please refer to the official documentation for details.
Finance Reports
Parameter Name | Description |
---|---|
filter[regionCode] | You can specify the units of currency. See the official documentation for the code. |
filter[reportDate] | You can specify the date of the report that you want to retrieve based on the Apple Fiscal Calendar. Specify it in YYYY-MM format. |
filter[reportType] | You can specify FINANCIAL or FINANCE_DETAIL as the report type. |
filter[vendorNumber] | You can specify a vendor number. For more information, please refer to the official documentation. |
Sales and Trends Reports
Parameter Name | Description |
---|---|
filter[frequency] | You can specify the interval at which reports are retrieved. YOU CAN SPECIFY DAILY, WEEKLY, MONTHLY, OR YEARLY. |
filter[reportDate] | You can specify the date of the report to retrieve. Specify it in YYYY-MM-DD format. For more information, please refer to the official documentation. |
filter[reportSubType] | You can specify SUMMARY, DETAILED, and OPT_IN report subtypes. |
filter[reportType] | YOU CAN SPECIFY SALES, PRE_ORDER, NEWSSTAND, SUBSCRIPTION, SUBSCRIPTION_EVENT, AND SUBSCRIBER REPORT TYPES. |
filter[vendorNumber] | You can specify a vendor number. For more information, please refer to the official documentation. |
filter[version] | You can specify the version of the report. For more information, please refer to the official documentation. |