“销售和趋势”介绍

销售和趋势”提供可视化数据,帮助你了解音乐内容在 Apple Music 和 iTunes Store 中的表现情况。

“销售和趋势”主要分为四部分:

“销售和趋势”报告包含当日所有交易信息,并于次日向你提供数据,以便你了解业务情况。“销售和趋势”中的产品销量和收入仅为估算数据,不应作为最终数据。若要查看你的最终付款信息,请前往“付款和财务报告”。

【注】若要访问“销售和趋势”或下载报告,iTunes Connect 用户必须具有“管理”、“财务”、“法务”或“销售”职能,以确保只有授权用户才能访问贵司的机密信息。如需管理访问权限,请前往“用户和职能”。

概述

关于概述

“概述”页面汇总音乐内容的流媒体活动和销售活动数据,方便你快速查看音乐在 Apple Music 和 iTunes Store 中的表现。

此页面默认显示过去一个月的详细数据,包括流媒体播放总数、总销量、销售总收益和预购总数等。你也可以另选一个结束日期,查看该日期前 30 天的数据。

绿色或红色的百分比显示的是月度变化。例如,如果你选择 5 月 12 日作为结束日期,系统将对比 4 月 13 日到 5 月 12 日的流媒体播放总量和 3 月 13 日到 4 月 12日的流媒体播放总量,并显示百分比变化。

概述

对比销量和流媒体等效值

“流媒体等效值”将流媒体播放量换算为销量,方便你直接对比内容在 Apple Music 和 iTunes Store 中的表现。

换算时,125 流媒体播放量视为 1 销量。将鼠标悬停在图表上即可查看每日销量和流媒体等效值。

对比销量和流媒体等效值

查看流媒体歌曲排行

内容在 Apple Music 上发布七天后,你便可以查看每周数据,了解订阅者如何发现你的音乐以及相关的收听活动。流媒体歌曲排行提供的数据包括:

  • 歌曲流媒体总数:歌曲在 Apple Music 中的总播放次数。

  • 资料库流媒体:订阅者从资料库播放歌曲的次数占总播放次数的百分比。

  • 发现流媒体:用户从“为你推荐”、“浏览”和“广播”播放歌曲的次数占总播放次数的百分比。

  • 销量:歌曲在 iTunes Store 中的销售数量。

  • 销售收益:歌曲在 iTunes Store 中销售额。不包括流媒体内容的版税金额。

系统默认显示过去七天的数据。若要查看更早的数据,请另选一个结束日期。

流媒体歌曲排行

“资料库”、“发现”和“搜索”图表按播放来源显示播放数据。将鼠标悬停在各个图表上即可查看相应来源的每日流媒体播放次数。

“资料库”、“发现”、“搜索”流媒体图表

查看播放列表排行

如果编辑精选歌单或音乐向导歌单收录了你的音乐,你可以查看以下数据:

  • 歌曲流媒体总数:你的歌曲在该播放列表中的流化次数。如果一个播放列表中包含你的多首歌曲,则此处显示所有被收录歌曲的总流化次数。

  • 前 7 天:本周发生的流媒体总数和之前七天发生的流媒体总数的百分比差额。

  • 完成率:播放列表中你的流媒体整首播放完毕的平均百分比。

播放列表排行详细信息

页面默认显示过去七天的数据。若要查看更早的数据,请选择自定义结束日期。

【注】此页面的衡量指标仅包括你的歌曲流媒体量。对于你没有交付至 Apple 的歌曲,“销售和趋势”和你的报告中不会显示相关信息。

按照地区或艺人衡量

在“概述”页上,你可以按照“地区”和/或“艺人”来查看销售额和流媒体总数。

  1. 在 iTunes Connect 首页上,点按“销售和趋势”。

  2. 请在左侧选择“概述”。

  3. 在右上角选择日期。图中的数据将根据所选结束日期而改变。

  4. 点按页面左上方的“添加过滤器”,按照“地区”或“艺人”过滤。

流媒体量和销售额

查看流媒体量

可通过过滤器和自定日期范围来衡量并分析 Apple Music 上的流媒体量。请注意,“销售和趋势”中显示的数字仅为近似值,不应作为精确的版税付费计数。Apple Music 流媒体的最终收入可在“付款和财务报告”中查看和下载。

更新的容器子类型截屏

系统将默认显示过去七天的数据。如需查看更大的日期范围或早于过去七天的数据,请点按右上角的日历。

图表下方将显示以下详细信息:

  • 内容类型:此项用于表明该内容是歌曲还是音乐视频。

  • ID:这首歌曲的 Apple ID,也会显示在“我的音乐”中的专辑页。

  • 流媒体量:Apple Music 上的流媒体总数量,包括 Apple Music 广播上的播放量。

  • 前一个范围:表示此前日期范围和当前日期范围流媒体量的变化。

添加过滤器:根据内容类型、会员类型和歌单/广播等特定分析维度,查看更具针对性的数据。你可以添加多个分析维度,以查看更加细化的数据。

【注】数据每 8 小时刷新和更新一次。

查看销售额

衡量你在 iTunes Store 中随时间推移的产品销量、收入和预购量变化。默认状态下,预购量指净预购量,即预购总数减去取消数。百分比表示此前日期范围和当前日期范围产品销量的变化。

销售 Dashboard

系统将默认显示过去七天的数据。如需查看更大的日期范围或早于过去七天的数据,请点按右上角的日历。

在图表下方,你将看到以下预购状态的信息:

  • 预购:已选日期范围内的顾客预购总数减去取消数。

  • 已订购:已选日期范围内,已下单但尚未交付的预购总数。

  • 已交付:接受付款后已立即交付订单,并已向顾客提供歌曲下载链接。

  • 已取消:已选日期范围内,顾客已取消的预购总数。

  • 未完成:尚未交付或取消的预购,可能因为未到销售开始日期。

添加过滤器:根据内容类型、会员类型和歌单/广播等特定分析维度,查看更具针对性的数据。你可以添加多个分析维度,以查看更加细化的数据。

【注】数据每 8 小时刷新和更新一次。

创建存储的视图

你可以存储当前选择的日期范围、群组和过滤器选项。后续查看时,可在左侧“已存储”菜单下选择存储的视图快速浏览数据。

  1. 请选择左侧“已存储”菜单旁的 +。

    添加过滤器
  2. 为存储的视图命名并点按“存储”。

    为存储的视图命名
  3. 在左侧的“已存储”部分进行选择,可随时返回至存储的视图。

    为存储的视图命名

创建自定义地区群组

你可以创建根据已选地区过滤内容的自定义地区群组。

  1. 点按“添加过滤器”并选择“地区”。

    自定义地区 1
  2. 选择“建立自定义地区群组”。

    自定义地区 2
  3. 点按“+”图标,并为你的“自定义地区群组”输入名称。勾选国家/地区左侧的框,选择相关国家或地区,并点按“存储”。

    自定义地区(国家/地区)
  4. 若要使用“自定义地区群组”,请点按“添加过滤器”并选择“地区”。新增的“自定义地区群组”会显示在“我的群组”部分。

    我的群组

导出数据

你可以下载图表中显示的数据,以便在“销售和趋势”网站外使用。

如需存储图表数据:

  1. 点按位于图表右上角、数据表上方的“下载”按钮。

  2. 选择下载格式。可按 CSV 或 Excel 格式下载数据,也可以将其导出到电脑的剪贴板。

    导出报告

报告

关于报告

类型

Apple Music 报告

Apple Music 每日报告发布时间:一天/24 小时后的 08:00 PST(UTC-8)。

以下各类报告提供关于收听者活动和人口统计信息的数据。至少有一个内容达到版权付费门槛的音乐提供商可获取以下报告:

Shazam 报告

Shazam 每日报告发布时间:次日 06:00 PST(UTC-8)。

若音乐提供商至少有一首歌曲被 Shazam 识别,则可获取以下报告:

  • Shazam 每日报告:关于 Shazam 的汇总数据,包括日期、艺人、名称、城市以及国家或地区。

销售报告

每日销售报告发布时间:次日 06:00 PST(UTC-8)。

销量至少为 1 或拥有至少一个版税付费流媒体的音乐提供商可获取以下报告:

  • 详细预购报告:关于预购活动的交易级别数据,包括关于已订购、已取消及已交付订单的详细信息。

  • 详细销售报告:销售和下载的交易级别数据。

  • 预购总报告:关于预购活动的汇总数据,包括关于已订购、已取消及已交付订单的详细信息。

  • 销售总报告:关于你在 iTunes 下载商店中内容的销售及下载的汇总数据。

  • 内容人口统计报告:关于顾客年龄、性别的汇总数据,按内容(如歌曲的 Apple 标识符)分组。

  • 艺人人口统计报告:关于顾客年龄和性别的汇总数据,按艺人分组。

时区:报告采用太平洋标准时间(PST)。有关每周报告、每月报告和年度报告获取时间的详细信息,请参见可用性

另请参阅下载报告

可用性

  • 每日报告可于次日获取。

  • 每周报告可在每周一获取。

    例外:Apple Music 和 iTunes 的人口统计报告在每周五获取。

  • 每月报告可在该月最后一天的五天后获取。

  • 年度报告可在该年最后一天的六天后获取。此类报告保留十年。

