YouTube 创作者数据分析

借助创作者数据分析功能，您可以发现并获取有关 YouTube 创作者的数据分析。对于希望寻找与目标受众群体相关的创作者的代理机构和广告客户来说，此功能非常有用。

该 API 具有四项主要功能：

  1. 创作者可发现性：查找与指定主题、人口统计特征、受众群体或创作者属性相关的创作者。
  2. 创作者主题数据分析：获取有关制作指定主题内容的创作者的相关数据分析。
  3. 创作者数据分析：获取有关特定 YouTube 频道的数据分析，例如订阅人数、观看次数和观众群特征。
  4. 热门数据洞见：根据特定受众群体或主题获取有关特定趋势的数据洞见。

使用基于主题的创作者发现功能或热门趋势数据分析功能时，可以通过请求补充数据来支持本地创作者发现（查找位于或发布内容于指定国家/地区且在该国家/地区被观看的创作者）。

资格要求

GenerateCreatorInsights 是 Google Ads API 的私有组件，以非独占、免版税的数据许可提供。已签约的合作伙伴可以使用标准 Google Ads 客户端库来探索 YouTube 创作者和内容。如要符合条件，合作伙伴必须满足以下条件：

  • 拥有可集成 Google Ads API 的规划工具或用户界面。
  • 使用该 API 探索 YouTube 内容和创作者，寻找潜在的广告机会。
  • 完成初步过滤评估，确保符合条件。
  • 遵循数据使用要求，并愿意接受定期数据审核。
  • 签署数据许可协议，以从法律上强制执行数据使用要求。
  • 接受 Google Ads API 服务条款。

如需了解详情，请与您的 Google 代表联系。

生成创作者数据分析

如需生成创作者数据分析，请向 GenerateCreatorInsights 方法发送请求。此方法的限制为每秒查询次数 (QPS)。它会根据您是要提高创作者的可发现性、按主题搜索相关创作者，还是要获取创作者数据洞见，来接受不同类型的输入。您必须提供要从中获取数据的国家/地区位置。

  1. 创作者可发现性：您可以提供受众群体属性列表，例如年龄、性别和用户兴趣（包括兴趣相似的受众群体、有购买意向的受众群体和人生大事受众群体）。该 API 会返回受众群体符合这些属性的创作者列表。您还可以提供创作者属性，以过滤出内容与您输入的创作者属性完全匹配的创作者。

    您可以通过提供要获取属性的维度（例如 KNOWLEDGE_GRAPH 表示兴趣主题），使用 ListAudienceInsightsAttributes 检索可用的受众群体属性。

    自 Google Ads API v23 起，您可以使用 audience_combinations 指定复杂的受众群体属性关系。借助此字段，您可以定义使用布尔逻辑（AND/OR）的受众群体，而这无法通过 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 结合使用，用于其他属性类型（例如人口统计信息）。

  2. 创作者主题洞察：使用 search_topics 字段提供内容主题列表。该 API 会返回制作与指定主题相关内容的创作者。提取的数据基于 country_locations 中指定的国家/地区。请注意，此选项仅允许搜索一个国家/地区。

    SearchTopics 字段中受支持的实体必须标记为具有 CONTENT_TRENDING_INSIGHTS 或 CREATOR_TOPIC_INSIGHTS 功能。使用 ListAudienceInsightsAttributes 方法检索受支持的实体功能。

    注意：search_brand 选项已在 v24.2 中弃用，并在 v25 中移除。请改用 search_topics。

  3. 创作者数据分析：使用 search_channels 字段提供 YouTube 频道 ID 列表。API 会返回有关这些特定渠道的数据洞见。

补充数据和本地创作者

默认情况下，仅返回核心数据洞见。您可以通过设置重复字段 supplemental_data，在响应中请求可选功能和额外数据。

例如，您可以通过向 supplemental_data 字段添加 LOCAL_CREATOR_DATA 枚举值来请求本地创作者数据。如果您使用 search_topics 搜索创作者（并且相应主题是标记有 CREATOR_TOPIC_INSIGHTS 功能的知识图谱实体），则 API 会在响应中填充 local_creator_insights 字段，其中包含已同意分享其位置数据的本地创作者。

请注意以下本地创作者发现规范：

  • 定义：“本地创作者”是指位于所选国家/地区或从所选国家/地区发布内容，并且在所选国家/地区获得观看的创作者。
  • 限制：当请求中设置了 sub_country_locations 时，不支持本地创作者发现。
  • 功能：您可以使用 ListAudienceInsightsAttributes 检索受支持的知识图谱实体及其功能的列表。

