借助创作者数据分析功能,您可以发现并获取有关 YouTube 创作者的数据分析。对于希望寻找与目标受众群体相关的创作者的代理机构和广告客户来说,此功能非常有用。
该 API 具有以下四项主要功能:
- 创作者曝光度:查找特定主题、受众特征、受众群体或创作者属性的热门创作者。
- 创作者品牌数据分析:获取与特定品牌相关的创作者数据分析。
- 创作者数据分析:获取有关特定 YouTube 频道的数据分析,例如订阅人数、观看次数和观众人口统计信息。
- 热门数据洞见:根据特定受众群体或主题,获取有关特定趋势的数据洞见。
资格要求
ContentCreatorInsightsService.GenerateCreatorInsights 是 Google Ads API 的私有组件,以非独占、免版税的数据许可提供。已签约的合作伙伴可以使用标准 Google Ads 客户端库来探索 YouTube 创作者和内容。合作伙伴必须满足以下条件,才能符合资格要求:
- 拥有可集成 Google Ads API 的规划工具或用户界面。
- 使用该 API 探索 YouTube 内容和创作者,寻找潜在的广告机会。
- 完成初步过滤评估,确保符合条件。
- 遵循数据使用要求,并愿意接受定期数据审核。
- 签署数据许可协议,以从法律上强制执行数据使用要求。
- 接受 Google Ads API 服务条款。
如需了解详情,请与您的 Google 代表联系。
生成创作者数据分析
如需生成创作者数据分析,请向 ContentCreatorInsightsService.GenerateCreatorInsights 方法发送请求。此方法的限制为每秒查询次数 (QPS),并且根据您是要进行创作者曝光度查询、创作者品牌数据分析还是获取创作者数据分析,需要采用三种类型的输入。您必须提供要从中获取数据的国家/地区位置。
创作者可发现性:您可以提供受众群体属性列表,例如年龄、性别和用户兴趣(包括兴趣相似的受众群体、有购买意向的受众群体和人生大事受众群体)。该 API 会返回一个创作者列表,其中创作者的受众群体与这些属性相匹配。您还可以提供创作者属性,以过滤出内容与您输入的创作者属性完全匹配的创作者。
您可以使用
AudienceInsightsService.ListAudienceInsightsAttributes检索可用的受众群体属性,方法是提供您要获取属性的维度,例如KNOWLEDGE_GRAPH(表示兴趣主题)。自 Google Ads API v23 起,您可以使用
audience_combinations指定复杂的受众群体属性关系。借助此字段,您可以使用布尔逻辑运算符(和/或)来定义受众群体,而这无法通过audience_attributes实现。虽然
audience_attributes适合根据一组并集(通过 OR 组合)属性(例如,对“体育”“旅游”或 ... 感兴趣的用户)进行定位,但audience_combinations可提供更精细的控制。audience_combinations中的每个InsightsAudienceAttributeGroup都通过逻辑 OR 组合属性。然后,这些组通过逻辑 AND 组合在一起。例如,若要定位对“护肤”或“护发”感兴趣且还对“化妆品”感兴趣的受众群体,您需要在
audience_combinations中使用两个InsightsAudienceAttributeGroup项。“护肤”“护发”和“化妆品”是兴趣主题,由知识图谱实体表示(例如,/m/014trl表示化妆品)。第一个组将包含“护肤”和“护发”的知识图谱实体属性,第二个组将包含“化妆品”的知识图谱实体属性。请注意,如果您在
audience_attributes中指定了知识图谱实体、产品和服务类别或用户兴趣,则无法使用audience_combinations。如果您使用audience_combinations,则必须在audience_combinations中指定这些属性,而不能在audience_attributes中指定;不过,您仍然可以将audience_attributes与audience_combinations结合使用,用于其他属性类型,例如人口统计信息。创作者品牌数据洞见:提供品牌以搜索顶尖创作者。该 API 会返回有关匹配渠道的数据分析。
创作者数据分析:提供 YouTube 频道 ID 列表。该 API 会返回有关这些特定渠道的数据洞见。
generateCreatorInsights 方法会返回一个 GenerateCreatorInsightsResponse 对象。此对象包含 YouTubeCreatorInsights 对象的列表。每个 YouTubeCreatorInsights 对象都包含以下有关创作者的信息:
- 创作者姓名
- YouTube 频道
- 创作者指标总数
- YouTube 频道数据分析列表
YouTubeMetrics 对象包含以下指标:
- 订阅人数
- 观看次数
- 视频数
- 是活跃的短视频创作者
- 合作伙伴关系机会(从版本 23 开始)
YouTubeChannelInsights 对象包含有关 YouTube 频道的以下信息:
- 频道名称
- 频道 ID
- 频道网址
- 频道说明
- 频道指标
频道受众群体属性(例如年龄、性别和用户兴趣)
细分)
热门视频
渠道类型
与频道内容相关联的语言
相关性得分(仅适用于主题趋势搜索)
生成热门趋势分析洞见
如需生成热门趋势分析洞见,请向 ContentCreatorInsightsService.GenerateTrendingInsights 方法发送请求。此方法的限制为每秒 5 次查询次数 (QPS),并且根据您是想获取受众群体趋势还是主题趋势,需要采用两种类型的输入。您必须提供要获取趋势的具体国家/地区位置。
受众群体趋势:您可以提供受众群体属性列表,例如年龄、性别和用户兴趣(包括兴趣相似的受众群体、有购买意向的受众群体和人生大事受众群体)。该 API 会返回这些受众群体的热门数据洞见列表,其中包括趋势价值在比较期内的百分比变化等指标。
您可以使用
AudienceInsightsService.ListAudienceInsightsAttributes检索可用的受众群体属性,方法是提供您要获取属性的维度,例如KNOWLEDGE_GRAPH(表示兴趣主题)。自 Google Ads API v23 起,您可以使用
audience_combinations指定复杂的受众群体属性关系。借助此字段,您可以使用布尔逻辑运算符(和/或)来定义受众群体,而这无法通过audience_attributes实现。虽然
audience_attributes适合根据一组并集(通过 OR 组合)属性(例如,对“体育”“旅游”或 ... 感兴趣的用户)进行定位,但audience_combinations可提供更精细的控制。audience_combinations中的每个InsightsAudienceAttributeGroup都通过逻辑 OR 组合属性。然后,这些组通过逻辑 AND 组合在一起。例如,若要定位对“护肤”或“护发”感兴趣且还对“化妆品”感兴趣的受众群体,您需要在
audience_combinations中使用两个InsightsAudienceAttributeGroup项。“护肤”“护发”和“化妆品”是兴趣主题,由知识图谱实体表示(例如,/m/014trl表示化妆品)。第一个组将包含“护肤”和“护发”的知识图谱实体属性,第二个组将包含“化妆品”的知识图谱实体属性。请注意,如果您在
audience_attributes中指定了知识图谱实体、产品和服务类别或用户兴趣,则无法使用audience_combinations。如果您使用audience_combinations,则必须在audience_combinations中指定这些属性,而不能在audience_attributes中指定;不过,您仍然可以将audience_attributes与audience_combinations结合使用,用于其他属性类型,例如人口统计信息。主题趋势:提供内容主题列表。该 API 会返回这些主题的热门数据分析列表,其中包括趋势值的百分比变化等指标(在比较期内)。