【注】每日报告、每周报告和每月报告在就绪后保留一年。到期后,系统不再存储或重新生成报告供下载。

报告的时间期限采用以下定义:

术语

定义

从 12:00:00 AM 开始到 11:59:59 PM 结束,以当地时区为准。

从周一 12:00:00 AM 开始到周日 11:59:59 PM 结束,以当地时区为准。

例外:Apple Music 和 iTunes 的人口统计报告从周五 12:00:00 AM 开始至下周四 11:59:59 PM 结束,以当地时区为准。

从该月第一天 12:00:00 AM 开始到同一月份最后一天 11:59:59 PM 结束,以当地时区为准。

从 1 月 1 日 12:00:00 AM 开始到 12 月 31 日 11:59:59 PM 结束,以当地时区为准。

【注】“销售和趋势”报告不基于 Apple 的财务日历。

下载报告

“销售和趋势”报告可从“报告”页面下载。你还可使用命令行工具 Reporter 自动下载报告。

从“销售和趋势”中下载

  1. 在 iTunes Connect 首页上,点按“销售和趋势”。

  2. 在左侧选择“销售和趋势报告”。

  3. 找到要下载的报告。

  4. 选择供应商和日期,或报告时间段。

  5. 点按“下载”。

查看报告

报告为制表符分隔的文本文件,并压缩为 gzip(.gz)格式。若要查看已下载的报告:

  1. 直接打开或借助工具均可将已压缩的 gzip(.gz)文件解压缩。

    在 macOS 中,连按已压缩的 gzip(.gz)文件,将其解压缩。

  2. 在电子表格应用程序中,打开已提取的制表符分隔的文本文件(.txt)。

    在 macOS 中,按住 Control 键并点按制表符分隔的文本文件(.txt),以打开快捷菜单并选择“打开方式”。

    在 Windows 中,点击鼠标右键,打开快捷菜单。

以下报告将被进一步分割为数个文件,且/或压缩为 ZIP(.zip)文件:

  • Apple Music 流媒体总报告

  • Apple Music 控制报告(仅用于 Reporter 下载)

以上报告为制表符分隔的文本(.txt)文件,压缩为 gzip(.gz)格式并打包至单个 .zip 文件中。行数超过 800 万行的文件将被分割为多个文件,然后再进行压缩。文件名称将添加“[X-Z]”后缀,以便了解一份报告中包含的文件数量,其中 X 代表该文件在报告中的序号,Z 代表文件总数。

下载报告

若要查看已下载的报告:

  1. 直接打开或借助工具均可将已压缩的 zip(.zip)文件解压缩。

  2. 直接打开或借助工具均可将已压缩的 gzip(.gz)文件解压缩。

    在 macOS 中,连按已压缩的 gzip(.gz)文件,将其解压缩。

  3. 在电子表格应用程序中,打开已提取的制表符分隔的文本文件(.txt)。

    在 macOS 中,按住 Control 键并点按制表符分隔的文本文件(.txt),以打开快捷菜单并选择“打开方式”。

    在 Windows 中,点击鼠标右键,打开快捷菜单。

Apple Music

Apple Music 内容报告

报告类型:每日

要求:流媒体播放量至少为 1。

此类报告包含你的内容在 Apple Music 上流化情况的汇总信息。

报告字段

类型

备注

Apple Identifier (Apple 标识符)

BigInt

给定内容的唯一 Apple 标识符,例如 2866241444。

ISRC

String

给定内容的 ISRC 或 ISBN,由你在交付内容时提供。

Title (名称)

String

内容名称,由你在交付内容时提供。

Artist (艺人)

String

项目的主要艺人,由你在交付内容时提供。

Artist ID (艺人 ID)

BigInt

给定艺人的 Apple 标识符,与你交付内容时使用的艺人 ID 相匹配。

Item Type (项目类型)

BigInt

表示 iTunes Store 或 Apple Music 内容。可能的值有:

1 = iTunes Store 或 Apple Music 内容

Media Type (媒体类型)

BigInt

项目媒体类型。可能的值包括:

1 = 音乐

2 = 音乐视频

Media Duration (媒体持续时间)

BigInt

内容播放持续时间(用秒表示)。

Vendor Identifier (供应商标识符)

String

你在提交内容时向我们提供的唯一 Vendor ID。

Label/Studio/Network (唱片公司/制片商/有线电视公司)

String

你在交付内容时提供的唱片公司/制片商/有线电视公司信息。

GRid

String

你在交付内容时提供的全球发布标识符。

Secondary ISRC (次要 ISRC)

String

与单个 Apple 标识符相关联的次要 ISRC,由你在交付内容时提供。

Apple Music 流媒体总报告

报告类型:每日

要求:流媒体播放量至少为 1。

此类报告汇总以下信息:收听者的订阅类型、活动(如播放或跳过)及活动发生的大致时间等。播放超过 30 秒(版税付费门槛)的流媒体数据才会计入报告。

报告字段

类型

备注

Datestamp (日期戳)

Date

活动在设备上发生时(当地时间)的日期戳(格式 YYYY-MM-DD)。

Ingest Datestamp (Ingest 日期戳)

Date

活动报告给 Apple 的日期戳(格式 YYYY-MM-DD)。

Apple Identifier (Apple 标识符)

BigInt

给定内容的唯一 Apple 标识符。它与 Apple Music 趋势内容报告中使用的 Apple ID 相匹配。

Storefront Name (店面名称)

String

双字符的 ISO 国家或地区代码,用于代指发生活动的 iTunes 地区,例如“US”。

Time Bucket (时间段)

BigInt

操作发生时的当地时间段。可能的值包括:

1 = 00:00 到 02:59 之间

2 = 03:00 到 05:59 之间

3 = 06:00 到 08:59 之间

4 = 09:00 到 11:59 之间

5 = 12:00 到 14:59 之间

6 = 15:00 到 17:59 之间

7 = 18:00 到 20:59 之间

8 = 21:00 到 23:59 之间

* 自 2016 年 4 月 8 日起,时间段显示用户的当地时间,而非协调世界时(UTC)。

Subscription Type (订阅类型)

String

播放内容时,收听者的订阅类型(例如,个人月度订阅或家庭月度订阅)。

Subscription Mode (订阅模式)

String

播放内容时,收听者的订阅状态(例如,付费或试用)。

Channel Partner (渠道合作伙伴)

String

提供会员的第三方合作伙伴(例如,Telstra、EE、DT)。

Device Type (设备类型)

Int

发生活动的设备类型。可能的值包括:

0 = 其他

1 = 移动设备(例如 iPhone、iPad 或 iPod touch)

2 = 台式电脑(例如 iMac 或 MacBook Air)

3 = 语音(例如 HomePod 或 Amazon Echo)

Source of Stream (流媒体来源)

Int

表明从 App 中发起播放的途径。可能的值包括:

0 = 其他

1 = 资料库

2 = 搜索

3 = 发现

4 = MusicKit

5 = 外部

6 = 正在播放

7 = 语音

Container Type (容器类型)

Int

发起播放的位置。可能的值包括:

0 = 单独曲目

1 = 广播电台

2 = 播放列表

3 = 专辑

Container Sub-Type (容器子类型)

Int

发起播放的广播电台或播放列表类型。下方列出了可能的值(各个值的释义请参见文末术语表):

0 = 不适用

1 = Private User Playlist

2 = Editorial Playlist

3 = Artist Playlist

4 = Curator Playlist

5 = Seeded by Artist/Song

6 = Format Station

7 = Editorial Station

8 = Personal Mix Playlist

9 = New Music Mix

10 = Favorites Mix

11 = Chill Mix

12 = Get Up! Mix

13 = Friends Mix

14 = Algorithm Station

15 = Replay Mix

16 = Autoplay Station

17 = Charts Playlist

18 = Artist Station

19 = Personal Station

20 = Album

21 = Discovery Station

22 = Love Mood Station

23 = Heartbreak Mood Station

24 = Focus Mood Station

25 = Energy Mood Station

26 = Relax Mood Station

27 = Feeling Good Mood Station

28 = Feeling Blue Mood Station

Container ID (容器 ID)

String

Apple 分配给播放列表和广播电台容器的唯一标识符。如果是用户创建的个人播放列表,或者任何可能识别出用户的播放列表/广播电台,则不会显示容器 ID。如果内容的版税付费流媒体播放量不足 50 次,则报告不会显示容器 ID。

Container Name (容器名称)

String

发起播放的广播电台或播放列表的名称。如果是用户创建的个人播放列表,则不会显示容器名称。如果内容的版税付费流媒体播放量不足 50 次,报告也不会显示容器名称。

End Reason Type (结束原因类型)

Int

指示结束播放的原因。可能的值包括:

0 = 完成(整首曲目已播放完毕)

1 = 跳过(收听者跳过了歌曲)

2 = 其他(播放因其他原因而结束,例如,拖拽内容进度)

3 = 手动更改(收听者手动更改了歌曲)

4 = 暂停(播放已暂停或中断)

Offline (离线)

BigInt

表明播放发生时设备处于离线状态(例如,缓存流媒体)。可能的值包括:

0 = 在线

