Insight kreator YouTube

Temukan dan dapatkan insight tentang kreator YouTube dengan fitur insight kreator di ContentCreatorInsightsService. Layanan ini membantu agensi dan pengiklan menemukan kreator yang relevan dengan target audiens mereka.

API ini memiliki empat fungsi utama:

  1. Visibilitas kreator: Temukan kreator yang relevan untuk serangkaian topik, demografi, audiens, atau atribut kreator tertentu.
  2. Insight topik kreator: Mengambil insight tentang kreator relevan yang membuat konten tentang topik tertentu.
  3. Insight kreator: Mengambil insight tentang channel YouTube tertentu, seperti jumlah subscriber, jumlah penayangan, dan demografi audiens.
  4. Insight trending: Mengambil insight tentang tren tertentu, berdasarkan audiens atau topik tertentu.

Penemuan kreator lokal (menemukan kreator yang tinggal di atau memposting dari negara tertentu dan ditonton di negara tersebut) didukung saat menggunakan penemuan kreator berbasis topik atau insight trending dengan meminta data tambahan. Anda juga dapat meminta insight sentimen merek untuk insight trending berbasis topik dengan meminta data tambahan.

Persyaratan kelayakan

GenerateCreatorInsights adalah komponen pribadi Google Ads API yang ditawarkan dengan lisensi data non-eksklusif dan bebas royalti. Partner yang telah menandatangani perjanjian dapat menggunakan library klien Google Ads standar untuk mempelajari kreator YouTube dan konten. Agar memenuhi syarat, partner harus memenuhi kondisi berikut:

  • Memiliki alat perencanaan atau antarmuka pengguna yang mengintegrasikan Google Ads API.
  • Gunakan API untuk menjelajahi konten dan kreator YouTube guna menemukan peluang iklan yang potensial.
  • Selesaikan penilaian pra-seleksi untuk memverifikasi kelayakan.
  • Mengikuti persyaratan penggunaan data dan menjalani audit data berkala.
  • Setujui persyaratan layanan Google Ads API dan kebijakan penggunaan data terkait.

Hubungi perwakilan Google untuk mendapatkan informasi selengkapnya.

Membuat insight kreator

Untuk membuat insight kreator, kirim permintaan ke metode GenerateCreatorInsights. Metode ini memiliki batas 5 kueri per detik (QPS). Alat ini menerima kriteria yang berbeda bergantung pada apakah Anda menginginkan visibilitas kreator, penelusuran kreator berbasis topik, atau insight kreator khusus channel. Anda harus memberikan lokasi negara target di country_locations.

  1. Visibilitas kreator (search_attributes): Berikan daftar atribut audiens—seperti usia, gender, dan minat pengguna (audiens minat, berniat beli, dan peristiwa kehidupan)—menggunakan kolom search_attributes untuk menemukan kreator yang audiensnya cocok dengan atribut tersebut. Anda juga dapat memberikan atribut kreator untuk memfilter kreator yang kontennya cocok dengan atribut tertentu.

    Ambil atribut audiens yang tersedia menggunakan ListAudienceInsightsAttributes dengan menentukan dimensi yang Anda perlukan, seperti KNOWLEDGE_GRAPH untuk topik minat. Untuk menggabungkan atribut menggunakan grup boolean AND dan OR, gunakan audience_combinations seperti yang dijelaskan dalam Kombinasi audiens yang kompleks.

  2. Insight topik kreator (search_topics): Memberikan daftar topik konten menggunakan kolom search_topics. API akan menampilkan kreator relevan yang membuat konten tentang topik yang ditentukan. Data diambil untuk negara yang ditentukan di country_locations (opsi ini mendukung satu negara per permintaan).

    Entity yang didukung di search_topics harus diberi tag dengan kemampuan CONTENT_TRENDING_INSIGHTS atau CREATOR_TOPIC_INSIGHTS. Gunakan ListAudienceInsightsAttributes untuk mengambil kemampuan entity yang didukung.

  3. Insight kreator (search_channels): Berikan daftar ID channel YouTube, nama sebutan channel YouTube (youtube_channel_handles, tersedia di v25 dan yang lebih baru), atau kombinasi keduanya menggunakan kolom search_channels. API akan menampilkan insight tentang saluran tertentu tersebut.

