Actions2
Overview
This node downloads and parses Apple App Store analytics reports for a specified app. It is useful for automating the retrieval of detailed app usage, installation, and deletion data directly from Apple's App Store Connect API. Typical use cases include monitoring app performance metrics over time, integrating app analytics into custom dashboards, or triggering workflows based on app usage trends.
The node supports two main operations:
- Download & Parse: Downloads the report, decompresses it, parses the tab-separated values into JSON objects, and outputs structured data.
- Download: Downloads the raw report file as binary data without parsing.
For example, you can configure the node to fetch monthly installation and deletion statistics for your app on a specific date, then process this data further in your workflow.
Properties
| Name | Meaning |
|---|---|
| Granularity | The time granularity of the report data. Options: Daily, Monthly. |
| Access Type | The type of access for the report. Options: One Time Snapshot, Ongoing. |
| App ID | The unique identifier of the app in App Store Connect for which the report is requested. |
| Report Name | The name of the report to download (e.g., "App Store Installation and Deletion Standard"). |
| Report Date | The date of the report to retrieve, formatted as YYYY-MM-DD. |
| Report Category | The category of the report, e.g., APP_USAGE. |
| Options | Additional options: |
| - Put Result in Field | The name of the output field where the parsed report data will be stored (default: report). |
Output
- When using Download & Parse, the node outputs JSON data with the parsed report content under the specified result field (default
"report"). The data is an array of objects, each representing a row from the report with keys corresponding to column headers. - When using Download, the node outputs binary data containing the raw CSV report file compressed by Apple. The binary data is accessible under the field named
"report".
Dependencies
- Requires an API key credential for Apple App Store Connect API authentication.
- Uses JWT token generation for authorization.
- Makes HTTP requests to Apple’s App Store Connect API endpoints.
- Uses built-in Node.js modules for URL handling and decompression (
zlib). - Requires n8n environment configured with the appropriate Apple API credentials.
Troubleshooting
- Segment not found: Indicates that the report segment for the specified filters does not exist. Verify the report date, granularity, and other filter parameters.
- Instance not found: Means no report instance was found for the given criteria. Check if the report is available for the requested date and app.
- No report found for this AppId: No matching report request was found for the app ID and access type. Confirm the app ID and access type are correct.
- Report Name ... for ... not found: The specified report name or date does not match any available reports. Double-check spelling and date format.
- Ensure the API credentials have sufficient permissions and are correctly configured.
- Network errors or authorization failures may occur if the JWT token is invalid or expired; ensure system time is accurate and credentials are valid.