1 = 离线

Audio Format (音频格式)

String

听众播放音乐时选择的音频格式。下方列出了可能的值(各个值的释义请参见文末术语表):

Compressed Audio

Lossless

Immersive

Streams (流媒体量)

BigInt

达到版税付费门槛的流媒体播放次数。

Apple Music 容器总报告

报告类型:每日

要求:对于报告中的每一行,来自播放列表或广播电台的播放量至少需要达到 5 次,才会显示数据。

此类报告汇总了你的内容在播放列表和广播电台中的播放数据。

报告字段

类型

备注

Ingest Datestamp (Ingest 日期戳)

Date

活动报告给 Apple 的日期戳(格式 YYYY-MM-DD)。

Storefront Name (店面名称)

String

双字符的 ISO 国家或地区代码,用于代指发生活动的地区,例如“US”。

Apple Identifier (Apple 标识符)

BigInt

歌曲的唯一 Apple 标识符。

Container Type (容器类型)

Int

发起播放的位置。可能的值包括:

0 = 单独曲目

1 = 广播电台

2 = 播放列表

3 = 专辑

Container Sub-Type (容器子类型)

Int

发起播放的播放列表或广播电台的类型,进一步细化播放来源。下方列出了可能的值(各个值的释义请参见文末术语表):

2 = Editorial Playlist

3 = Artist Playlist

4 = Curator Playlist

5 = Seeded by Artist/Song

6 = Format Station

7 = Editorial Station

17 = Charts Playlist

21 = Discovery Station

22 = Love Mood Station

23 = Heartbreak Mood Station

24 = Focus Mood Station

25 = Energy Mood Station

26 = Relax Mood Station

27 = Feeling Good Mood Station

28 = Feeling Blue Mood Station

Container ID (容器 ID)

String

Apple 分配给播放列表和广播电台容器的唯一标识符。如果是用户创建的个人播放列表,则不会显示容器 ID。

Container Name (容器名称)

String

发起播放的播放列表或广播电台的名称,与用户在 Apple Music 中看到的名称一致。如果是用户创建的个人播放列表,则不会显示容器名称。

Streams (流媒体量)

BigInt

达到版税付费门槛的流媒体播放次数。

Apple Music 内容人口统计报告

报告类型:每日

要求:对于报告中的每一行,至少需要五位独立收听者曾流化此内容,才会显示数据。

此类报告包含关于收听者会员类型、年龄和性别的汇总信息。

报告字段

类型

备注

Report Date (报告日期)

String

报告的报告日期(格式 YYYY-MM-DD)。

Apple Identifier (Apple 标识符)

BigInt

给定内容的唯一 Apple 标识符。它与 Apple Music 趋势内容报告中使用的 Apple ID 相匹配。

Storefront Name (店面名称)

String

双字符的 ISO 国家或地区代码,用于代指发生活动的 iTunes 地区,例如“US”。

Subscription Type (订阅类型)

String

播放内容时,收听者的订阅类型(例如,个人月度订阅或家庭月度订阅)。

Subscription Mode (订阅模式)

String

播放内容时,收听者的订阅状态(例如,付费或试用)。

Action Type (操作类型)

BigInt

正在发生的操作或活动(例如,1 表明该曲目已播放)。可能的值包括:

1 = 播放

Gender (性别)

Int

指示收听者的性别。可能的值包括:

0 = 未知数据

1 = 男性

2 = 女性

Age Band (年龄段)

String

收听者所属的年龄段。可能的值包括:

  • 18-24

  • 25-34

  • 35-44

  • 45-54

  • 55-64

  • 65+

  • Data Unknown(未知数据)

Audio Format (音频格式)

String

听众播放音乐时选择的音频格式。下方列出了可能的值(各个值的释义请参见文末术语表):

  • Compressed Audio

  • Lossless

  • Immersive

Listeners (听众数)

BigInt

听众的不重复计数。

Streams (流媒体量)

BigInt

达到版税付费门槛的流媒体播放次数。

Listeners Last 7 Days (过去 7 天的听众数)

BigInt

过去 7 天的听众数量(不重复计数)。基于每日统计的听众数量。

Streams Last 7 Days (过去 7 天的流媒体量)

BigInt

在过去 7 天中,达到版税付费门槛的流媒体播放次数。基于每日统计的流媒体量。

报告类型:每周、每月

要求:对于报告中的每一行,至少需要五位独立收听者曾流化此内容,才会显示数据。此类报告包含关于收听者会员类型、年龄和性别的汇总信息。

每周报告时间范围:从周五 12:00:00 AM 开始到下周四 11:59:59 PM 结束,以当地时区为准。

每月报告时间范围:从本月第一天 12:00:00 AM 开始到本月最后一天 11:59:59 PM 结束,以当地时区为准。

报告字段

类型

备注

Start Date (开始日期)

Date

本报告日期范围的起始日期。

End Date (结束日期)

Date

本报告日期范围的结束日期。

Apple Identifier (Apple 标识符)

BigInt

给定内容的唯一 Apple 标识符。它与 Apple Music 趋势内容报告中使用的 Apple ID 相匹配。

Storefront Name (店面名称)

String

双字符的 ISO 国家或地区代码,用于代指发生活动的 iTunes 地区,例如“US”。

Subscription Type (订阅类型)

String

播放内容时,收听者的订阅类型(例如,个人月度订阅或家庭月度订阅)。

Subscription Mode (订阅模式)

String

播放内容时,收听者的订阅状态(例如,付费或试用)。

Action Type (操作类型)

BigInt

正在发生的操作或活动(例如,1 表明该曲目已播放)。可能的值包括:

1 = 播放

Gender (性别)

Int

指示收听者的性别。可能的值包括:

0 = 未知数据

1 = 男性

2 = 女性

Age Band (年龄段)

String

收听者所属的年龄段。可能的值包括:

  • 18-24

  • 25-34

  • 35-44

  • 45-54

  • 55-64

  • 65+

  • Data Unknown(未知数据)

Audio Format (音频格式)

String

听众播放音乐时选择的音频格式。下方列出了可能的值(各个值的释义请参见文末术语表):

  • Compressed Audio

  • Lossless

  • Immersive

Listeners (听众数)

BigInt

听众的不重复计数。

Streams (流媒体量)

BigInt

达到版税付费门槛的流媒体播放次数。

Apple Music 艺人人口统计报告

报告类型:每日

要求:对于报告中的每一行,至少需要五位独立收听者曾流化此内容,才会显示数据。此类报告包含关于收听者会员类型、年龄和性别的汇总信息。

报告字段

类型

备注

Report Date (报告日期)

String

报告的报告日期(格式 YYYY-MM-DD)。

Artist ID (艺人 ID)

BigInt

给定艺人的 Apple 标识符,与你交付内容时使用的艺人 ID 相匹配。

Storefront Name (店面名称)

String

双字符的 ISO 国家或地区代码,用于代指发生活动的 iTunes 地区,例如“US”。

Subscription Type (订阅类型)

String

播放内容时,收听者的订阅类型(例如,个人月度订阅或家庭月度订阅)。

Subscription Mode (订阅模式)

String

播放内容时,收听者的订阅状态(例如,付费或试用)。

Action Type (操作类型)

BigInt

正在发生的操作或活动(例如,1 表明该曲目已播放)。可能的值包括:

1 = 播放

Gender (性别)

Int

指示收听者的性别。可能的值包括:

0 = 未知数据

1 = 男性

2 = 女性

Age Band (年龄段)

String

收听者所属的年龄段。可能的值包括:

  • 18-24

  • 25-34

  • 35-44

  • 45-54

  • 55-64

  • 65+

  • Data Unknown(未知数据)

Audio Format (音频格式)

String

听众播放音乐时选择的音频格式。下方列出了可能的值(各个值的释义请参见文末术语表):

  • Compressed Audio

  • Lossless

  • Immersive

Listeners (听众数)

BigInt

听众的不重复计数。

Streams (流媒体量)

BigInt

达到版税付费门槛的流媒体播放次数。

Listeners Last 7 Days (过去 7 天的听众数)

BigInt

过去 7 天的听众数量(不重复计数)。基于每日统计的听众数量。

Streams Last 7 Days (过去 7 天的流媒体量)

BigInt

在过去 7 天中,达到版税付费门槛的流媒体播放次数。基于每日统计的流媒体量。

报告类型:每周、每月

要求:对于报告中的每一行,至少需要五位独立收听者曾流化此内容,才会显示数据。此类报告包含关于收听者会员类型、年龄和性别的汇总信息。

每周报告时间范围:从周五 12:00:00 AM 开始到下周四 11:59:59 PM 结束,以当地时区为准。

每月报告时间范围:从本月第一天 12:00:00 AM 开始到本月最后一天 11:59:59 PM 结束,以当地时区为准。

报告字段

类型

备注

Start Date (开始日期)

Date

本报告日期范围的起始日期。

End Date (结束日期)

Date

本报告日期范围的结束日期。

Artist ID (艺人 ID)

BigInt

给定艺人的 Apple 标识符,与你交付内容时使用的艺人 ID 相匹配。

Storefront Name (店面名称)

String

双字符的 ISO 国家或地区代码,用于代指发生活动的 iTunes 地区,例如“US”。