generateCreatorInsights 方法会返回一个 GenerateCreatorInsightsResponse 对象。此对象包含以下字段：

  • creator_insights：符合您的核心条件的 YouTubeCreatorInsights 对象列表。
  • local_creator_insights：面向本地创作者的 YouTubeCreatorInsights 对象列表。仅当请求了 LOCAL_CREATOR_DATA 且所用条件为 search_topics 时，才会填充此字段。

每个 YouTubeCreatorInsights 对象都包含有关创作者的以下信息：

  • 创作者姓名
  • YouTube 频道
  • 创作者指标总数
  • YouTube 频道数据分析列表

YouTubeMetrics 对象包含以下指标：

  • 订阅人数
  • 观看次数
  • 视频数
  • 是活跃的短视频创作者
  • 合作伙伴机会（从版本 23 开始）

如需确定创作者是否符合原创品牌合作内容合作伙伴计划的条件，请检查 partnership_opportunities；如果该列表包含 CREATOR_PARTNERSHIPS 值，则表示创作者符合条件。

YouTubeChannelInsights 对象包含有关 YouTube 频道的以下信息：

  • 频道名称
  • 频道 ID
  • 频道网址
  • 频道说明
  • 频道指标
  • 频道受众群体属性（例如年龄、性别和用户兴趣细分）
  • 热门视频
  • 渠道类型
  • 与频道内容相关联的语言
  • 相关性得分（仅适用于主题趋势搜索）
  • 创作者是否已同意分享非公开指标

如需生成热门趋势分析，请向 GenerateTrendingInsights 方法发送请求。此方法的限制为每秒查询次数 (QPS)。它需要两种类型的输入，具体取决于您是想了解受众群体趋势还是主题趋势。您必须提供要获取趋势的具体国家/地区位置。

  1. 受众群体趋势：您可以提供受众群体属性列表，例如年龄、性别和用户兴趣（包括兴趣相似的受众群体、有购买意向的受众群体和人生大事受众群体）。该 API 会返回这些受众群体的热门数据洞见列表，其中包括趋势值的百分比变化（相对于比较期）等指标。

    您可以通过提供要获取属性的维度（例如 KNOWLEDGE_GRAPH 表示兴趣主题），使用 ListAudienceInsightsAttributes 检索可用的受众群体属性。

    自 Google Ads API v23 起，您可以使用 audience_combinations 指定复杂的受众群体属性关系。借助此字段，您可以定义使用布尔逻辑（AND/OR）的受众群体，而这无法通过 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 结合使用，用于其他属性类型（例如人口统计信息）。

    KNOWLEDGE_GRAPH 属性将包含一个或多个 InsightsKnowledgeGraphEntityCapabilities 标记。支持“热门分析洞见”的属性将在其响应元数据中包含相关标记。

    请注意，有权访问 ContentCreatorInsightsService 的开发者也会自动获得 AudienceInsightsService.ListAudienceInsightsAttributes 的访问权限。AudienceInsightsService 中的其他端点需要单独的许可名单流程。

    如需查看有关 ListAudienceInsightsAttributes 的其他文档，请参阅受众群体分析指南。

  2. 主题趋势：提供内容主题列表。该 API 会返回这些主题的热门数据分析列表，其中包括趋势值的百分比变化等指标（与比较期相比）。

与生成创作者数据分析类似，您可以通过将重复字段 supplemental_data 设置为 LOCAL_CREATOR_DATA，在热门趋势数据分析中请求可选功能。

如果您的热门趋势请求使用 search_topics，则返回的 TrendInsight 对象中的 related_local_creators 字段将填充与所请求主题相关的本地创作者（已同意分享其位置数据）。本地创作者发现功能受相同的定义和限制（例如与 sub_country_locations 不兼容）约束。

GenerateTrendingInsights 方法会返回一个 TrendInsight 对象列表，每个对象包含：

  • trend_attribute：趋势的主要 AudienceInsightsAttributeMetadata。
  • trend_metrics：趋势的指标，例如比较期内的百分比变化。
  • trend_data_points：趋势的历史数据点。仅针对使用 search_topics 的趋势进行填充。
  • related_videos：与趋势主题相关的热门视频的 AudienceInsightsAttributeMetadata 对象列表。仅针对使用 search_topics 的趋势进行填充。对于这些属性，系统会填充嵌套的 YouTubeVideoAttributeMetadata，其中包含视频级元数据（例如视频网址、缩略图网址以及观看次数或赞数）和频道级元数据（例如频道 ID、名称和网址）。
上一页
受众群体分析