Thông tin chi tiết về nhà sáng tạo trên YouTube

Khám phá và thu thập thông tin chi tiết về nhà sáng tạo trên YouTube bằng tính năng thông tin chi tiết về nhà sáng tạo trong ContentCreatorInsightsService. Dịch vụ này giúp các công ty quảng cáo và nhà quảng cáo tìm thấy những nhà sáng tạo phù hợp với đối tượng mục tiêu của họ.

API này có 4 chức năng chính:

  1. Tiềm năng được khám phá của nhà sáng tạo: Tìm nhà sáng tạo phù hợp cho một nhóm chủ đề, thông tin nhân khẩu học, đối tượng hoặc thuộc tính của nhà sáng tạo.
  2. Thông tin chi tiết về chủ đề của nhà sáng tạo: Lấy thông tin chi tiết về những nhà sáng tạo có liên quan, những người tạo nội dung về các chủ đề cụ thể.
  3. Thông tin chi tiết về nhà sáng tạo: Tìm nạp thông tin chi tiết về các kênh YouTube cụ thể, chẳng hạn như số người đăng ký, số lượt xem và thông tin nhân khẩu học của khán giả.
  4. Thông tin chi tiết về xu hướng: Lấy thông tin chi tiết về các xu hướng cụ thể, dựa trên đối tượng hoặc chủ đề cụ thể.

Bạn có thể khám phá nhà sáng tạo tại địa phương (tìm nhà sáng tạo sinh sống hoặc đăng bài ở một quốc gia nhất định và được xem ở quốc gia đó) khi sử dụng tính năng khám phá nhà sáng tạo theo chủ đề hoặc thông tin chi tiết về xu hướng bằng cách yêu cầu dữ liệu bổ sung. Bạn cũng có thể yêu cầu thông tin chi tiết về cảm nhận đối với thương hiệu cho thông tin chi tiết về xu hướng theo chủ đề bằng cách yêu cầu dữ liệu bổ sung.

Điều kiện sử dụng

GenerateCreatorInsights là một thành phần riêng tư của Google Ads API, được cung cấp kèm theo giấy phép dữ liệu không độc quyền, miễn phí bản quyền. Những đối tác đã ký hợp đồng có thể sử dụng thư viện ứng dụng Google Ads tiêu chuẩn để khám phá các nhà sáng tạo và nội dung trên YouTube. Để đủ điều kiện, đối tác phải đáp ứng các điều kiện sau:

  • Có một công cụ lập kế hoạch hoặc giao diện người dùng tích hợp Google Ads API.
  • Sử dụng API để khám phá nội dung và nhà sáng tạo trên YouTube nhằm tìm kiếm cơ hội quảng cáo tiềm năng.
  • Hoàn tất bài đánh giá sàng lọc trước để xác minh điều kiện.
  • Tuân thủ các yêu cầu về việc sử dụng dữ liệu và trải qua quy trình kiểm tra dữ liệu định kỳ.
  • Chấp nhận điều khoản dịch vụ của Google Ads API và chính sách sử dụng dữ liệu liên quan.

Hãy liên hệ với người đại diện của Google để biết thêm thông tin.

Tạo thông tin chi tiết về nhà sáng tạo