Subscription Type (订阅类型)

String

播放内容时,收听者的订阅类型(例如,个人月度订阅或家庭月度订阅)。

Subscription Mode (订阅模式)

String

播放内容时,收听者的订阅状态(例如,付费或试用)。

Action Type (操作类型)

BigInt

正在发生的操作或活动(例如,1 表明该曲目已播放)。可能的值包括:

1 = 播放

Gender (性别)

Int

指示收听者的性别。可能的值包括:

0 = 未知数据

1 = 男性

2 = 女性

Age Band (年龄段)

String

收听者所属的年龄段。可能的值包括:

  • 18-24

  • 25-34

  • 35-44

  • 45-54

  • 55-64

  • 65+

  • Data Unknown(未知数据)

Audio Format (音频格式)

String

听众播放音乐时选择的音频格式。下方列出了可能的值(各个值的释义请参见文末术语表):

  • Compressed Audio

  • Lossless

  • Immersive

Listeners (听众数)

BigInt

听众的不重复计数。

Streams (流媒体量)

BigInt

达到版税付费门槛的流媒体播放次数。

Apple Music 资料库活动报告

报告类型:每日

要求:对于报告中的每一行,至少需要五位独立订阅者已将该内容添加至其资料库,才会显示数据。此类报告包含你的提前收藏和已发布内容被订阅者添加或移除的汇总数量。

报告字段

类型

备注

Datestamp (日期戳)

Date

活动发生时的日期戳(格式 YYYY-MM-DD)。

Storefront Name (店面名称)

String

双字符的 ISO 国家或地区代码,用于指示活动发生的 iTunes 地区,例如 US。

Apple Identifier (Apple 标识符)

BigInt

歌曲、专辑或音乐视频的唯一 Apple 标识符。

Title (名称)

String

内容名称,由你在交付内容时提供。

Artist (艺人)

String

项目的主要艺人,由你在交付内容时提供。

Artist ID (艺人 ID)

String

给定艺人的 Apple 标识符,与你交付内容时使用的艺人 ID 相匹配。

Media Type (媒体类型)

BigInt

活动涉及的产品类型。可能的值包括:

1 = 歌曲

2 = 音乐视频

3 = 专辑

Action Type (操作类型)

BigInt

正在发生的操作或活动。可能的值包括:

3 = 添加至资料库

4 = 从资料库移除

5 = 提前收藏至资料库

6 = 将提前收藏内容从资料库移除

Events (活动)

Int

活动数量。每行至少需要有 5 位独立用户才会显示数据。

Apple Music 资料库总添加报告

报告类型:每日

要求:对于报告中的每一行,至少需要五位独立订阅者已将该内容添加至其资料库,才会显示数据。此类报告包含你的提前收藏和已发布内容被订阅者添加至资料库的净总量。

报告字段

类型

备注

Datestamp (日期戳)

Date

活动发生时的日期戳(格式 YYYY-MM-DD)。

Apple Identifier (Apple 标识符)

BigInt

歌曲、专辑或音乐视频的唯一 Apple 标识符。

Title (名称)

String

内容名称,由你在交付内容时提供。

Artist (艺人)

String

项目的主要艺人,由你在交付内容时提供。

Artist ID (艺人 ID)

String

给定艺人的 Apple 标识符,与你交付内容时使用的艺人 ID 相匹配。

Media Type (媒体类型)

BigInt

活动涉及的产品类型。可能的值包括:

1 = 歌曲

2 = 音乐视频

3 = 专辑

Action Type (操作类型)

BigInt

正在发生的操作或活动。可能的值包括:

3 = 添加至资料库

5 = 提前收藏至资料库

Total Adds (总添加数量)

Int

提前收藏或添加至资料库的净累计数量(添加数量减去移除数量)。每行至少需要有 5 位独立用户才会显示数据。

Apple Music 编辑精选歌单添加报告

报告类型:每日

要求:Apple Music 编辑精选歌单至少添加、移除或更新了一首你的歌曲。

此类报告包含 Apple Music 编辑精选歌单中更新的歌曲或音乐视频的相关数据。曲目位置仅在操作类型为添加(7)或更新(9)时才会在报告中显示。

报告字段

数据类型

描述

Datestamp (日期戳)

Date

活动发生时的日期戳(格式 YYYY-MM-DD)。

Storefront Name (店面名称)

String

双字符的 ISO 国家或地区代码,用于指示活动发生的 iTunes 地区,例如 US。

Apple Identifier (Apple 标识符)

BigInt

歌曲的唯一 Apple 标识符。

Title (名称)

String

内容名称,由你在交付内容时提供。

Artist (艺人)

String

项目的主要艺人,由你在交付内容时提供。

Artist ID (艺人 ID)

String

给定艺人的 Apple 标识符,与你交付内容时使用的艺人 ID 相匹配。

Media Type (媒体类型)

BigInt

活动涉及的产品类型。可能的值包括:

1 = 歌曲

2 = 音乐视频

Action Type (操作类型)

BigInt

正在发生的操作或活动。可能的值包括:

7 = 添加至歌单

8 = 从歌单移除

9 = 更新在歌单中的位置

Playlist ID (歌单 ID)

String

Apple 分配给歌单的唯一标识符。

Playlist Name (歌单名称)

String

内容所在歌单的名称,即会员在 Apple Music 中看到的歌单名称。

Track Position (曲目位置)

BigInt

歌曲当前在歌单中的位置。

Apple Music 控制报告

此类报告包括其他各份 Apple Music 报告的 MD5 哈希值,可用于确保报告中的数据在下载过程中没有损坏。Apple Music 每日控制报告仅在使用 Reporter 下载时可用。

报告字段

类型

备注

File Name (文件名)

String

已下载的 Apple Music 报告名称,例如 AppleMusic_Detail_80012345_20150715_part1.txt

MD5 Hash Value (MD5 哈希值)

String

计算相应报告的哈希值。

Shazam 报告

报告类型:每日

要求:对于报告中的每一行,至少需要五位独立 Shazam 用户,才会显示数据。

此类报告汇总了经 Shazam 识别的歌曲及相关信息。其中 Shazam 识别次数还将按照四个地理级别提供统计数据:城市、省/自治区/直辖市、国家或地区、全球。统计数据会精确到最小地理级别,如果最小级别未达到数据显示门槛(识别次数至少 5 次),则计入上一级。

报告字段

类型

备注

Ingest Datestamp (Ingest 日期戳)

Date

活动报告给 Apple 的日期戳(格式 YYYY-MM-DD)。

Ingest Hour (Ingest 时段)

Int

操作发生时的当地时间段。可能的值包括:

0 = 00:00 AM 至 00:59 AM 1 = 01:00 AM 至 01:59 AM 2 = 02:00 AM 至 02:59 AM 3 = 03:00 AM 至 03:59 AM 4 = 04:00 AM 至 04:59 AM 5 = 05:00 AM 至 05:59 AM 6 = 06:00 AM 至 06:59 AM 7 = 07:00 AM 至 07:59 AM 8 = 08:00 AM 至 08:59 AM 9 = 09:00 AM 至 09:59 AM 10 = 10:00 AM 至 10:59 AM 11 = 11:00 AM 至 11:59 AM 12 = 12:00 PM 至 12:59 PM 13 = 01:00 PM 至 01:59 PM 14 = 02:00 PM 至 02:59 PM 15 = 03:00 PM 至 03:59 PM 16 = 04:00 PM 至 04:59 PM 17 = 05:00 PM 至 05:59 PM 18 = 06:00 PM 至 06:59 PM 19 = 07:00 PM 至 07:59 PM 20 = 08:00 PM 至 08:59 PM 21 = 09:00 PM 至 09:59 PM 22 = 10:00 PM 至 10:59 PM 23 = 11:00 PM 至 11:59 PM 24 = 全天 24 小时 * 时段显示顾客的当地时间,而非协调世界时(UTC)。

Title (名称)

String

歌曲的名称。

Artist (艺人)

String

歌曲的艺人。

Country (国家或地区)

String

发生 Shazam 识别的国家或地区,用双字符的 ISO 国家或地区代码表示。

State Province (省/自治区/直辖市)

String

发生 Shazam 识别的省/自治区/直辖市。

City (城市)

String

发生 Shazam 识别的城市或都市圈。

ISRC

String

Shazam 识别出的歌曲的 ISRC 列表,以逗号分隔。

Shazams (Shazam 识别次数)

BigInt

歌曲被 Shazam 识别的总次数。

销售

销售总报告

报告类型:每日、每周、每月和每年

要求:销量至少为 1。

【提示】为了更好地理解以下值,请查看销售总报告示例

报告字段

类型

备注

Provider (提供商)

String

报告中的服务提供商(通常为 Apple)。

Provider Country (提供商所在国家或地区)

String

服务提供商所在国家或地区代码(通常为 US)。

Vendor Identifier (供应商标识符)

String

你在提交内容时向我们提供的唯一 Vendor ID。

UPC

String

你在交付内容时向我们提供的用于识别的通用产品代码。

ISRC

String

你在交付内容时向我们提供的 ISRC 识别编码。

Artist / Show (艺人/节目)

String

