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