Để tạo thông tin chi tiết về nhà sáng tạo, hãy gửi yêu cầu đến phương thức GenerateCreatorInsights. Phương thức này có giới hạn là 5 truy vấn mỗi giây (QPS). Phương thức này chấp nhận nhiều tiêu chí, tuỳ thuộc vào việc bạn muốn tiềm năng được khám phá của nhà sáng tạo, tìm nhà sáng tạo theo chủ đề hay xem thông tin chi tiết về nhà sáng tạo theo kênh. Bạn phải cung cấp vị trí của quốc gia mục tiêu trong country_locations.

  1. Khả năng khám phá nhà sáng tạo (search_attributes): Cung cấp danh sách các thuộc tính của đối tượng (chẳng hạn như độ tuổi, giới tính và mối quan tâm của người dùng (đối tượng chung sở thích, đối tượng đang cân nhắc mua hàng và đối tượng có sự kiện trong đời)) bằng cách sử dụng trường search_attributes để tìm những nhà sáng tạo có đối tượng phù hợp với các thuộc tính đó. Bạn cũng có thể cung cấp các thuộc tính của nhà sáng tạo để lọc ra những nhà sáng tạo có nội dung phù hợp với các thuộc tính cụ thể.

    Truy xuất các thuộc tính đối tượng có sẵn bằng cách sử dụng ListAudienceInsightsAttributes bằng cách chỉ định các phương diện bạn cần, chẳng hạn như KNOWLEDGE_GRAPH cho các chủ đề quan tâm. Để kết hợp các thuộc tính bằng cách sử dụng các nhóm boolean AND và OR, hãy sử dụng audience_combinations như mô tả trong phần Kết hợp đối tượng phức tạp.

  2. Thông tin chi tiết về chủ đề của nhà sáng tạo (search_topics): Cung cấp danh sách chủ đề nội dung bằng trường search_topics. API này trả về những nhà sáng tạo phù hợp, có nội dung về các chủ đề được chỉ định. Dữ liệu được tìm nạp cho quốc gia được chỉ định trong country_locations (mỗi yêu cầu chỉ hỗ trợ một quốc gia).

    Các thực thể được hỗ trợ trong search_topics phải được gắn thẻ bằng chức năng CONTENT_TRENDING_INSIGHTS hoặc CREATOR_TOPIC_INSIGHTS. Sử dụng ListAudienceInsightsAttributes để truy xuất các chức năng được hỗ trợ của thực thể.

  3. Thông tin chi tiết về nhà sáng tạo (search_channels): Cung cấp danh sách mã nhận dạng kênh YouTube, tên người dùng kênh YouTube (youtube_channel_handles, có trong v25 trở lên) hoặc kết hợp cả hai bằng cách sử dụng trường search_channels. API này trả về thông tin chi tiết về những kênh cụ thể đó.

Kết hợp đối tượng phức tạp

Trong cả GenerateCreatorInsights và GenerateTrendingInsights, bạn có thể xác định mối quan hệ phức tạp giữa các thuộc tính đối tượng bằng cách sử dụng audience_combinations. Trường này cho phép bạn kết hợp các thuộc tính đối tượng với logic boolean (AND và OR) ngoài hành vi hợp nhất phẳng (OR) của audience_attributes:

  • Mỗi InsightsAudienceAttributeGroup trong audience_combinations kết hợp các thuộc tính của nó với một OR logic.
  • Nhiều mục InsightsAudienceAttributeGroup trong audience_combinations được kết hợp với một AND logic.

Ví dụ: để nhắm đến đối tượng quan tâm đến ("Skin care" OR "Hair care") AND "Cosmetics", hãy thêm hai mục InsightsAudienceAttributeGroup vào audience_combinations:

  1. Nhóm 1 chứa các thuộc tính thực thể trong Sơ đồ tri thức cho "Skin care" và "Hair care".
  2. Nhóm 2 chứa thuộc tính thực thể Sơ đồ tri thức cho "Cosmetics" (chẳng hạn như /m/014trl).

Dữ liệu bổ sung và nhà sáng tạo tại địa phương

Theo mặc định, chỉ dữ liệu thông tin chi tiết cốt lõi mới được trả về. Bạn có thể yêu cầu các tính năng không bắt buộc và dữ liệu bổ sung trong phản hồi bằng cách đặt trường lặp lại supplemental_data.

Ví dụ: bạn có thể yêu cầu dữ liệu của nhà sáng tạo tại địa phương bằng cách thêm giá trị enum LOCAL_CREATOR_DATA vào supplemental_data. Nếu bạn tìm nhà sáng tạo bằng search_topics (và chủ đề là một thực thể trong Sơ đồ tri thức được gắn thẻ bằng chức năng CREATOR_TOPIC_INSIGHTS), thì API sẽ điền vào trường local_creator_insights trong phản hồi những nhà sáng tạo tại địa phương đã đồng ý chia sẻ dữ liệu vị trí của họ.

Hãy lưu ý những thông số kỹ thuật sau đây khi khám phá nhà sáng tạo địa phương:

  • Định nghĩa: Nhà sáng tạo địa phương là những nhà sáng tạo sinh sống hoặc đăng nội dung tại quốc gia được chọn và có người xem ở quốc gia đó.
  • Quy tắc ràng buộc: Tính năng khám phá nhà sáng tạo tại địa phương không được hỗ trợ khi sub_country_locations được đặt trong yêu cầu.
  • Khả năng: Bạn có thể truy xuất danh sách các thực thể được hỗ trợ trong Sơ đồ tri thức và khả năng của các thực thể đó bằng cách sử dụng ListAudienceInsightsAttributes.

