Music Analytics API 是什么?

Music Analytics API 是一个灵活的查询工具,它可以通过端点内的 GET 和 POST 请求,生成听众数量和播放次数的匿名汇总数据,且支持按多种维度查看数据。如需了解更多信息,请参阅《Music Analytics API 指南》(英文)

谁可以使用 Music Analytics API?

每月播放量超过 250,000 次的唱片公司可以使用本工具。如果您的唱片公司每月播放量已超过 250,000 次,但您在 iTunes Connect 的“用户和访问”中没有看到“密钥”功能,请联系我们

我应该给谁开通 Music Analytics API 访问权限?

Music Analytics API 是一项技术工具。我们建议由您组织中了解脚本、能够编写 JSON 查询的用户访问该工具。

用户丢失了私钥文件,怎么办?

如果用户丢失了私钥文件,您需要在 iTunes Connect 中撤销对应的密钥,并为该用户生成新的密钥。

  1. 前往“用户和访问”。
  2. 点按“密钥”。
  3. 选择密钥,然后点按“撤销”。
  4. 页面将提示您确认操作。点按“撤销”,然后为该用户重新生成密钥。

撤销后,密钥将从“有效”列表中移除,并出现在“已撤销”列表中。

注:已撤销的密钥仅显示 30 天。

用户的 Music Analytics API 访问权限被撤销后,他们对 iTunes Connect 或“销售和趋势”的访问权限会受影响吗?

不会。iTunes Connect 新增的“密钥”功能只针对 Music Analytics API,因此“密钥”中的操作不会影响其他功能的访问权限。

访问令牌的有效期是多长时间?

访问令牌的有效期为 20 分钟。如需长时间使用令牌,我们建议您每 18 分钟刷新一次令牌,并使用更新后的令牌,以便流畅操作。

Music Analytics API 如何保护听众的隐私?

数据须达到最低门槛,由 Apple 托管的服务才会返回听众数量和播放次数的计数。返回的数据也会向上取整,以 50 为界——小于等于 50 进为 50,大于 50 进为 100(例如,127,987 将显示为 128,000)。在保护用户隐私的同时提供了足够的信息。

我可以访问哪些数据?

您需要使用 Issuer ID 来查询内容。因此,您仅能访问您交付给 Apple Music 的内容。

Music Analytics API 使用哪种数据格式?

所有调用和响应均使用 JavaScript 对象表示法(缩写为 JSON)格式。

有速率限制吗?

目前没有速率限制,但将来可能会限速。请注意,当您进行查询时,您组织中其他用户的查询速率可能会受到影响。另外,系统对每次可查询的内容量有所限制:每次最多可查询 100 个歌曲 ID/10 个专辑 ID/5 个艺人 ID。

最早可供查询的日期是哪一天?

最早查询日期为您的内容在 Apple Music 上架的日期。通常来说,最早日期是 Apple Music 面世的日期,即2015年6月30日。

查询的时间段可以精确到什么程度?

查询的时间段最小可以精确到天。数据默认为 UTC 时间格式,您也可以修改为其他时区(如 EST、CST 或 PST)。返回数据将根据您所选的时区显示。

多个 ID 的数据可否显示为一个条目?

当提供商搜索多个 ID 时,Music Analytics API 默认将各个 ID 的数据整合为单个值返回给用户,不会重复统计和归因。

是否可以对数据进行过滤或分组?

所有端点都支持按不同维度进行过滤和分组。维度的数量不受限制,但请注意两点:

  • 添加过滤或分组条件将需要更多查询时间。
  • 为保护用户隐私,数据量达到最低门槛之前不会显示数据。如果添加更多过滤或分组条件,数据量可能无法满足显示要求。

多个 ID 的数据可否显示为多个条目?

查询多个 ID 的数据时,您可以通过“group_by”设置数据分组条件。系统将查询每个 ID 的数据,然后将数据按设置的“group_by”条件分组显示。

有疑问或需要帮助时应该联系谁?

如果您对访问或使用 Music Analytics API 有任何疑问,请联系我们

工具

下载您交付音乐时需要的工具。

查看工具

找到适合的音乐发行商

如果需要音乐发行商的帮助,您可以在这里找到满意的合作伙伴。

查找合作伙伴

联系我们

如果仍未找到您需要的内容,请联系我们。

联系我们