该项目的主要艺人或节目名称,由你在交付内容时提供。

Title (名称)

String

内容名称,由你在交付内容时提供。

Label/Studio/Network (唱片公司/制片商/有线电视公司)

String

你在交付内容时提供的唱片公司/制片商/有线电视公司信息。

Product Type Identifier (产品类型标识符)

String

定义产品类型。有关更多信息,请参见产品类型标识符

Units (产品销量)

Decimal

产品累积销量。

Royalty Price (版税价格)

Decimal

内容的版税价格。

Begin Date (开始日期)

Date

销售总日期范围的起始日期。

End Date (结束日期)

Date

销售总日期范围的结束日期。

Customer Currency (顾客货币)

String

三个字符的 ISO 代码,用于指示顾客使用的货币。有关更多信息,请参见货币代码

Country Code (国家或地区代码)

String

双字符的 ISO 国家或地区代码,用于指示购买行为发生的 iTunes Store 或 Apple Music 地区。有关更多信息,请参见国家或地区代码

Royalty Currency (版税货币)

String

三个字符的 ISO 代码,用于指示版税货币。有关更多信息,请参见“货币代码”。

PreOrder (预购)

String

指示交易是否为预购。如果不是预购,则该字段为空。

可能的值包括:

P = 预购

ISAN

String

你在交付内容时向我们提供的 ISAN 识别编码。

Apple Identifier (Apple 标识符)

BigInt

给定内容的唯一 Apple 标识符。

Customer Price (顾客价格)

Decimal

iTunes Store 上显示的价格。

CMA

String

CMA 销售的字段中标有 CMA。免费歌曲积分(song credits)标有 CMA-C。销售和退款字段标有 R。

Asset/Content Flavor (素材/内容风格)

String

仅适用于电视节目内容。高清内容标有 HD。标清内容标有 SD 或为空。

Vendor Offer Code (供应商优惠代码)

String

由你在交付内容时提供。

GRid

String

你在交付内容时提供的全球发布标识符。

Promo Code (促销代码)

String

如果交易是促销活动的一部分,则该字段将包含一个值。对所有非促销项目,该字段为空。有关更多信息,请参见促销代码

Parent Identifier (父标识符)

String

如果歌曲或电视剧单集单独销售,而不是作为音乐专辑或电视剧一季销售,该字段将包含你在内容交付期间提供的播放列表的 Vendor ID。如果未提供 Vendor ID,该字段将为空。

如果音乐专辑或整季电视节目的价格不低于各单首歌曲或各单集电视剧集的价格之和,则歌曲或单集将单独销售。“父标识符”字段将包含专辑或整季电视节目的 Vendor ID。

Parent Type ID (父类型 ID)

Int

如果歌曲或电视剧集单独销售,该字段将包含销售类型。值“17”表示歌曲或电视剧集单独销售。如果音乐专辑或整季电视节目的价格不低于各单首歌曲或各单集电视剧集的价格之和,则该歌曲或剧集将单独销售,显示的值将为“1”。

可能的值包括:

1 = 如果组成套装的单独内容总和少于套装,则单独出售

17 = 作为单独购买出售

Primary Genre (主要音乐类型)

String

内容的曲风类型。

另请参阅详细销售报告

详细销售报告

报告类型:每日和每周

要求:销量至少为 1。

报告字段

报告数据类型

备注

Provider (提供商)

String

报告中的服务提供商(通常为 Apple)。

Provider Country (提供商所在国家或地区)

String

服务提供商所在国家或地区代码(通常为 US)。

Vendor Identifier (供应商标识符)

String

你在提交内容时向我们提供的唯一 Vendor ID。

UPC

String

你在交付内容时向我们提供的用于识别的通用产品代码。

ISRC

String

你在交付内容时向我们提供的 ISRC 识别编码。

Artist / Show (艺人/节目)

String

该项目的主要艺人或节目名称,由你在交付内容时提供。

Title (名称)

String

内容名称,由你在交付内容时提供。

Label / Studio / Network (唱片公司/制片商/有线电视公司)

String

你在交付内容时提供的唱片公司/制片商/有线电视公司信息。

Product Type Identifier (产品类型标识符)

String

定义产品类型。有关更多信息,请参见产品类型标识符

Units (产品销量)

Decimal

产品累积销量。

Royalty Price (版税价格)

Decimal

内容的版税价格。

Download Date (下载日期)

Date

顾客下载内容的日期(格式 MM/DD/YY)。

Order ID (订单 ID)

BigInt

用于识别顾客交易的订购号。

State Province (省/自治区/直辖市)

String

交易发生的省/自治区/直辖市。

City (城市)

String

交易发生的城市或都市圈。

Masked User ID (经脱敏处理的用户 ID)

String

经过脱敏处理的非永久标识符,与用户一一对应,每个日历月变更一次。

Report Date (报告日期)

Date

详细销售报告的报告日期。

Sale / Return (销售/退款)

String

指示交易为销售还是退款。

可能的值包括:

S = 销售

R = 退款

Customer Currency (顾客货币)

String

三个字符的 ISO 代码,用于表示你所赚收入的货币。有关更多信息,请参见货币代码

Country Code (国家或地区代码)

String

双字符的 ISO 国家或地区代码,用于指示购买行为发生的 iTunes Store 或 Apple Music 地区。有关更多信息,请参见国家或地区代码

Royalty Currency (版税货币)

String

三个字符的 ISO 代码,用于指示版税货币。有关更多信息,请参见“货币代码”。

PreOrder (预购)

String

指示交易是否为预购。如果不是预购,则该字段为空。

可能的值包括:

P = 预购

ISAN

String

你在交付内容时向我们提供的 ISAN 识别编码。

Customer Price (顾客价格)

Decimal

iTunes Store 上显示的价格。

Apple Identifier (Apple 标识符)

BigInt

给定内容的唯一 Apple 标识符。

CMA

String

CMA 销售的字段中标有 CMA。免费歌曲积分(song credits)标有 CMA-C。销售和退款字段标有 R。

Asset / Content Flavor (素材/内容风格)

String

仅适用于电视节目内容。高清内容标有 HD。标清内容标有 SD 或为空。

Vendor Offer Code (供应商优惠代码)

String

由你在交付内容时提供。

GRid

String

你在交付内容时提供的全球发布标识符。

Promo Code (促销代码)

String

如果交易是促销活动的一部分,则该字段将包含一个值。对所有非促销项目,该字段为空。有关更多信息,请参见促销代码

Parent Identifier (父标识符)

String

如果歌曲或电视剧单集单独销售,而不是作为音乐专辑或电视剧一季销售,该字段将包含你在内容交付期间提供的播放列表的 Vendor ID。如果未提供 Vendor ID,该字段将为空。

如果音乐专辑或整季电视节目的价格不低于各单首歌曲或各单集电视剧集的价格之和,则歌曲或单集将单独销售。“父标识符”字段将包含专辑或整季电视节目的 Vendor ID。

Parent Type ID (父类型 ID)

Int

如果歌曲或电视剧集单独销售,该字段将包含销售类型。值“17”表示歌曲或电视剧集单独销售。如果音乐专辑或整季电视节目的价格不低于各单首歌曲或各单集电视剧集的价格之和,则该歌曲或剧集将单独销售,显示的值将为“1”。

可能的值包括:

1 = 如果组成套装的单独内容总和少于套装,则单独出售

17 = 作为单独购买出售

Attributable Purchase (可归因购买)

String

指示购买是否归因于相关操作。(该项当前仅适用于自“广播”发起的音乐购买。请参见上面的注释。)

可能的值包括:

RAP = 可归因于“广播”

空白/空 = 无法归因

Primary Genre (主要音乐类型)

String

内容的曲风类型。

另请参阅销售总报告

iTunes 内容人口统计报告

报告类型:每日

要求:对于报告中的每一行,至少需要五位独立顾客曾下载此内容,才会显示数据。

此类报告包含关于顾客年龄和性别的汇总信息,按内容分组。

报告字段

类型

备注

Report Date (报告日期)

Date

销售报告的报告日期。

Country Code (国家或地区代码)

String

双字符的 ISO 国家或地区代码,用于指示购买行为发生的 iTunes Store 或 Apple Music 地区。有关更多信息,请参见“国家或地区代码”。

Apple Identifier (Apple 标识符)

BigInt

给定内容的唯一 Apple 标识符。

Title (名称)

String

你在交付内容时提供的内容名称。

Artist Name (艺人名称)

String

你在交付内容时提供的项目主要艺人。

Artist ID (艺人 ID)

BigInt

给定艺人的 Apple 标识符,与你交付内容时使用的艺人 ID 相匹配。

Label / Studio / Network (唱片公司/制片商/有线电视公司)

String

你在交付内容时提供的唱片公司/制片商/有线电视公司信息。

Product Type Identifier (产品类型标识符)

String

定义产品类型。有关更多信息,请参见产品类型标识符

UPC

String

你在交付内容时提供的用于识别的通用产品代码。

ISRC

String

你在交付内容时提供的 ISRC 识别编码。

ISAN

String

你在交付内容时提供的 ISAN 识别编码。

GRid

String

你在交付内容时提供的全球发布标识符。

Vendor Identifier (供应商标识符)