Phương thức GenerateCreatorInsights trả về một đối tượng GenerateCreatorInsightsResponse chứa các trường sau:

  • creator_insights: Danh sách các đối tượng YouTubeCreatorInsights khớp với tiêu chí cốt lõi của bạn.
  • local_creator_insights: Danh sách các đối tượng YouTubeCreatorInsights cho nhà sáng tạo địa phương. Trường này chỉ được điền sẵn nếu LOCAL_CREATOR_DATA được yêu cầu và tiêu chí được sử dụng là search_topics.

Mỗi đối tượng YouTubeCreatorInsights chứa:

  • creator_name: Tên của người tạo.
  • creator_channels: Danh sách các đối tượng YouTubeChannelInsights. Thông tin chi tiết về kênh và channel_metrics (YouTubeMetrics) được trả về bên trong mỗi đối tượng YouTubeChannelInsights trong creator_channels.

Đối tượng YouTubeMetrics chứa:

  • Số người đăng ký, số lượt xem và số video
  • Tổng số lượt thích, lượt chia sẻ và bình luận trên tất cả video của kênh
  • Tỷ lệ tương tác toàn thời gian (tổng số lượt tương tác chia cho tổng số lượt xem)
  • Số lượt xem, lượt thích, lượt chia sẻ và bình luận trung bình trên mỗi video trong 28 ngày qua
  • Số lượt xem video Shorts và số video ngắn
  • Nhà sáng tạo có phải là nhà sáng tạo video Shorts hoặc nhà sáng tạo sự kiện phát trực tiếp đang hoạt động hay không (đã xuất bản một video Shorts hoặc sự kiện phát trực tiếp trong 90 ngày qua)
  • Cơ hội hợp tác

Tỷ lệ tương tác và số lượt xem, lượt thích và bình luận trung bình trên mỗi video là các chỉ số không công khai và chỉ được điền sẵn khi nhà sáng tạo đồng ý chia sẻ các chỉ số này.

Để kiểm tra xem một nhà sáng tạo có đủ điều kiện hợp tác về nội dung lồng ghép thương hiệu hay không, hãy kiểm tra partnership_opportunities; nhà sáng tạo đủ điều kiện nếu danh sách có chứa CREATOR_PARTNERSHIPS.

Đối tượng YouTubeChannelInsights chứa thông tin sau đây về một kênh YouTube:

  • Tên kênh, mã nhận dạng, tên người dùng, URL, nội dung mô tả và URL hình thu nhỏ
  • Ngày tạo kênh và quốc gia liên kết
  • Chỉ số về kênh
  • Thuộc tính đối tượng của kênh (chẳng hạn như thông tin chi tiết về độ tuổi, giới tính và mối quan tâm của người dùng)
  • Thuộc tính của kênh (các thuộc tính liên quan đến nội dung của kênh)
  • Video hàng đầu
  • Loại kênh và ngôn ngữ nội dung
  • Điểm mức độ liên quan (chỉ dành cho nội dung tìm kiếm thịnh hành)
  • Liệu nhà sáng tạo đã đồng ý chia sẻ các chỉ số không công khai hay chưa

Tài liệu tham khảo về yêu cầu và phản hồi của GenerateCreatorInsights

Gọi GenerateCreatorInsights trên ContentCreatorInsightsService tại điểm cuối sau:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights

Bảng sau đây tóm tắt các trường trên GenerateCreatorInsightsRequest:

Đường dẫn trường Yêu cầu Định dạng và quy tắc ràng buộc
customer_id Bắt buộc Mã khách hàng gồm 10 chữ số (string) không có dấu gạch nối.
customer_insights_group Bắt buộc Tên do người dùng xác định (string) của khách hàng hoặc thương hiệu đang được lập kế hoạch.
country_locations[] Bắt buộc Danh sách các đối tượng LocationInfo của quốc gia (geo_target_constant, chẳng hạn như "geoTargetConstants/2840"). Phải chứa một quốc gia khi sử dụng search_topics.
sub_country_locations[] Không bắt buộc Bộ lọc LocationInfo theo quốc gia phụ; chỉ được hỗ trợ với search_attributes và không tương thích với LOCAL_CREATOR_DATA.
search_attributes criteria (oneof) SearchAttributes chứa:
• audience_attributes[]: age_range, gender, device, parental_status, income_range (cộng với user_interest, entity hoặc category khi không dùng audience_combinations).
• audience_combinations[]: AND-of-ORs InsightsAudienceAttributeGroup mục.
• creator_attributes[]: entity mục trong Sơ đồ tri thức có chức năng CREATOR_ATTRIBUTE.
search_topics criteria (oneof) SearchTopics chứa entities[] (AudienceInsightsEntity có knowledge_graph_machine_id được gắn thẻ CREATOR_TOPIC_INSIGHTS hoặc CONTENT_TRENDING_INSIGHTS).
search_channels criteria (oneof) YouTubeChannels chứa youtube_channels[] (channel_id) và/hoặc youtube_channel_handles[] (tên người dùng bắt đầu bằng @, chẳng hạn như "@youtubecreators").
supplemental_data[] Không bắt buộc ContentCreatorInsightsSupplementalData giá trị. Đặt LOCAL_CREATOR_DATA cho yêu cầu search_topics của một quốc gia (đối với các thực thể có CREATOR_TOPIC_INSIGHTS) để điền local_creator_insights[].
insights_application_info Không bắt buộc AdditionalApplicationInfo siêu dữ liệu về ứng dụng đưa ra yêu cầu.

Thông báo GenerateCreatorInsightsResponse trả về các trường sau:

Trường phản hồi Loại Mô tả
creator_insights[] YouTubeCreatorInsights Nhà sáng tạo đáp ứng các tiêu chí cốt lõi của bạn (creator_name và creator_channels[]).
local_creator_insights[] YouTubeCreatorInsights Nhà sáng tạo địa phương đã đồng ý chia sẻ dữ liệu vị trí (được điền sẵn khi LOCAL_CREATOR_DATA được yêu cầu cùng với search_topics trên một thực thể có CREATOR_TOPIC_INSIGHTS).
creator_channels[] YouTubeChannelInsights Siêu dữ liệu: display_name, youtube_channel.channel_id, handle, channel_url, publish_date, country_location và data_sharing_consent_given.
Thông tin chi tiết và nội dung: channel_audience_attributes[] (bị hạn chế theo sự đồng ý), channel_attributes[], top_videos[], language_distributions[], relevance_score (chỉ được điền cho GenerateTrendingInsights có search_topics) và channel_metrics.
channel_metrics YouTubeMetrics Chỉ số công khai: subscriber_count, views_count, video_count, likes_count, shares_count, comments_count, shorts_views_count, shorts_video_count, is_active_shorts_creator, is_active_live_stream_creator và partnership_opportunities[].
Chỉ số cần có sự đồng ý: engagement_rate và mức trung bình trong 28 ngày cho mỗi video (average_views_per_video, average_likes_per_video, average_shares_per_video, average_comments_per_video).

Ví dụ về yêu cầu và phản hồi REST của GenerateCreatorInsights

Ví dụ sau đây cho thấy cách khám phá nhà sáng tạo bằng searchAttributes với thông tin nhân khẩu học audienceAttributes, boolean audienceCombinations ("Skin care" OR "Hair care", AND "Cosmetics") và creatorAttributes:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights

{
  "customerInsightsGroup": "Spring Skincare Campaign",
  "countryLocations": [
    {
      "geoTargetConstant": "geoTargetConstants/2840"
    }
  ],
  "searchAttributes": {
    "audienceAttributes": [
      {
        "ageRange": {
          "type": "AGE_RANGE_25_34"
        }
      },
      {
        "gender": {
          "type": "FEMALE"
        }
      }
    ],
    "audienceCombinations": [
      {
        "attributes": [
          {
            "entity": {
              "knowledgeGraphMachineId": "/m/015c4z"
            }
          },
          {
            "entity": {
              "knowledgeGraphMachineId": "/m/018bb_"
            }
          }
        ]
      },
      {
        "attributes": [
          {
            "entity": {
              "knowledgeGraphMachineId": "/m/014trl"
            }
          }
        ]
      }
    ],
    "creatorAttributes": [
      {
        "entity": {
          "knowledgeGraphMachineId": "/m/014trl"
        }
      }
    ]
  }
}