Kombinasi audiens yang kompleks

Di GenerateCreatorInsights dan GenerateTrendingInsights, Anda dapat menentukan hubungan atribut audiens yang kompleks menggunakan audience_combinations. Kolom ini memungkinkan Anda menggabungkan atribut audiens dengan logika boolean (AND dan OR) di luar perilaku gabungan datar (OR) dari audience_attributes:

  • Setiap InsightsAudienceAttributeGroup dalam audience_combinations menggabungkan atributnya dengan OR logis.
  • Beberapa item InsightsAudienceAttributeGroup di audience_combinations digabungkan dengan AND logis.

Misalnya, untuk menarget audiens yang tertarik dengan ("Skin care" OR "Hair care") AND "Cosmetics", sertakan dua item InsightsAudienceAttributeGroup di audience_combinations:

  1. Grup 1 yang berisi atribut entitas Pustaka Pengetahuan untuk "Skin care" dan "Hair care".
  2. Grup 2 yang berisi atribut entitas Pustaka Pengetahuan untuk "Cosmetics" (seperti /m/014trl).

Data tambahan dan kreator lokal

Secara default, hanya data insight inti yang ditampilkan. Anda dapat meminta fitur opsional dan data tambahan dalam respons dengan menetapkan kolom berulang supplemental_data.

Misalnya, Anda dapat meminta data kreator lokal dengan menambahkan nilai enum LOCAL_CREATOR_DATA ke supplemental_data. Jika Anda menelusuri kreator menggunakan search_topics (dan topiknya adalah entitas Pustaka Pengetahuan yang diberi tag dengan kemampuan CREATOR_TOPIC_INSIGHTS), API akan mengisi kolom local_creator_insights dalam respons dengan kreator lokal yang telah mengizinkan untuk membagikan data lokasi mereka.

Perhatikan spesifikasi berikut untuk penemuan kreator lokal:

  • Definisi: Kreator lokal adalah kreator yang berbasis di atau memposting dari negara yang dipilih dan ditonton di negara tersebut.
  • Batasan: Penemuan kreator lokal tidak didukung jika sub_country_locations ditetapkan dalam permintaan.
  • Kemampuan: Anda dapat mengambil daftar entitas Pustaka Pengetahuan yang didukung dan kemampuannya menggunakan ListAudienceInsightsAttributes.

Metode GenerateCreatorInsights menampilkan objek GenerateCreatorInsightsResponse yang berisi kolom berikut:

  • creator_insights: Daftar objek YouTubeCreatorInsights yang cocok dengan kriteria inti Anda.
  • local_creator_insights: Daftar objek YouTubeCreatorInsights untuk kreator lokal. Kolom ini hanya diisi jika LOCAL_CREATOR_DATA diminta dan kriteria yang digunakan adalah search_topics.

Setiap objek YouTubeCreatorInsights berisi:

  • creator_name: Nama kreator.
  • creator_channels: Daftar objek YouTubeChannelInsights. Detail saluran dan channel_metrics (YouTubeMetrics) ditampilkan di dalam setiap objek YouTubeChannelInsights di creator_channels.

Objek YouTubeMetrics berisi:

  • Jumlah subscriber, penayangan, dan video
  • Jumlah total suka, bagikan, dan komentar di semua video channel
  • Rasio engagement sepanjang waktu (total engagement dibagi total penayangan)
  • Rata-rata penayangan, suka, berbagi, dan komentar per video selama 28 hari terakhir
  • Jumlah penayangan dan video Shorts
  • Apakah kreator tersebut adalah kreator Shorts aktif atau kreator livestream aktif (telah memublikasikan satu video dalam 90 hari terakhir)
  • Peluang kemitraan

