📜  如何获取苹果销售报告 https: api.appstoreconnect.apple.com v1 salesReports (1)

📅  最后修改于: 2023-12-03 15:24:54.048000             🧑  作者: Mango

获取苹果销售报告

苹果销售报告可以帮助我们了解应用程序在苹果商店的销售表现,为我们掌握应用程序的市场表现提供帮助。以下是获取苹果销售报告的方法:

1. 获取 API 密钥

首先,需要使用自己的 Apple ID 登录 App Store Connect,转到 我的账号 > API 密钥,来生成一个 API 密钥。点击 新建 API 密钥,选择要创建的 API 密钥的所需权限,然后下载密钥。

2. 使用 API 密钥进行身份验证

在获取苹果销售报告之前,我们需要使用在第一步中创建的 API 密钥进行身份验证。我们需要使用以下请求获取访问令牌:

POST https://appleid.apple.com/auth/oauth2/token

请确保请求中的以下参数都正确填写:

{
    "grant_type": "client_credentials",
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET",
    "scope": "appstoreconnect:analytics"
}

其中,YOUR_CLIENT_IDYOUR_CLIENT_SECRET 为在第一步中创建的 API 密钥的相关信息。返回结果应该包含了访问令牌。将此访问令牌用于后续的API调用。

3. 获取销售报告

最终步骤是通过以下请求获取销售报告:

GET https://api.appstoreconnect.apple.com/v1/salesReports

需要确保在请求中包含访问令牌:

{
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
}

还需要确保在请求中包含以下参数,用于定义销售报告的日期范围:

{
    "filter[reportType]": "SALES",
    "filter[reportSubType]": "SUMMARY",
    "filter[granularity]": "DAY",
    "filter[adamId]": "YOUR_ADAM_ID",
    "filter[vendorNumber]": "YOUR_VENDOR_NUMBER",
    "filter[reportDate]": {
        "gte": "2021-01-01",
        "lte": "2021-10-31"
    }
}

其中,YOUR_ADAM_IDYOUR_VENDOR_NUMBER 都可以在AppStore Connect中查看相应应用的基本信息,reportDate 中的 gtelte 分别为你想要的起始和结束日期。

注意:如果你的销售报告中没有数据,则你需要等待至少一到两天,使苹果能够为你的应用生成销售报告。

返回的报告将包含在请求的响应体中。根据需要,可以使用JSON解析程序或其他方法处理结果。

以上就是获取苹果销售报告的全部步骤。请确保在进行API调用时不会超出信用额度并遵守Apple的API条款。