Để tìm nạp nhà sáng tạo theo chủ đề cùng với nhà sáng tạo tại địa phương, hãy sử dụng searchTopics và thêm "LOCAL_CREATOR_DATA" vào supplementalData:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights

{
  "customerInsightsGroup": "Spring Skincare Campaign",
  "countryLocations": [
    {
      "geoTargetConstant": "geoTargetConstants/2840"
    }
  ],
  "supplementalData": [
    "LOCAL_CREATOR_DATA"
  ],
  "searchTopics": {
    "entities": [
      {
        "knowledgeGraphMachineId": "/m/014trl"
      }
    ]
  }
}

Để tìm nạp thông tin chi tiết cho các kênh YouTube cụ thể theo mã nhận dạng kênh hoặc tên người dùng, hãy sử dụng searchChannels:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights

{
  "customerInsightsGroup": "Spring Skincare Campaign",
  "countryLocations": [
    {
      "geoTargetConstant": "geoTargetConstants/2840"
    }
  ],
  "searchChannels": {
    "youtubeChannels": [
      {
        "channelId": "UCxxxxxxxxxxxxxxxxxxxxxx"
      }
    ],
    "youtubeChannelHandles": [
      "@exampleskincare"
    ]
  }
}

GenerateCreatorInsightsResponse thành công sẽ trả về creatorInsights[] (và localCreatorInsights[] khi LOCAL_CREATOR_DATA được yêu cầu):

{
  "creatorInsights": [
    {
      "creatorName": "Example Skincare Creator",
      "creatorChannels": [
        {
          "displayName": "Example Skincare Channel",
          "youtubeChannel": {
            "channelId": "UCxxxxxxxxxxxxxxxxxxxxxx"
          },
          "channelUrl": "https://www.youtube.com/channel/UCxxxxxxxxxxxxxxxxxxxxxx",
          "handle": "@exampleskincare",
          "publishDate": "2020-03-15",
          "countryLocation": {
            "geoTargetConstant": "geoTargetConstants/2840"
          },
          "dataSharingConsentGiven": true,
          "channelMetrics": {
            "subscriberCount": "450000",
            "viewsCount": "38200000",
            "videoCount": "210",
            "likesCount": "1950000",
            "commentsCount": "84000",
            "engagementRate": 0.056,
            "averageViewsPerVideo": 62000.0,
            "shortsViewsCount": "14500000",
            "shortsVideoCount": "95",
            "isActiveShortsCreator": true,
            "isActiveLiveStreamCreator": false,
            "partnershipOpportunities": [
              "CREATOR_PARTNERSHIPS",
              "PARTNERSHIP_ADS"
            ]
          }
        }
      ]
    }
  ],
  "localCreatorInsights": []
}

Để tạo thông tin chi tiết về xu hướng, hãy gửi yêu cầu đến phương thức GenerateTrendingInsights. Phương thức này có giới hạn là 5 truy vấn mỗi giây (QPS). Phương thức này chấp nhận hai loại dữ liệu đầu vào tuỳ thuộc vào việc bạn muốn xem xu hướng đối tượng hay xu hướng chủ đề, đồng thời yêu cầu vị trí quốc gia mục tiêu.

  1. Xu hướng đối tượng (search_audience): Cung cấp danh sách các thuộc tính đối tượng (chẳng hạn như độ tuổi, giới tính và mối quan tâm của người dùng) trong trường audience_attributes của search_audience và có thể sử dụng audience_combinations để kết hợp các thuộc tính với logic boolean AND/OR. API này trả về danh sách thông tin chi tiết về xu hướng cho những đối tượng đó, bao gồm cả các chỉ số như tỷ lệ phần trăm thay đổi về giá trị của xu hướng trong khoảng thời gian so sánh.

    Những nhà phát triển có quyền truy cập vào ContentCreatorInsightsService sẽ tự động có quyền truy cập vào ListAudienceInsightsAttributes trong AudienceInsightsService (xem Hướng dẫn về thông tin chi tiết về đối tượng). Các điểm cuối khác trong AudienceInsightsService cần có một danh sách cho phép riêng.

  2. Xu hướng chủ đề (search_topics): Cung cấp danh sách các chủ đề nội dung trong trường search_topics. API này trả về thông tin chi tiết về xu hướng cho các chủ đề đó, bao gồm cả mức thay đổi theo tỷ lệ phần trăm về giá trị của xu hướng trong khoảng thời gian so sánh. Bạn cũng có thể yêu cầu thông tin chi tiết về nhà sáng tạo địa phương hoặc mức độ cảm tình với thương hiệu bằng cách đặt supplemental_data.

    Các thuộc tính KNOWLEDGE_GRAPH do ListAudienceInsightsAttributes trả về bao gồm một hoặc nhiều thẻ InsightsKnowledgeGraphEntityCapabilities; các thực thể được gắn thẻ CONTENT_TRENDING_INSIGHTS được hỗ trợ dưới dạng chủ đề trong GenerateTrendingInsights.