Rasio interaksi dan rata-rata penayangan, suka, dan komentar per video adalah metrik non-publik yang hanya diisi jika kreator telah mengizinkan untuk membagikannya.

Untuk memeriksa apakah kreator memenuhi syarat untuk kemitraan konten bermerek asli, periksa partnership_opportunities; kreator memenuhi syarat jika daftar berisi CREATOR_PARTNERSHIPS.

Objek YouTubeChannelInsights berisi informasi berikut tentang channel YouTube:

  • Nama, ID, nama sebutan channel, URL, deskripsi, dan URL thumbnail channel
  • Tanggal pembuatan channel dan negara terkait
  • Metrik channel
  • Atribut audiens channel (seperti usia, gender, dan pengelompokan minat pengguna)
  • Atribut channel (atribut yang terkait dengan konten channel)
  • Video teratas
  • Jenis channel dan bahasa konten
  • Skor relevansi (hanya untuk penelusuran tren topik)
  • Apakah kreator telah memberikan izin untuk membagikan metrik non-publik

Referensi permintaan dan respons GenerateCreatorInsights

Panggil GenerateCreatorInsights di ContentCreatorInsightsService pada endpoint berikut:

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

Tabel berikut merangkum kolom di GenerateCreatorInsightsRequest:

Jalur kolom Persyaratan Format dan batasan
customer_id Wajib ID pelanggan 10 digit (string) tanpa tanda hubung.
customer_insights_group Wajib Nama yang ditentukan pengguna (string) untuk pelanggan atau merek yang direncanakan.
country_locations[] Wajib Daftar objek LocationInfo negara (geo_target_constant, seperti "geoTargetConstants/2840"). Harus berisi satu negara saat search_topics digunakan.
sub_country_locations[] Opsional Filter subnegara LocationInfo; hanya didukung dengan search_attributes dan tidak kompatibel dengan LOCAL_CREATOR_DATA.
search_attributes criteria (oneof) SearchAttributes yang berisi:
• audience_attributes[]: age_range, gender, device, parental_status, income_range (ditambah user_interest, entity, atau category jika audience_combinations tidak digunakan).
• audience_combinations[]: Item AND-of-OR InsightsAudienceAttributeGroup.
• creator_attributes[]: Item entity Knowledge Graph dengan kemampuan CREATOR_ATTRIBUTE.
search_topics criteria (oneof) SearchTopics yang berisi entities[] (AudienceInsightsEntity dengan knowledge_graph_machine_id yang diberi tag dengan CREATOR_TOPIC_INSIGHTS atau CONTENT_TRENDING_INSIGHTS).
search_channels criteria (oneof) YouTubeChannels yang berisi youtube_channels[] (channel_id) dan/atau youtube_channel_handles[] (nama sebutan channel yang diawali dengan @, seperti "@youtubecreators").
supplemental_data[] Opsional Nilai ContentCreatorInsightsSupplementalData. Tetapkan LOCAL_CREATOR_DATA pada permintaan search_topics satu negara (untuk entitas dengan CREATOR_TOPIC_INSIGHTS) untuk mengisi local_creator_insights[].
insights_application_info Opsional Metadata AdditionalApplicationInfo tentang aplikasi yang mengeluarkan permintaan.

Pesan GenerateCreatorInsightsResponse menampilkan kolom berikut:

Kolom respons Jenis Deskripsi
creator_insights[] YouTubeCreatorInsights Kreator yang cocok dengan kriteria inti Anda (creator_name dan creator_channels[]).
local_creator_insights[] YouTubeCreatorInsights Kreator lokal yang mengizinkan untuk membagikan data lokasi (diisi saat LOCAL_CREATOR_DATA diminta dengan search_topics pada entitas dengan CREATOR_TOPIC_INSIGHTS).
creator_channels[] YouTubeChannelInsights Metadata: display_name, youtube_channel.channel_id, handle, channel_url, publish_date, country_location, dan data_sharing_consent_given.
Insight & konten: channel_audience_attributes[] (dibatasi izin), channel_attributes[], top_videos[], language_distributions[], relevance_score (hanya diisi untuk GenerateTrendingInsights dengan search_topics), dan channel_metrics.
channel_metrics YouTubeMetrics Metrik publik: 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, dan partnership_opportunities[].
Metrik yang memerlukan izin: engagement_rate dan rata-rata per video selama 28 hari (average_views_per_video, average_likes_per_video, average_shares_per_video, average_comments_per_video).

Contoh permintaan dan respons REST GenerateCreatorInsights

Contoh berikut menemukan kreator menggunakan searchAttributes dengan demografi audienceAttributes, boolean audienceCombinations ("Skin care" OR "Hair care", AND "Cosmetics"), dan 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"
        }
      }
    ]
  }
}

Untuk mengambil kreator berbasis topik bersama dengan kreator lokal, gunakan searchTopics dan sertakan "LOCAL_CREATOR_DATA" di 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"
      }
    ]
  }
}

Untuk mengambil insight untuk channel YouTube tertentu berdasarkan ID channel atau nama sebutan channel, gunakan 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 yang berhasil akan menampilkan creatorInsights[] (dan localCreatorInsights[] saat LOCAL_CREATOR_DATA diminta):

{
  "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": []
}

Untuk membuat insight tren, kirim permintaan ke metode GenerateTrendingInsights. Metode ini memiliki batas 5 kueri per detik (QPS). Metode ini menerima dua jenis input, bergantung pada apakah Anda menginginkan tren audiens atau tren topik, dan memerlukan lokasi negara target.

  1. Tren audiens (search_audience): Berikan daftar atribut audiens (seperti usia, gender, dan minat pengguna) di kolom audience_attributes dari search_audience dan, secara opsional, gunakan audience_combinations untuk menggabungkan atribut dengan logika boolean AND/OR. API akan menampilkan daftar insight yang sedang tren untuk audiens tersebut, termasuk metrik seperti perubahan persentase dalam nilai tren selama periode perbandingan.

    Developer yang memiliki akses ke ContentCreatorInsightsService memiliki akses otomatis ke ListAudienceInsightsAttributes di AudienceInsightsService (lihat Panduan analisis audiens). Endpoint lain di AudienceInsightsService memerlukan daftar yang diizinkan terpisah.

  2. Tren topik (search_topics): Berikan daftar topik konten di kolom search_topics. API ini menampilkan insight tren untuk topik tersebut, termasuk persentase perubahan nilai tren selama periode perbandingan. Anda juga dapat meminta insight sentimen merek atau kreator lokal dengan menetapkan supplemental_data.

    Atribut KNOWLEDGE_GRAPH yang ditampilkan oleh ListAudienceInsightsAttributes menyertakan satu atau beberapa tag InsightsKnowledgeGraphEntityCapabilities; entitas yang diberi tag CONTENT_TRENDING_INSIGHTS didukung sebagai topik di GenerateTrendingInsights.

Serupa dengan membuat insight kreator, Anda dapat meminta fitur opsional dalam insight trending dengan menetapkan kolom berulang supplemental_data ke LOCAL_CREATOR_DATA atau BRAND_SENTIMENT_DATA:

  • Kreator lokal (LOCAL_CREATOR_DATA): Jika permintaan trending Anda menggunakan search_topics (dan topiknya adalah entitas Pustaka Pengetahuan yang diberi tag dengan kemampuan CREATOR_TOPIC_INSIGHTS), menetapkan supplemental_data ke LOCAL_CREATOR_DATA akan mengisi kolom related_local_creators pada objek TrendInsight yang ditampilkan dengan kreator lokal terkait yang telah mengizinkan untuk membagikan data lokasi mereka. Penemuan kreator lokal tidak kompatibel dengan sub_country_locations.
  • Sentimen merek (BRAND_SENTIMENT_DATA): Jika permintaan trending Anda menggunakan search_topics dan topik entitas Pustaka Pengetahuan yang diminta memiliki kemampuan BRAND, menetapkan supplemental_data ke BRAND_SENTIMENT_DATA akan mengisi kolom brand_sentiment_insights pada objek TrendInsight yang ditampilkan.