String

你在交付内容时提供的唯一供应商标识符。

Vendor Offer Code (供应商优惠代码)

String

你在交付内容时提供的唯一供应商优惠代码。

Parent Identifier (父标识符)

String

如果歌曲不是作为音乐专辑,而是单独销售,该字段将包含你在交付内容期间提供的歌曲的 Vendor ID。如果未提供 Vendor ID,则该字段将为空。

如果音乐专辑的价格不低于各单首歌曲的价格总和,则歌曲将单独销售。“父标识符”字段将包含专辑的 Vendor ID。

Gender (性别)

Int

指示收听者的性别。可能的值包括:

0 = 未知数据

1 = 男性

2 = 女性

Age Band (年龄段)

String

收听者所属的年龄段。可能的值包括:

  • 18-24

  • 25-34

  • 35-44

  • 45-54

  • 55-64

  • 65+

  • Data Unknown(未知数据)

Customers (顾客数)

Decimal

下载该内容顾客的不重复记数。

Units (产品销量)

Decimal

产品累积销量。

Customers Last 7 Days (过去 7 天的顾客数量)

Decimal

在过去 7 天中,下载过该内容的顾客数量(不重复记数)。基于每日统计的顾客数量。

Units Last 7 Days (过去 7 天的产品销量)

Decimal

过去 7 天的累积产品销量。基于每日统计的产品销量。

报告类型:每周、每月

要求:对于报告中的每一行,至少需要五位独立顾客曾下载此内容,才会显示数据。此类报告包含关于顾客年龄和性别的汇总信息,按内容分组。

每周报告时间范围:从周五 12:00:00 AM 开始到下周四 11:59:59 PM 结束,以当地时区为准。

每月报告时间范围:从本月第一天 12:00:00 AM 开始到本月最后一天 11:59:59 PM 结束,以当地时区为准。

报告字段

类型

备注

Start Date (开始日期)

Date

本报告日期范围的起始日期。

End Date (结束日期)

Date

本报告日期范围的结束日期。

Country Code (国家或地区代码)

String

双字符的 ISO 国家或地区代码,用于指示购买行为发生的 iTunes Store 或 Apple Music 地区。有关更多信息,请参见“国家或地区代码”。

Apple Identifier (Apple 标识符)

BigInt

给定内容的唯一 Apple 标识符。

Title (名称)

String

你在交付内容时提供的内容名称。

Artist Name (艺人名称)

String

你在交付内容时提供的项目主要艺人。

Artist ID (艺人 ID)

BigInt

给定艺人的 Apple 标识符,与你交付内容时使用的艺人 ID 相匹配。

Label/Studio/Network (唱片公司/制片商/有线电视公司)

String

你在交付内容时提供的唱片公司/制片商/有线电视公司信息。

Product Type Identifier (产品类型标识符)

String

定义产品的类型。有关更多信息,请参见“产品类型标识符”。

UPC

String

你在交付内容时提供的用于识别的通用产品代码。

ISRC

String

你在交付内容时提供的 ISRC 识别编码。

ISAN

String

你在交付内容时提供的 ISAN 识别编码。

GRid

String

你在交付内容时提供的全球发布标识符。

Vendor Identifier (供应商标识符)

String

你在交付内容时提供的唯一供应商标识符。

Vendor Offer Code (供应商优惠代码)

String

你在交付内容时提供的唯一供应商优惠代码。

Parent Identifier (父标识符)

String

如果歌曲不是作为音乐专辑,而是单独销售,该字段将包含你在交付内容期间提供的该歌曲的 Vendor ID。如果未提供 Vendor ID,则该字段将为空。如果音乐专辑的价格不低于各单首歌曲价格的总和,则这些歌曲将单独销售。“父标识符”字段将包含专辑的 Vendor ID。

Gender (性别)

Int

指示收听者的性别。可能的值包括:

0 = 未知数据

1 = 男性

2 = 女性

Age Band (年龄段)

String

收听者所属的年龄段。可能的值包括:

  • 18-24

  • 25-34

  • 35-44

  • 45-54

  • 55-64

  • 65+

  • Data Unknown(未知数据)

Customers (顾客数)

Decimal

下载该内容顾客的不重复记数。

Units (产品销量)

Decimal

产品累积销量。

iTunes 艺人人口统计报告

报告类型:每日

要求:对于报告中的每一行,至少需要五位独立顾客曾下载此内容,才会显示数据。

此类报告包含关于顾客年龄和性别的汇总信息,按艺人分组。

报告字段

类型

备注

Report Date (报告日期)

Date

销售报告的报告日期。

Country Code (国家或地区代码)

String

双字符的 ISO 国家或地区代码,用于指示购买行为发生的 iTunes Store 或 Apple Music 地区。有关更多信息,请参见“国家或地区代码”。

Artist Name (艺人名称)

String

你在交付内容时提供的项目主要艺人。

Artist ID (艺人 ID)

BigInt

给定艺人的 Apple 标识符,与你交付内容时使用的艺人 ID 相匹配。

Label / Studio / Network (唱片公司/制片商/有线电视公司)

String

你在交付内容时提供的唱片公司/制片商/有线电视公司信息。

Gender (性别)

Int

指示收听者的性别。可能的值包括:

0 = 未知数据

1 = 男性

2 = 女性

Age Band (年龄段)

String

收听者所属的年龄段。可能的值包括:

  • 18-24

  • 25-34

  • 35-44

  • 45-54

  • 55-64

  • 65+

  • Data Unknown(未知数据)

Customers (顾客数)

Decimal

下载该内容顾客的不重复记数。

Units (产品销量)

Decimal

产品累积销量。

Customers Last 7 Days (过去 7 天的顾客数量)

Decimal

在过去 7 天中,下载过该内容的顾客数量(不重复记数)。基于每日统计的顾客数量。

Units Last 7 Days (过去 7 天的产品销量)

Decimal

过去 7 天的累积产品销量。基于每日统计的产品销量。

报告类型:每周、每月

要求:对于报告中的每一行,至少需要五位独立顾客曾下载此内容,才会显示数据。此类报告包含关于顾客年龄和性别的汇总信息,按内容分组。

每周报告时间范围:从周五 12:00:00 AM 开始到下周四 11:59:59 PM 结束,以当地时区为准。

每月报告时间范围:从本月第一天 12:00:00 AM 开始到本月最后一天 11:59:59 PM 结束,以当地时区为准。

报告字段

类型

备注

Start Date (开始日期)

Date

销售报告的报告日期。

End Date (结束日期)

Date

销售报告的报告日期。

Country Code (国家或地区代码)

String

双字符的 ISO 国家或地区代码,用于指示购买行为发生的 iTunes Store 或 Apple Music 地区。有关更多信息,请参见“国家或地区代码”。

Artist Name (艺人名称)

String

你在交付内容时提供的项目主要艺人。

Artist ID (艺人 ID)

BigInt

给定艺人的 Apple 标识符,与你交付内容时使用的艺人 ID 相匹配。

Label / Studio / Network (唱片公司/制片商/有线电视公司)

String

你在交付内容时提供的唱片公司/制片商/有线电视公司信息。

Gender (性别)

Int

指示收听者的性别。可能的值包括:

0 = 未知数据

1 = 男性

2 = 女性

Age Band (年龄段)

String

收听者所属的年龄段。可能的值包括:

  • 18-24

  • 25-34

  • 35-44

  • 45-54

  • 55-64

  • 65+

  • Data Unknown(未知数据)

Customers (顾客数)

Decimal

下载该内容顾客的不重复记数。

Units (产品销量)

Decimal

产品累积销量。

预购总报告

报告类型:每日、每周、每月和每年

要求:订购量至少为 1。

【提示】为了更好地理解以下值,请查看报告示例

报告字段

报告数据类型

备注

Provider (提供商)

String

报告中的服务提供商(通常为 Apple)。

Provider Country (提供商所在国家或地区)

String

服务提供商所在国家或地区代码(通常为 US)。

Vendor Identifier (供应商标识符)

String

你在提交内容时向我们提供的唯一 Vendor ID。

UPC

String

你在交付内容时向我们提供的用于识别的通用产品代码。

ISRC

String

你在交付内容时向我们提供的 ISRC 识别编码。

ISAN

String

你在交付内容时向我们提供的 ISAN 识别编码。

Artist/Show (艺人/节目)

String

该项目的主要艺人或节目名称,由你在交付内容时提供。

Title/Episode/Season (名称/集/季)

String

内容名称,由你在交付内容时提供。

Label/Studio/Network (唱片公司/制片商/有线电视公司)

String

你在交付内容时提供的唱片公司/制片商/有线电视公司信息。

Product Type Identifier (产品类型标识符)

String

定义所购产品的类型。有关更多信息,请参见产品类型标识符

PreOrder Start Date (预购开始日期)

Date

预购的开始日期。

PreOrder End Date (预购结束日期)

Date

预购的结束日期。

Ordered (已预购)

BigInt

此期间预购的累计总数。

Canceled (已取消)

BigInt

此期间已取消预购的累积总数。

Fulfilled (已交付)

BigInt

在此期间已交付预购的累积总数。仅当顾客成功结算并下载了购买的内容时,已完成订购才被视为“完成”。