Tương tự như việc tạo thông tin chi tiết về nhà sáng tạo, bạn có thể yêu cầu các tính năng không bắt buộc trong thông tin chi tiết về xu hướng bằng cách đặt trường lặp lại supplemental_data thành LOCAL_CREATOR_DATA hoặc BRAND_SENTIMENT_DATA:

  • Nhà sáng tạo tại địa phương (LOCAL_CREATOR_DATA): Khi yêu cầu về xu hướng của bạn sử dụng search_topics (và chủ đề là một thực thể trong Sơ đồ tri thức được gắn thẻ có chức năng CREATOR_TOPIC_INSIGHTS), việc đặt supplemental_data thành LOCAL_CREATOR_DATA sẽ điền vào trường related_local_creators trên các đối tượng TrendInsight được trả về thông tin về những nhà sáng tạo tại địa phương có liên quan đã đồng ý chia sẻ dữ liệu vị trí của họ. Tính năng khám phá nhà sáng tạo tại địa phương không tương thích với sub_country_locations.
  • Mức độ cảm tình đối với thương hiệu (BRAND_SENTIMENT_DATA): Khi yêu cầu về xu hướng của bạn sử dụng search_topics và chủ đề thực thể Sơ đồ tri thức được yêu cầu có chức năng BRAND, việc đặt supplemental_data thành BRAND_SENTIMENT_DATA sẽ điền sẵn trường brand_sentiment_insights trên các đối tượng TrendInsight được trả về.

Để đo lường cảm nhận về thương hiệu, chúng tôi sử dụng các mô hình AI của Gemini để phân tích nội dung video trên YouTube liên quan đến thương hiệu, sau đó phân loại cảm nhận thành tích cực, tiêu cực hoặc trung lập. Chỉ có nội dung video được phân tích, còn bình luận của người dùng thì không.

Phương thức GenerateTrendingInsights trả về danh sách các đối tượng TrendInsight, mỗi đối tượng chứa:

  • trend_attribute: AudienceInsightsAttributeMetadata chính cho xu hướng.
  • trend_metrics: Các chỉ số cho xu hướng, chẳng hạn như tỷ lệ phần trăm thay đổi trong giai đoạn so sánh.
  • trend: Giá trị InsightsTrend (EMERGING, RISING, SUSTAINED hoặc DECLINING) cho biết hướng của xu hướng. Hãy xem trend_metrics.trend_change_percent để biết mức độ thay đổi.
  • trend_data_points: Các điểm dữ liệu trước đây cho xu hướng. Chỉ được điền sẵn cho các xu hướng sử dụng search_topics.
  • related_videos: Danh sách các đối tượng AudienceInsightsAttributeMetadata cho video thịnh hành liên quan đến chủ đề của xu hướng (chỉ được điền sẵn cho các xu hướng sử dụng search_topics). Đối với các thuộc tính này, YouTubeVideoAttributeMetadata lồng nhau được điền sẵn siêu dữ liệu ở cấp video (URL, URL hình thu nhỏ, số lượt xem và số lượt thích) và siêu dữ liệu ở cấp kênh (mã nhận dạng kênh, tên và URL).
  • related_creators: Danh sách các đối tượng YouTubeCreatorInsights cho nhà sáng tạo liên quan đến chủ đề của xu hướng (chỉ được điền sẵn cho các xu hướng sử dụng search_topics).
  • related_local_creators: Danh sách các đối tượng YouTubeCreatorInsights cho nhà sáng tạo địa phương liên quan đến chủ đề của xu hướng đã đồng ý chia sẻ dữ liệu vị trí của họ. Chỉ được điền sẵn khi LOCAL_CREATOR_DATA được yêu cầu (xem phần Dữ liệu bổ sung, nhà sáng tạo tại địa phương và cảm nhận về thương hiệu).
  • brand_sentiment_insights: Danh sách các đối tượng BrandSentimentInsight cho xu hướng (được điền sẵn khi yêu cầu sử dụng search_topics cho một thực thể có chức năng BRAND và yêu cầu BRAND_SENTIMENT_DATA). Mỗi đối tượng BrandSentimentInsight chứa:
    • month: Tháng mà cảm nhận về thương hiệu thể hiện, theo định dạng YYYY-MM.
    • has_insufficient_data: Liệu có đủ dữ liệu để tính toán mức độ cảm tình với thương hiệu hay không.
    • sentiment_distributions: Phân bổ cảm nhận giữa tích cực, tiêu cực và trung lập, được tính bằng tỷ lệ lượt xem của các video tương ứng với thương hiệu theo từng cảm nhận.
    • sentiment_summaries: Bản tóm tắt do AI tạo về các chủ đề tích cực và tiêu cực trong nội dung liên quan đến thương hiệu, cùng với các video mẫu cho từng cảm xúc. Bản tóm tắt chỉ được tạo cho cảm nhận tích cực và tiêu cực, không tạo cho cảm nhận trung lập.