Pengukuran sentimen merek menggunakan model AI Gemini untuk menganalisis konten video YouTube yang terkait dengan merek, mengategorikan sentimen sebagai positif, negatif, atau netral. Hanya konten video itu sendiri yang dianalisis; komentar pengguna tidak disertakan.

Metode GenerateTrendingInsights menampilkan daftar objek TrendInsight, yang masing-masing berisi:

  • trend_attribute: AudienceInsightsAttributeMetadata utama untuk tren.
  • trend_metrics: Metrik untuk tren, seperti perubahan persentase selama periode perbandingan.
  • trend: Nilai InsightsTrend (EMERGING, RISING, SUSTAINED, atau DECLINING) yang menunjukkan arah tren. Lihat trend_metrics.trend_change_percent untuk mengetahui ukuran perubahan.
  • trend_data_points: Titik data historis untuk tren. Hanya diisi untuk tren yang menggunakan search_topics.
  • related_videos: Daftar objek AudienceInsightsAttributeMetadata untuk video trending yang terkait dengan topik tren (hanya diisi untuk tren yang menggunakan search_topics). Untuk atribut ini, YouTubeVideoAttributeMetadata bertingkat diisi dengan metadata tingkat video (URL, URL thumbnail, jumlah penayangan dan suka) dan metadata tingkat channel (ID, nama, dan URL channel).
  • related_creators: Daftar objek YouTubeCreatorInsights untuk kreator yang terkait dengan topik tren (hanya diisi untuk tren yang menggunakan search_topics).
  • related_local_creators: Daftar objek YouTubeCreatorInsights untuk kreator lokal yang terkait dengan topik tren yang telah mengizinkan untuk membagikan data lokasi mereka. Hanya diisi saat LOCAL_CREATOR_DATA diminta (lihat Data tambahan, kreator lokal, dan sentimen merek).
  • brand_sentiment_insights: Daftar objek BrandSentimentInsight untuk tren (diisi saat permintaan menggunakan search_topics untuk entity dengan kemampuan BRAND dan meminta BRAND_SENTIMENT_DATA). Setiap objek BrandSentimentInsight berisi:
    • month: Bulan yang diwakili oleh sentimen merek dalam format YYYY-MM.
    • has_insufficient_data: Apakah data tidak cukup untuk menghitung sentimen merek.
    • sentiment_distributions: Distribusi sentimen antara positif, negatif, dan netral, yang dihitung sebagai proporsi penayangan untuk video yang sesuai dengan merek dengan setiap sentimen.
    • sentiment_summaries: Ringkasan buatan AI tentang tema positif dan negatif dalam konten yang terkait dengan brand, beserta video sampel untuk setiap sentimen. Ringkasan hanya dibuat untuk sentimen positif dan negatif, bukan netral.

Panggil GenerateTrendingInsights di ContentCreatorInsightsService pada endpoint berikut:

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

Tabel berikut merangkum kolom di GenerateTrendingInsightsRequest:

Jalur kolom Persyaratan Format dan batasan
customer_id Wajib ID pelanggan 10 digit (string) tanpa tanda hubung.
customer_insights_group Wajib Nama yang ditentukan pengguna (string) untuk pelanggan atau merek yang direncanakan.
country_location Wajib Satu negara LocationInfo (geo_target_constant, seperti "geoTargetConstants/2840").
sub_country_locations[] Opsional Filter sub-negara LocationInfo; hanya didukung untuk search_audience dan tidak kompatibel dengan LOCAL_CREATOR_DATA.
search_audience criteria (oneof) SearchAudience yang berisi:
• audience_attributes[] (wajib): age_range, gender, parental_status, income_range (ditambah user_interest, entity, atau category jika audience_combinations tidak digunakan).
• audience_combinations[] (opsional): Grup atribut AND-of-OR.
search_topics criteria (oneof) SearchTopics yang berisi entities[] (AudienceInsightsEntity dengan knowledge_graph_machine_id yang diberi tag dengan CONTENT_TRENDING_INSIGHTS).
supplemental_data[] Opsional Nilai ContentCreatorInsightsSupplementalData:
• LOCAL_CREATOR_DATA: Mengisi related_local_creators[] untuk entity search_topics dengan CREATOR_TOPIC_INSIGHTS.
• BRAND_SENTIMENT_DATA: Mengisi brand_sentiment_insights[] untuk entity search_topics dengan BRAND.
insights_application_info Opsional Metadata AdditionalApplicationInfo tentang aplikasi yang mengeluarkan permintaan.

Pesan GenerateTrendingInsightsResponse menampilkan entri TrendInsight di trend_insights[]:

Kolom TrendInsight Jenis Deskripsi
trend_attribute AudienceInsightsAttributeMetadata Atribut utama untuk tren (dimension, display_name, attribute).
trend_metrics TrendInsightMetrics Metrik selama periode perbandingan 3 bulan (views_count dan views_indexed_value untuk search_topics; audience_share untuk search_audience; trend_change_percent).
trend InsightsTrend Arah tren (EMERGING, RISING, SUSTAINED, atau DECLINING).
trend_data_points[] TrendInsightDataPoint Data historis bulanan (month dalam format YYYY-MM dan trend_metrics); diisi untuk search_topics.
related_videos[] AudienceInsightsAttributeMetadata Video trending dengan YouTubeVideoAttributeMetadata; diisi untuk search_topics.
related_creators[] YouTubeCreatorInsights Kreator yang terkait dengan topik; diisi untuk search_topics.
related_local_creators[] YouTubeCreatorInsights Kreator lokal yang memberikan izin; diisi untuk search_topics saat LOCAL_CREATOR_DATA diminta pada entitas dengan CREATOR_TOPIC_INSIGHTS.
brand_sentiment_insights[] BrandSentimentInsight Sentimen merek bulanan (month, has_insufficient_data, sentiment_distributions[], sentiment_summaries[]); diisi untuk search_topics saat BRAND_SENTIMENT_DATA diminta pada entitas dengan kemampuan BRAND.

Contoh berikut memanggil GenerateTrendingInsights menggunakan searchTopics untuk entitas merek Pustaka Pengetahuan (/g/11example_brand, yang diberi tag dengan CONTENT_TRENDING_INSIGHTS, CREATOR_TOPIC_INSIGHTS, dan BRAND) dan meminta LOCAL_CREATOR_DATA dan 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"
      }
    ]
  }
}

GenerateTrendingInsightsResponse yang berhasil menampilkan entri TrendInsight di 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": []
    }
  ]
}

Google Issue Tracker

Gunakan Issue Tracker Google untuk mengajukan pertanyaan dukungan, melaporkan bug, atau mengirimkan permintaan fitur. Google melacak, memprioritaskan, dan memposting info terbaru tentang permintaan Anda langsung di Issue Tracker. Untuk mengetahui informasi selengkapnya, lihat Membuat laporan masalah di Issue Tracker Google.

Laporkan masalah menggunakan salah satu template Issue Tracker berikut:

Isi semua kolom dalam template dengan informasi mendetail agar Google dapat mereproduksi dan memprioritaskan permintaan Anda. Google mungkin akan menutup laporan yang tidak lengkap dan meminta Anda mengirimkan masalah baru dengan detail yang tidak ada.

Sebelumnya
Analisis audiens
Berikutnya
Tolok ukur YouTube