Cumulative Ordered (累积预购)

BigInt

预购的总数。

Cumulative Canceled (累积取消)

BigInt

已取消预购的总数。

Cumulative Fulfilled (累积交付)

BigInt

已交付预购的总数。

Cumulative Open (累积未结)

BigInt

基于累积订购、累积取消和累积交付的未完成预购的总数。

Start Date (开始日期)

Date

预购总日期范围的起始日期。

End Date (结束日期)

Date

预购总日期范围的结束日期。

Country Code (国家或地区代码)

String

双字符的 ISO 国家或地区代码,用于指示购买行为发生的 iTunes Store 或 Apple Music 地区。有关更多信息,请参见国家或地区代码

Apple Identifier (Apple 标识符)

BigInt

给定内容的唯一 Apple 标识符。

PreOrder Apple Identifier (预购 Apple 标识符)

BigInt

预购的 Apple 标识符。

Primary Genre (主要音乐类型)

String

内容的曲风类型。

另请参阅详细预购报告

详细预购报告

报告类型:每日和每周

要求:订购量至少为 1。

报告字段

报告数据类型

备注

Provider (提供商)

至多 100 个字符

报告中的服务提供商(通常为 Apple)。

Provider Country (提供商所在国家或地区)

至多 100 个字符

服务提供商所在国家或地区代码(通常为 US)。

Vendor Identifier (供应商标识符)

至多 20 个字符

你在提交内容时向我们提供的唯一 Vendor ID。

UPC

至多 20 个字符

你在交付内容时向我们提供的用于识别的通用产品代码。

ISRC

至多 50 个字符

你在交付内容时向我们提供的 ISRC 识别编码。

ISAN

至多 50 个字符

你在交付内容时向我们提供的 ISAN 识别编码。

Artist/Show (艺人/节目)

String

该项目的主要艺人或节目名称,由你在交付内容时提供。

Title/Episode/Season (名称/集/季)

String

内容名称,由你在交付内容时提供。

Label/Studio/Network (唱片公司/制片商/有线电视公司)

String

你在交付内容时提供的唱片公司/制片商/有线电视公司信息。

Product Type Identifier (产品类型标识符)

String

定义所购产品的类型。有关更多信息,请参见产品类型标识符

PreOrder Start Date (预购开始日期)

Date

预购的开始日期。

PreOrder End Date (预购结束日期)

Date

预购的结束日期。

Ordered (已预购)

BigInt

此期间预购的累计总数。

Canceled (已取消)

BigInt

此期间已取消预购的累积总数。

Fulfilled (已交付)

BigInt

在此期间已交付预购的累积总数。仅当顾客成功结算并下载了购买的内容时,已完成订购才被视为“完成”。

Cumulative Ordered (累积预购)

BigInt

预购的总数。

Cumulative Canceled (累积取消)

BigInt

已取消预购的总数。

Cumulative Fulfilled (累积交付)

BigInt

已交付预购的总数。

Cumulative Open (累积未结)

BigInt

基于累积订购、累积取消和累积交付的未完成预购的总数。

Start Date (开始日期)

Date

预购报告日期范围的起始日期。

End Date (结束日期)

Date

预购报告日期范围的结束日期。

Country Code (国家或地区代码)

String

双字符的 ISO 国家或地区代码,用于指示购买行为发生的 iTunes Store 或 Apple Music 地区。有关更多信息,请参见国家或地区代码

Apple Identifier (Apple 标识符)

BigInt

给定内容的唯一 Apple 标识符。

PreOrder Apple Identifier (预购 Apple 标识符)

BigInt

预购的 Apple 标识符。

State Province (省/自治区/直辖市)

String

交易发生的省/自治区/直辖市。

City (城市)

String

交易发生的城市或都市圈。

Masked User ID (经脱敏处理的用户 ID)

String

经过脱敏处理的非永久标识符,与用户一一对应,每个日历月变更一次。

Primary Genre (主要音乐类型)

String

内容的曲风类型。

1 Apple 通常不会修改该字段。你在创建内容时提供的信息均包含在报告中。

2 如果你未提供某字段的值,该字段将为空。

另请参阅预购总报告

附录

国家或地区代码

国家或地区代码

国家或地区名称

国家或地区代码

国家或地区名称

国家或地区代码

国家或地区名称

AE

阿拉伯联合酋长国

 

HU

匈牙利

 

NO

挪威

AM

亚美尼亚

 

ID

印度尼西亚

 

NZ

新西兰

AO

安哥拉

 

IE

爱尔兰

 

PA

巴拿马

AR

阿根廷

 

IL

以色列

 

PE

秘鲁

AT

奥地利

 

IN

印度

 

PH

菲律宾

AU

澳大利亚

 

IQ

伊拉克

 

PK

巴基斯坦

BA

波斯尼亚和黑塞哥维那

 

IS

冰岛

 

PL

波兰

BE

比利时

 

IT

意大利

 

PT

葡萄牙

BG

保加利亚

 

JM

牙买加

 

PY

巴拉圭

BJ

贝宁

 

JO

约旦

 

QA

卡塔尔

BR

巴西

 

JP

日本

 

RO

罗马尼亚

BS

巴哈马

 

KE

肯尼亚

 

RS

塞尔维亚

BT

不丹

 

KR

韩国

 

RU

俄罗斯

BW

博茨瓦纳

 

KW

科威特

 

RW

卢旺达

CA

加拿大

 

KZ

哈萨克斯坦

 

SA

沙特阿拉伯

CD

刚果民主共和国

 

LB

黎巴嫩

 

SB

所罗门群岛

CG

刚果共和国

 

LC

圣卢西亚

 

SC

塞舌尔

CH

瑞士

 

LK

斯里兰卡

 

SE

瑞典

CI

科特迪瓦

 

LR

利比里亚

 

SG

新加坡

CL

智利

 

LT

立陶宛

 

SI

斯洛文尼亚

CM

喀麦隆

 

LU

卢森堡

 

SK

斯洛伐克

CN

中国

 

LV

拉脱维亚

 

SL

塞拉利昂

CO

哥伦比亚

 

LY

利比亚

 

SN

塞内加尔

CR

哥斯达黎加

 

MA

摩洛哥

 

SR

苏里南

CZ

捷克共和国

 

MD

摩尔多瓦共和国

 

SV

萨尔瓦多

DE

德国

 

ME

黑山

 

TC

特克斯和凯科斯群岛

DK

丹麦

 

MG

马达加斯加

 

TD

乍得

DO

多米尼加共和国

 

MK

马其顿

 

TH

泰国

DZ

阿尔及利亚

 

ML

马里

 

TN

突尼斯

EC

厄瓜多尔

 

MM

缅甸

 

TO

汤加

EE

爱沙尼亚

 

MO

澳门

 

TR

土耳其

EG

埃及

 

MR

毛里塔尼亚

 

TW

台湾

ES

西班牙

 

MS

蒙特塞拉特岛

 

TZ

坦桑尼亚联合共和国

FI

芬兰

 

MT

马耳他

 

UG

乌干达

FR

法国

 

MU

毛里求斯

 

US

美国

GA

加蓬

 

MV

马尔代夫

 

UY

乌拉圭

GB

英国

 

MW

马拉维

 

VC

圣文森特和格林纳丁斯

GE

格鲁吉亚

 

MX

墨西哥

 

VE

委内瑞拉

GR

希腊

 

MY

马来西亚

 

VN

越南

GT

危地马拉

 

MZ

莫桑比克

 

VU

瓦努阿图

GY

圭亚那

 

NA

纳米比亚

 

XK

科索沃

HK

香港

 

NE

尼日尔

 

YE

也门

HN

洪都拉斯

 

NI

尼加拉瓜

 

ZA

南非

HR

克罗地亚

 

NL

荷兰

 

ZM

赞比亚

货币代码

货币代码

货币名称

AUD

澳大利亚元

BRL

巴西雷亚尔

CAD

加拿大元

CHF

瑞士法郎

DKK

丹麦克朗

EUR

欧元

GBP

英镑

JPY

日元

MXN

墨西哥比索

NOK

挪威克朗

NZD

新西兰元

SEK

瑞典克朗

USD

美元

产品类型标识符

产品类型标识符

类型

类别

描述

S

歌曲

音乐

歌曲,标准(受 DRM 保护)

H

歌曲

音乐

歌曲,附加(无 DRM)

U

歌曲

音乐

歌曲,升级(从 DRM 转换为无 DRM)

P

专辑

音乐

专辑,标准(受 DRM 保护)

I

专辑

音乐

专辑,附加(无 DRM)

W

专辑

音乐

专辑,升级(从 DRM 转换为无 DRM)

V

音乐视频

音乐

音乐视频,标准(受 DRM 保护)

J

音乐视频

音乐

音乐视频,附加(无 DRM)

X

音乐视频

音乐

音乐视频,升级(从 DRM 转换为无 DRM)

R

铃声

音乐

DIY 铃声

PR

铃声

音乐

预剪辑铃声

RX

提示音

音乐

提示音

9

专辑

音乐

音乐套票

E

影片

音乐

音乐会实况影片购买

F

VOD

音乐

音乐会实况影片租借

B

有声读物

