借助创作者数据分析功能,发现并获取有关 YouTube 创作者的数据分析。对于希望寻找与目标受众群体相关的创作者的代理机构和广告客户来说,此功能非常有用。
该 API 具有四项主要功能:
- 创作者可发现性:查找在指定主题、人口统计特征、受众群体或创作者属性方面表现出色的创作者。
- 创作者品牌数据分析:获取与特定品牌相关的创作者数据分析。
- 创作者数据洞见:获取有关特定 YouTube 频道的数据洞见,例如订阅人数、观看次数和观众群特征。
- 热门趋势数据洞见:根据特定受众群体或主题,获取有关特定趋势的数据洞见。
资格要求
ContentCreatorInsightsService.GenerateCreatorInsights
是 Google Ads API 的私有组件,以非独占、免版税的数据许可提供。已签约的合作伙伴可以使用标准 Google Ads 客户端库来探索 YouTube 创作者和内容。合作伙伴必须满足以下条件,才能符合资格要求:
- 拥有将集成该 API 的规划工具或用户界面。
- 使用该 API 探索 YouTube 内容和创作者,寻找潜在的广告机会。
- 完成资格预审评估,确保符合条件。
- 遵守数据使用要求,并愿意接受定期数据审核。
- 签署数据许可协议,以从法律上强制执行数据使用要求。
- 接受 Google Ads API 服务条款。
如需了解详情,请与您的 Google 代表联系。
生成创作者数据洞见
如需生成创作者数据分析,请向 ContentCreatorInsightsService.GenerateCreatorInsights
方法发送请求。此方法的限制为每秒 5 次查询 (QPS),并且根据您是要进行创作者可发现性分析、创作者品牌数据分析还是获取创作者数据分析,需要采用三种类型的输入。您必须提供要从中获取数据的国家/地区位置。
- 创作者可发现性:您可以提供受众群体属性列表,例如年龄、性别和兴趣。该 API 会返回受众群体与这些属性匹配的创作者列表。您还可以提供创作者属性,以过滤出内容与您输入的创作者属性完全匹配的创作者。
- 创作者品牌数据洞见:提供品牌以搜索顶尖创作者。该 API 会返回有关匹配渠道的数据分析。
- 创作者数据分析:提供 YouTube 频道 ID 列表。API 会返回有关这些特定渠道的数据洞见。
generateCreatorInsights
方法会返回一个 GenerateCreatorInsightsResponse
对象。此对象包含 YouTubeCreatorInsights
对象的列表。每个 YouTubeCreatorInsights
对象都包含以下有关创作者的信息:
- 创作者姓名
- YouTube 频道
- 创作者指标总数
- YouTube 频道数据分析列表
YouTubeMetrics
对象包含以下指标:
- 订阅人数
- 观看次数
- 视频数
- 是活跃的短视频创作者
YouTubeChannelInsights
对象包含有关 YouTube 频道的以下信息:
- 频道名称
- 频道 ID
- 频道网址
- 频道说明
- 频道指标
- 频道观众属性(例如年龄、性别和用户兴趣细分)
- 热门视频
- 渠道类型
生成热门数据分析
如需生成热门趋势数据分析,请向 ContentCreatorInsightsService.GenerateTrendingInsights
方法发送请求。此方法的限制为每秒 5 次查询 (QPS),并且根据您是想获取受众群体趋势还是主题趋势,需要采用两种类型的输入。
您必须提供要获取趋势的具体国家/地区位置。
- 受众群体趋势:您可以提供受众群体属性列表,例如年龄、性别和兴趣。该 API 会返回这些受众群体的热门数据洞见列表。
- 主题趋势:提供内容主题列表。该 API 会返回这些主题的热门数据洞见列表。