Gọi GenerateTrendingInsights trên ContentCreatorInsightsService tại điểm cuối sau:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateTrendingInsights

Bảng sau đây tóm tắt các trường trên GenerateTrendingInsightsRequest:

Đường dẫn trường Yêu cầu Định dạng và quy tắc ràng buộc
customer_id Bắt buộc Mã khách hàng gồm 10 chữ số (string) không có dấu gạch nối.
customer_insights_group Bắt buộc Tên do người dùng xác định (string) của khách hàng hoặc thương hiệu đang được lập kế hoạch.
country_location Bắt buộc Một quốc gia LocationInfo (geo_target_constant, chẳng hạn như "geoTargetConstants/2840").
sub_country_locations[] Không bắt buộc Bộ lọc LocationInfo theo quốc gia phụ; chỉ được hỗ trợ cho search_audience và không tương thích với LOCAL_CREATOR_DATA.
search_audience criteria (oneof) SearchAudience chứa:
• audience_attributes[] (bắt buộc): age_range, gender, parental_status, income_range (cộng với user_interest, entity hoặc category khi không sử dụng audience_combinations).
• audience_combinations[] (không bắt buộc): Nhóm thuộc tính AND-of-ORs.
search_topics criteria (oneof) SearchTopics chứa entities[] (AudienceInsightsEntity có knowledge_graph_machine_id được gắn thẻ CONTENT_TRENDING_INSIGHTS).
supplemental_data[] Không bắt buộc Giá trị ContentCreatorInsightsSupplementalData:
• LOCAL_CREATOR_DATA: Điền related_local_creators[] cho các thực thể search_topics bằng CREATOR_TOPIC_INSIGHTS.
• BRAND_SENTIMENT_DATA: Điền brand_sentiment_insights[] cho các thực thể search_topics bằng BRAND.
insights_application_info Không bắt buộc AdditionalApplicationInfo siêu dữ liệu về ứng dụng đưa ra yêu cầu.

Thông báo GenerateTrendingInsightsResponse trả về các mục TrendInsight trong trend_insights[]:

TrendInsight trường Loại Mô tả
trend_attribute AudienceInsightsAttributeMetadata Thuộc tính chính của xu hướng (dimension, display_name, attribute).
trend_metrics TrendInsightMetrics Các chỉ số trong khoảng thời gian so sánh 3 tháng (views_count và views_indexed_value cho search_topics; audience_share cho search_audience; trend_change_percent).
trend InsightsTrend Hướng của xu hướng (EMERGING, RISING, SUSTAINED hoặc DECLINING).
trend_data_points[] TrendInsightDataPoint Dữ liệu trong quá khứ hằng tháng (month ở định dạng YYYY-MM và trend_metrics); được điền sẵn cho search_topics.
related_videos[] AudienceInsightsAttributeMetadata Video thịnh hành có YouTubeVideoAttributeMetadata; được điền sẵn cho search_topics.
related_creators[] YouTubeCreatorInsights Nhà sáng tạo có liên quan đến chủ đề; được điền sẵn cho search_topics.
related_local_creators[] YouTubeCreatorInsights Nhà sáng tạo địa phương đồng ý; được điền sẵn cho search_topics khi LOCAL_CREATOR_DATA được yêu cầu trên một thực thể có CREATOR_TOPIC_INSIGHTS.
brand_sentiment_insights[] BrandSentimentInsight Cảm nhận hằng tháng về thương hiệu (month, has_insufficient_data, sentiment_distributions[], sentiment_summaries[]); được điền sẵn cho search_topics khi BRAND_SENTIMENT_DATA được yêu cầu trên một thực thể có chức năng BRAND.

Ví dụ sau đây gọi GenerateTrendingInsights bằng cách sử dụng searchTopics cho một thực thể thương hiệu trong Sơ đồ tri thức (/g/11example_brand, được gắn thẻ CONTENT_TRENDING_INSIGHTS, CREATOR_TOPIC_INSIGHTS và BRAND) và yêu cầu cả LOCAL_CREATOR_DATA và BRAND_SENTIMENT_DATA:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateTrendingInsights

{
  "customerInsightsGroup": "Spring Skincare Campaign",
  "countryLocation": {
    "geoTargetConstant": "geoTargetConstants/2840"
  },
  "supplementalData": [
    "LOCAL_CREATOR_DATA",
    "BRAND_SENTIMENT_DATA"
  ],
  "searchTopics": {
    "entities": [
      {
        "knowledgeGraphMachineId": "/g/11example_brand"
      }
    ]
  }
}

Một lệnh gọi GenerateTrendingInsightsResponse thành công sẽ trả về các mục nhập TrendInsight trong trendInsights[]:

{
  "trendInsights": [
    {
      "trendAttribute": {
        "dimension": "KNOWLEDGE_GRAPH",
        "displayName": "Example Skincare Brand",
        "attribute": {
          "entity": {
            "knowledgeGraphMachineId": "/g/11example_brand"
          }
        }
      },
      "trendMetrics": {
        "viewsCount": "18500000",
        "viewsIndexedValue": "82",
        "trendChangePercent": 0.24
      },
      "trend": "RISING",
      "trendDataPoints": [
        {
          "month": "2026-05",
          "trendMetrics": {
            "viewsCount": "18500000",
            "viewsIndexedValue": "82",
            "trendChangePercent": 0.08
          }
        }
      ],
      "brandSentimentInsights": [
        {
          "month": "2026-05",
          "hasInsufficientData": false,
          "sentimentDistributions": [
            {
              "sentiment": "SENTIMENT_POSITIVE",
              "sentimentShare": 0.68
            },
            {
              "sentiment": "SENTIMENT_NEUTRAL",
              "sentimentShare": 0.25
            },
            {
              "sentiment": "SENTIMENT_NEGATIVE",
              "sentimentShare": 0.07
            }
          ]
        }
      ],
      "relatedVideos": [],
      "relatedCreators": [],
      "relatedLocalCreators": []
    }
  ]
}

Trình theo dõi sự cố của Google

Sử dụng Trình theo dõi sự cố của Google để đặt câu hỏi hỗ trợ, báo cáo lỗi hoặc gửi yêu cầu về tính năng. Google theo dõi, ưu tiên và đăng thông tin cập nhật về yêu cầu của bạn ngay trong Trình theo dõi sự cố. Để biết thêm thông tin, hãy xem bài viết Tạo vấn đề trong Trình theo dõi sự cố của Google.

Tạo một vấn đề bằng cách sử dụng một trong các mẫu Trình theo dõi sự cố sau:

Điền thông tin chi tiết vào tất cả các trường trong mẫu để Google có thể tái hiện và ưu tiên yêu cầu của bạn. Google có thể đóng các báo cáo chưa hoàn chỉnh và yêu cầu bạn gửi một vấn đề mới kèm theo thông tin còn thiếu.

Trước
Thông tin chi tiết về đối tượng
Tiếp
Điểm chuẩn trên YouTube