有声读物

书籍(仅提供一种格式)

M

影片

影片

电影购买

D

VOD

影片

电影租借

Z

第二阶段会话

影片

数字副本(兑换第二阶段会话)

MB

影片套装

影片

电影套装

TE

剧集

电视节目

电视节目单集购买(资料库)

TS

整季资料库

电视节目

电视节目整季购买(资料库)

SP 或 Q

季票

电视节目

销售当前播出季季票

TER

电视节目租借

电视节目

电视剧集租借

G

游戏

iPod 游戏

游戏销售

促销代码

“促销代码”字段值表明使用的代码类型。报告中每行仅能有一个值。请注意,“null”表示这是标准交易。“促销代码”字段中可以显示以下值。

促销代码

描述

CR - RW

放弃收入的促销代码。顾客价格和收入都将为 0。

CR - RB

未放弃收入的促销代码。顾客价格和收入将大于 0。

FREE

商店中的顾客价格为免费,且版税价格为 0。

GP

礼品购买。

了解产品销量

报告旨在就你的内容在 iTunes Store 上的活动提供相关信息。因此,指定的产品可以有多行信息。对于具有 Apple ID 和 Vendor ID 的每件产品,产品销量信息分为:

  • 店面国家或地区代码

  • 销售和退款

  • 产品类型

  • 价格

  • 促销代码

  • 预购

  • 素材风格

示例

以下示例描述说明产品销量如何在预览和下载的报告中分组和显示。

  • 示例 1:如果你有一种产品正在美国销售,你将看到一行数据,即在美国的销售。该示例未包含这段时间的退款、价格调整或促销代码。

  • 示例 2:如果你在美国销售 30 种产品并且其中 10 种产品存在退款,则预览和下载的报告将有 40 行。销售和退款将分两行显示。

  • 示例 3:如果你在美国销售 30 种产品并且其中 5 种产品在周中出现价格调整,则完整报告和预览将有 35 行。存在价格调整的产品信息将分两行显示。

  • 示例 4:如果你在美国销售 20 种产品,且你在这周推出的 3 种产品此前已有预购,则预览和下载的报告将包含 23 行。有预购的产品信息将分为两行,预购交易(标有 P)和正常交易分开显示。

术语表

流媒体

通用

流媒体

时长超过 30 秒的歌曲或视频播放。

艺人

内容的主要和合作演出者(包括组合艺人)。

地区

用户店面所在的国家/地区。

音乐类型

内容的音乐风格。

内容类型

内容的格式(例如,歌曲或音乐视频)。

容器类型

发起播放的位置,例如,专辑、播放列表、广播电台或单独曲目。

容器子类型

播放列表或广播电台类型。

会员类型

综合了订阅类型和订阅模式,出现在“流媒体量”页面中,用于描述用户的订阅情况。在可供下载的报告中,订阅类型和订阅模式为两个单独的字段。

设备

设备(移动设备、台式电脑)和操作系统的类别。

在线/离线

播放发生时设备的网络连接状态。仅在设备与网络断开连接时,播放才会标记为离线。

唱片公司/制片商/有线电视公司

提供商交付的唱片公司/制片商/有线电视公司名称。

歌单/广播

用户流化的播放列表或广播电台的名称。

订阅类型

Voice Individual

面向个人用户的声控方案短期试用。此方案的用户使用语音指令播放音乐。

Individual Monthly

面向个人用户的月度订阅,用户从 Apple 直接订阅。

Student Monthly

面向学生用户(就读于符合条件的、可颁发学位的大学或学院)的折扣价订阅。

Family Monthly

面向家庭(至多六位成员)的月度订阅,用户从 Apple 直接订阅。

Indirect Individual Monthly

面向个人用户的订阅,用户通过第三方订阅和结算(例如运营商订阅)。

Indirect Family Monthly

面向家庭(至多六位成员)的订阅,通过第三方订阅和结算(例如运营商订阅)。

Voice Individual Monthly

面向个人用户的月度声控方案,用户从 Apple 直接订阅。此方案的用户使用语音指令播放音乐。

Individual Annual

面向个人用户的年度订阅,用户从 Apple 直接订阅。

Individual Introductory

免费或仅收取象征性费用的订阅,面向新加入服务的个人。

Student Individual Introductory

免费或仅收取象征性费用的订阅,面向新加入服务的学生。

Family Introductory

免费或仅收取象征性费用的订阅,面向新加入服务的家庭。

Voice Individual Introductory

免费或仅收取象征性费用的声控方案,面向新加入服务的个人。此方案的用户使用语音指令播放音乐。

订阅模式

Paid

用户试用期或推介促销优惠结束后的全价订阅。

Trial

面向新用户的免费推介促销订阅。

Offer/Growth Offer

免费或仅收取象征性费用的订阅,时限至少为 1 个月且面向新加入服务的用户。

Gratis Trial

面向符合条件的用户的 1 个月免费订阅(例如,1 个月推介促销订阅或回头客订阅)。

Extended Trial

由第三方补贴的免费推介促销订阅。

Discounted Promo

与促销活动相关的补贴或折扣订阅。

Preview

短期试用,用户无需绑定付款方式。

结束原因类型

已完成播放

当播放头到达歌曲结尾时,播放已完成。

暂停

播放已暂停或中断。

已跳过

用户使用“下一首”或“上一首”按钮更改歌曲。

手动更改

收听者手动开始歌曲的播放。

其他

播放结束的所有其他原因。

流媒体来源

资料库

来源于用户“资料库”的流媒体。

搜索

来源于“搜索”栏的流媒体。

发现

来源于主页、“新发现”或“广播”标签页的流媒体。

外部

来源于 App 外部的流媒体,例如来源于外部链接。

MusicKit

来源于 MusicKit App 整合的流媒体。

正在播放

来源于“正在播放”部分中“创建电台”选项的流媒体。

语音

来源于语音命令。

其他

流媒体的所有其他来源。

容器类型

单独曲目

在容器以外单独流化的歌曲。

播放列表

在播放列表内流化的歌曲。

专辑

在专辑内流化的歌曲。

广播电台

从广播电台流化的歌曲。

容器子类型

Private User Playlist

由用户创建的个人播放列表。

Editorial Playlist

由 Apple 的编辑创建和精选的播放列表。

Charts Playlist

按 Apple 地区对热门歌曲进行排名的播放列表。

Artist Playlist

由艺人创建和精选的播放列表。

Curator Playlist

由第三方合作伙伴创建和精选的播放列表。

Editorial Station

由 Apple 的编辑创建的广播电台。

Algorithm Station

基于一般请求(例如,播放特定艺人的歌曲,或播放派对歌曲),由算法智能生成的广播电台。

Artist Station

根据用户所选艺人生成的广播电台,仅播放该艺人的歌曲。

Personal Station

根据用户的喜爱曲目和收听偏好,由算法生成的广播电台。

Format Station

基于特定音乐类型的广播电台。

Seeded by Artist/Song

基于歌曲或艺人由算法智能生成的广播电台。

Autoplay Station

在待播清单结束时,根据清单中的内容生成的广播电台。

Discovery Station

基于用户的收听偏好,由算法智能生成的广播电台,仅播放该用户从未在 Apple Music 上听过的歌曲。

Personal Mix Playlist

基于用户的收听偏好,由算法智能生成的个人播放列表。

New Music Mix

基于用户的收听偏好,由算法智能生成的个人播放列表,旨在向用户推荐新的音乐。

Favorites Mix

基于用户最喜爱的曲目和收听偏好,由算法智能生成的个人播放列表。

Chill Mix

基于用户的收听偏好,由算法智能生成的个人播放列表,旨在向用户推荐舒缓的曲目。

Get Up! Mix

基于用户的收听偏好,由算法智能生成的个人播放列表,旨在向用户推荐欢快的曲目。

Friends Mix

基于用户 Apple Music 好友的收听偏好,由算法智能生成的个人播放列表。

Replay Mix

基于服务订阅用户每年的最爱曲目生成的个人播放列表。

Love Mood Station

由算法智能生成的广播电台,播放有关浪漫爱情、心动瞬间和恋爱体验的音乐。

Heartbreak Mood Station

由算法智能生成的广播电台,播放有关心碎、单恋、分手或苦涩爱情的音乐。

Feel Good Mood Station

由算法智能生成的广播电台,播放快乐愉悦、积极向上的音乐。

Feeling Blue Mood Station

由算法智能生成的广播电台,播放忧郁感伤的音乐,帮助用户接纳低落情绪。

Focus Mood Station

由算法智能生成的广播电台,播放帮助用户专注于当前任务的音乐。

Relax Mood Station

由算法智能生成的广播电台,播放帮助用户安享当下、寻获内心平静的音乐。

Energy Mood Station

由算法智能生成的广播电台,播放欢快的音乐,唤醒身体律动。

Other Playlists and Stations

所有其他的播放列表和电台。

Non-Playlists and Radio Stations

所有来源于“播放列表”或“广播”容器外的其他播放。

音频格式

Compressed Audio

标准的有损压缩音频(例如 256 kbps AAC)。

Lossless

高质量、未经压缩的音频。

Immersive

杜比全景声,以及 5.1 和 7.1 环绕声。