Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

ข้อมูลเชิงลึกสำหรับครีเอเตอร์ YouTube

ค้นพบและดึงข้อมูลเชิงลึกเกี่ยวกับครีเอเตอร์ YouTube ด้วยฟีเจอร์ข้อมูลเชิงลึกเกี่ยวกับครีเอเตอร์ใน ContentCreatorInsightsService บริการนี้ช่วยให้เอเจนซีและผู้ลงโฆษณาค้นหาครีเอเตอร์ที่เกี่ยวข้องกับกลุ่มเป้าหมายของตนได้

API มีฟังก์ชันหลัก 4 อย่างดังนี้

โอกาสในการถูกค้นพบของครีเอเตอร์: ค้นหาครีเอเตอร์ที่เกี่ยวข้องสำหรับชุดหัวข้อ ข้อมูลประชากร กลุ่มเป้าหมาย หรือแอตทริบิวต์ของครีเอเตอร์ที่กำหนด
ข้อมูลเชิงลึกเกี่ยวกับหัวข้อของครีเอเตอร์: ดึงข้อมูลเชิงลึกเกี่ยวกับครีเอเตอร์ที่เกี่ยวข้องซึ่งสร้างเนื้อหาเกี่ยวกับหัวข้อที่ระบุ
ข้อมูลเชิงลึกของครีเอเตอร์: ดึงข้อมูลเชิงลึกเกี่ยวกับช่อง YouTube ที่เฉพาะเจาะจง เช่น จำนวนผู้ติดตาม ยอดดู และข้อมูลประชากรของผู้ชม
ข้อมูลเชิงลึกเกี่ยวกับเทรนด์ที่มาแรง: ดึงข้อมูลเชิงลึกเกี่ยวกับเทรนด์ที่เฉพาะเจาะจงโดยอิงตามกลุ่มเป้าหมายหรือหัวข้อที่เฉพาะเจาะจง

ระบบรองรับการค้นพบครีเอเตอร์ในพื้นที่ (การค้นหาครีเอเตอร์ที่อาศัยอยู่ในหรือโพสต์จากประเทศหนึ่งๆ และมีผู้ชมในประเทศนั้น) เมื่อใช้การค้นพบครีเอเตอร์ตามหัวข้อหรือข้อมูลเชิงลึกเกี่ยวกับเทรนด์โดยการขอข้อมูลเสริม นอกจากนี้ คุณยังขอข้อมูลเชิงลึกเกี่ยวกับความรู้สึกต่อแบรนด์สำหรับข้อมูลเชิงลึกเกี่ยวกับเทรนด์ตามหัวข้อได้ด้วยการขอข้อมูลเสริม

ข้อกำหนดของการได้รับสิทธิ์

GenerateCreatorInsights เป็นคอมโพเนนต์ส่วนตัวของ Google Ads API ที่เสนอให้พร้อมใบอนุญาตข้อมูลแบบไม่เฉพาะตัวและไม่มีค่าสิทธิ พาร์ทเนอร์ที่ลงชื่อเข้าใช้สามารถใช้ไลบรารีของไคลเอ็นต์ Google Ads มาตรฐานเพื่อสำรวจครีเอเตอร์และเนื้อหา YouTube พาร์ทเนอร์ต้องมีคุณสมบัติตรงตามเงื่อนไขต่อไปนี้จึงจะมีสิทธิ์

มีเครื่องมือวางแผนหรืออินเทอร์เฟซผู้ใช้ที่ผสานรวม Google Ads API
ใช้ API เพื่อสำรวจเนื้อหาและครีเอเตอร์ YouTube เพื่อหาโอกาสในการโฆษณาที่อาจเกิดขึ้น
ทำการประเมินก่อนคัดกรองเพื่อยืนยันการมีสิทธิ์
ปฏิบัติตามข้อกำหนดการใช้ข้อมูลและเข้ารับการตรวจสอบข้อมูลเป็นระยะ
ยอมรับข้อกำหนดในการให้บริการของ Google Ads API และนโยบายการใช้งานข้อมูลที่เกี่ยวข้อง

โปรดติดต่อตัวแทนของ Google เพื่อขอข้อมูลเพิ่มเติม

สร้างข้อมูลเชิงลึกของครีเอเตอร์

หากต้องการสร้างข้อมูลเชิงลึกของครีเอเตอร์ ให้ส่งคำขอไปยังเมธอด GenerateCreatorInsights วิธีนี้มีขีดจำกัดจำนวนคำค้นหาต่อวินาที (QPS) อยู่ที่ 5 รายการ โดยจะยอมรับเกณฑ์ที่แตกต่างกันไปตามความต้องการของคุณ ไม่ว่าจะเป็นโอกาสในการถูกค้นพบของครีเอเตอร์ การค้นหาครีเอเตอร์ตามหัวข้อ หรือข้อมูลเชิงลึกของครีเอเตอร์เฉพาะช่อง คุณต้องระบุสถานที่ตั้งของประเทศเป้าหมายใน country_locations

โอกาสในการถูกค้นพบของครีเอเตอร์ (search_attributes): ระบุรายการแอตทริบิวต์ของกลุ่มเป้าหมาย เช่น อายุ เพศ และความสนใจของผู้ใช้ (กลุ่มเป้าหมายตามกลุ่มความสนใจ กลุ่มเป้าหมายที่มีแผนจะซื้อ และกลุ่มเป้าหมายตามเหตุการณ์สำคัญในชีวิต) โดยใช้ช่อง search_attributes เพื่อค้นหาครีเอเตอร์ที่มีกลุ่มเป้าหมายตรงกับแอตทริบิวต์เหล่านั้น นอกจากนี้ คุณยังระบุแอตทริบิวต์ของครีเอเตอร์เพื่อกรองหาครีเอเตอร์ที่มีเนื้อหาตรงกับแอตทริบิวต์ที่เฉพาะเจาะจงได้ด้วย

ดึงข้อมูลแอตทริบิวต์กลุ่มเป้าหมายที่ใช้ได้โดยใช้ ListAudienceInsightsAttributes โดยระบุมิติข้อมูลที่ต้องการ เช่น KNOWLEDGE_GRAPH สำหรับหัวข้อที่สนใจ หากต้องการรวมแอตทริบิวต์โดยใช้กลุ่มบูลีน AND และ OR ให้ใช้ audience_combinations ตามที่อธิบายไว้ในการรวมกลุ่มเป้าหมายที่ซับซ้อน
ข้อมูลเชิงลึกเกี่ยวกับหัวข้อของครีเอเตอร์ (search_topics): แสดงรายการหัวข้อเนื้อหาโดยใช้ช่อง search_topics API จะแสดงผลครีเอเตอร์ที่เกี่ยวข้องซึ่งสร้างเนื้อหาเกี่ยวกับหัวข้อที่ระบุ ระบบจะดึงข้อมูลของประเทศที่ระบุใน country_locations (ตัวเลือกนี้รองรับ 1 ประเทศต่อคำขอ)

เอนทิตีที่รองรับใน search_topics ต้องติดแท็กด้วยความสามารถ CONTENT_TRENDING_INSIGHTS หรือ CREATOR_TOPIC_INSIGHTS ใช้ ListAudienceInsightsAttributes เพื่อดึงข้อมูลความสามารถของเอนทิตีที่รองรับ

หมายเหตุ: ตัวเลือก search_brand เลิกใช้งานแล้วใน v24 และนำออกใน v25 โปรดใช้ search_topics แทน
ข้อมูลเชิงลึกเกี่ยวกับครีเอเตอร์ (search_channels): ระบุรายการรหัสช่อง YouTube, แฮนเดิลของช่อง YouTube (youtube_channel_handles พร้อมใช้งานใน v25 และใหม่กว่า) หรือทั้ง 2 อย่างรวมกันโดยใช้ช่อง search_channels API จะแสดงข้อมูลเชิงลึกเกี่ยวกับช่องทางที่เฉพาะเจาะจงเหล่านั้น

การรวมกลุ่มเป้าหมายที่ซับซ้อน

ทั้งใน GenerateCreatorInsights และ GenerateTrendingInsights คุณสามารถกำหนดความสัมพันธ์ของแอตทริบิวต์กลุ่มเป้าหมายที่ซับซ้อนได้โดยใช้ audience_combinations ช่องนี้ช่วยให้คุณรวมแอตทริบิวต์กลุ่มเป้าหมายเข้ากับตรรกะบูลีน (AND และ OR) นอกเหนือจากลักษณะการทำงานแบบรวม (OR) ของ audience_attributes ได้ ดังนี้

InsightsAudienceAttributeGroup แต่ละรายการภายใน audience_combinations จะรวมแอตทริบิวต์เข้ากับ OR เชิงตรรกะ
ระบบจะรวมรายการ InsightsAudienceAttributeGroup หลายรายการใน audience_combinations เข้ากับ AND เชิงตรรกะ

เช่น หากต้องการกำหนดเป้าหมายเป็นกลุ่มเป้าหมายที่สนใจ ("Skin care" OR "Hair care") AND "Cosmetics" ให้ใส่รายการ InsightsAudienceAttributeGroup 2 รายการใน audience_combinations ดังนี้

กลุ่มที่ 1 มีแอตทริบิวต์เอนทิตีของกราฟความรู้สำหรับ "Skin care" และ "Hair care"
กลุ่มที่ 2 มีแอตทริบิวต์เอนทิตีกราฟความรู้สำหรับ "Cosmetics" (เช่น /m/014trl)

ข้อมูลเสริมและครีเอเตอร์ในพื้นที่

โดยค่าเริ่มต้น ระบบจะแสดงเฉพาะข้อมูลเชิงลึกหลักเท่านั้น คุณสามารถขอฟีเจอร์ที่ไม่บังคับและข้อมูลเพิ่มเติมในการตอบกลับได้โดยตั้งค่าฟิลด์ที่ซ้ำได้ supplemental_data

ตัวอย่างเช่น คุณสามารถขอข้อมูลครีเอเตอร์ในพื้นที่ได้โดยเพิ่มค่า enum LOCAL_CREATOR_DATA ลงใน supplemental_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 แต่ละรายการประกอบด้วยข้อมูลต่อไปนี้

creator_name: ชื่อของผู้สร้าง
creator_channels: รายการออบเจ็กต์ YouTubeChannelInsights รายการ ระบบจะแสดงรายละเอียดช่องและ channel_metrics (YouTubeMetrics) ภายในออบเจ็กต์ YouTubeChannelInsights แต่ละรายการใน creator_channels

ออบเจ็กต์ YouTubeMetrics ประกอบด้วยข้อมูลต่อไปนี้

จำนวนผู้ติดตาม ยอดดู และวิดีโอ
จำนวนการกดชอบ การแชร์ และความคิดเห็นทั้งหมดในวิดีโอทั้งหมดของช่อง
อัตราการมีส่วนร่วมตลอดอายุการใช้งาน (การมีส่วนร่วมทั้งหมดหารด้วยยอดดูทั้งหมด)
ยอดดู การกดชอบ การแชร์ และความคิดเห็นโดยเฉลี่ยต่อวิดีโอในช่วง 28 วันที่ผ่านมา
ยอดดู Shorts และจำนวนวิดีโอ
ครีเอเตอร์เป็นครีเอเตอร์ Shorts ที่ใช้งานอยู่หรือครีเอเตอร์ไลฟ์สดที่ใช้งานอยู่ (เผยแพร่เนื้อหาอย่างน้อย 1 รายการในช่วง 90 วันที่ผ่านมา)
โอกาสในการเป็นพาร์ทเนอร์

อัตราการมีส่วนร่วม รวมถึงยอดดู การกดชอบ และความคิดเห็นโดยเฉลี่ยต่อวิดีโอเป็นเมตริกที่ไม่เปิดเผยต่อสาธารณะ ซึ่งจะแสดงก็ต่อเมื่อครีเอเตอร์ยินยอมที่จะแชร์เท่านั้น

หากต้องการตรวจสอบว่าครีเอเตอร์มีสิทธิ์เป็นพาร์ทเนอร์เนื้อหาที่สร้างร่วมกับแบรนด์ที่เป็นต้นฉบับหรือไม่ ให้ตรวจสอบ partnership_opportunities โดยครีเอเตอร์จะมีสิทธิ์หากรายการมี CREATOR_PARTNERSHIPS

ออบเจ็กต์ YouTubeChannelInsights มีข้อมูลต่อไปนี้เกี่ยวกับช่อง YouTube

ชื่อช่อง, รหัส, แฮนเดิล, URL, คำอธิบาย และ URL ของภาพปก
วันที่สร้างช่องและประเทศที่เชื่อมโยง
เมตริกของช่อง
แอตทริบิวต์กลุ่มเป้าหมายของช่อง (เช่น รายละเอียดอายุ เพศ และความสนใจของผู้ใช้)
แอตทริบิวต์ของช่อง (แอตทริบิวต์ที่เชื่อมโยงกับเนื้อหาของช่อง)
วิดีโอยอดนิยม
ประเภทช่องและภาษาของเนื้อหา
คะแนนความเกี่ยวข้อง (สำหรับการค้นหาเทรนด์หัวข้อเท่านั้น)
ครีเอเตอร์ให้ความยินยอมในการแชร์เมตริกที่ไม่เป็นสาธารณะหรือไม่

ข้อมูลอ้างอิงคำขอและการตอบกลับของ `GenerateCreatorInsights`

โทรหา GenerateCreatorInsights ที่ ContentCreatorInsightsService ที่ปลายทางต่อไปนี้

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

ตารางต่อไปนี้จะสรุปช่องต่างๆ ใน GenerateCreatorInsightsRequest

เส้นทางช่อง	ข้อกำหนด	รูปแบบและข้อจำกัด
`customer_id`	ต้องระบุ	รหัสลูกค้า 10 หลัก (`string`) ที่ไม่มีขีดกลาง
`customer_insights_group`	ต้องระบุ	ชื่อที่ผู้ใช้กำหนด (`string`) ของลูกค้าหรือแบรนด์ที่วางแผนไว้
`country_locations[]`	ต้องระบุ	รายการออบเจ็กต์ `LocationInfo` ของประเทศ (`geo_target_constant` เช่น `"geoTargetConstants/2840"`) ต้องมีประเทศเดียวเมื่อใช้ `search_topics`
`sub_country_locations[]`	ไม่บังคับ	ตัวกรองระดับย่อยของประเทศ `LocationInfo` รองรับเฉพาะ `search_attributes` และใช้ร่วมกับ `LOCAL_CREATOR_DATA` ไม่ได้
`search_attributes`	`criteria` (`oneof`)	`SearchAttributes` ที่มีข้อมูลต่อไปนี้ • `audience_attributes[]`: `age_range`, `gender`, `device`, `parental_status`, `income_range` (รวมถึง `user_interest`, `entity` หรือ `category` เมื่อไม่ได้ใช้ `audience_combinations`) • `audience_combinations[]`: AND-of-ORs `InsightsAudienceAttributeGroup` รายการ • `creator_attributes[]`: รายการกราฟความรู้ `entity` รายการที่มีความสามารถ `CREATOR_ATTRIBUTE`
`search_topics`	`criteria` (`oneof`)	`SearchTopics` ที่มี `entities[]` (`AudienceInsightsEntity` ที่มี `knowledge_graph_machine_id` ซึ่งติดแท็กด้วย `CREATOR_TOPIC_INSIGHTS` หรือ `CONTENT_TRENDING_INSIGHTS`)
`search_channels`	`criteria` (`oneof`)	`YouTubeChannels` ที่มี `youtube_channels[]` (`channel_id`) และ/หรือ `youtube_channel_handles[]` (แฮนเดิลที่ขึ้นต้นด้วย `@` เช่น `"@youtubecreators"`)
`supplemental_data[]`	ไม่บังคับ	`ContentCreatorInsightsSupplementalData` ค่า ตั้งค่า `LOCAL_CREATOR_DATA` ในคำขอ `search_topics` สำหรับประเทศเดียว (สำหรับเอนทิตีที่มี `CREATOR_TOPIC_INSIGHTS`) เพื่อป้อนข้อมูล `local_creator_insights[]`
`insights_application_info`	ไม่บังคับ	ข้อมูลเมตา `AdditionalApplicationInfo` เกี่ยวกับแอปพลิเคชันที่ส่งคำขอ

ข้อความ GenerateCreatorInsightsResponse จะแสดงผลช่องต่อไปนี้

ช่องคําตอบ	ประเภท	คำอธิบาย
`creator_insights[]`	`YouTubeCreatorInsights`	ครีเอเตอร์ที่ตรงกับเกณฑ์หลักของคุณ (`creator_name` และ `creator_channels[]`)
`local_creator_insights[]`	`YouTubeCreatorInsights`	ครีเอเตอร์ในพื้นที่ที่ยินยอมให้แชร์ข้อมูลตำแหน่ง (ป้อนข้อมูลเมื่อมีการขอ `LOCAL_CREATOR_DATA` พร้อม `search_topics` ในเอนทิตีที่มี `CREATOR_TOPIC_INSIGHTS`)
`creator_channels[]`	`YouTubeChannelInsights`	ข้อมูลเมตา: `display_name`, `youtube_channel.channel_id`, `handle`, `channel_url`, `publish_date`, `country_location` และ `data_sharing_consent_given` ข้อมูลเชิงลึกและเนื้อหา: `channel_audience_attributes[]` (จำกัดด้วยความยินยอม), `channel_attributes[]`, `top_videos[]`, `language_distributions[]`, `relevance_score` (ป้อนข้อมูลสำหรับ `GenerateTrendingInsights` ที่มี `search_topics` เท่านั้น) และ `channel_metrics`
`channel_metrics`	`YouTubeMetrics`	เมตริกสาธารณะ: `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` และ `partnership_opportunities[]` เมตริกที่ต้องได้รับความยินยอม: `engagement_rate` และค่าเฉลี่ยต่อวิดีโอในระยะเวลา 28 วัน (`average_views_per_video`, `average_likes_per_video`, `average_shares_per_video`, `average_comments_per_video`)

ตัวอย่างคำขอและการตอบกลับ REST ของ `GenerateCreatorInsights`

ตัวอย่างต่อไปนี้จะค้นหาครีเอเตอร์ที่ใช้ searchAttributes โดยมีข้อมูลประชากร audienceAttributes, บูลีน audienceCombinations ("Skin care" OR "Hair care", AND "Cosmetics") และ 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"
        }
      }
    ]
  }
}

หากต้องการดึงข้อมูลครีเอเตอร์ตามหัวข้อพร้อมกับครีเอเตอร์ในพื้นที่ ให้ใช้ searchTopics และใส่ "LOCAL_CREATOR_DATA" ใน 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"
      }
    ]
  }
}

หากต้องการดึงข้อมูลเชิงลึกสำหรับช่อง YouTube ที่เฉพาะเจาะจงตามรหัสช่องหรือแฮนเดิล ให้ใช้ 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 ที่สำเร็จจะแสดงผลเป็น creatorInsights[] (และ localCreatorInsights[] เมื่อมีการขอ LOCAL_CREATOR_DATA) ดังนี้

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

หากต้องการสร้างข้อมูลเชิงลึกเกี่ยวกับเทรนด์ ให้ส่งคำขอไปยังเมธอด GenerateTrendingInsights วิธีนี้มีขีดจำกัดจำนวนคำค้นหาต่อวินาที (QPS) อยู่ที่ 5 รายการ โดยจะยอมรับอินพุต 2 ประเภทขึ้นอยู่กับว่าคุณต้องการเทรนด์กลุ่มเป้าหมายหรือเทรนด์หัวข้อ และต้องระบุสถานที่ตั้งของประเทศเป้าหมาย

เทรนด์กลุ่มเป้าหมาย (search_audience): ระบุรายการแอตทริบิวต์กลุ่มเป้าหมาย (เช่น อายุ เพศ และความสนใจของผู้ใช้) ในช่อง audience_attributes ของ search_audience และใช้ audience_combinations เพื่อรวมแอตทริบิวต์กับตรรกะบูลีน AND/OR (ไม่บังคับ) API จะแสดงรายการข้อมูลเชิงลึกเกี่ยวกับเทรนด์สําหรับกลุ่มเป้าหมายเหล่านั้น รวมถึงเมตริกต่างๆ เช่น เปอร์เซ็นต์การเปลี่ยนแปลงของมูลค่าเทรนด์ในช่วงระยะเวลาเปรียบเทียบ

นักพัฒนาแอปที่มีสิทธิ์เข้าถึง ContentCreatorInsightsService จะมีสิทธิ์เข้าถึง ListAudienceInsightsAttributes ใน AudienceInsightsService โดยอัตโนมัติ (ดูคู่มือข้อมูลเชิงลึกของกลุ่มเป้าหมาย) ปลายทางอื่นๆ ใน AudienceInsightsService ต้องใช้รายการที่อนุญาตแยกต่างหาก
เทรนด์หัวข้อ (search_topics): ระบุรายการหัวข้อเนื้อหาในช่อง search_topics API จะแสดงข้อมูลเชิงลึกเกี่ยวกับเทรนด์สำหรับหัวข้อเหล่านั้น รวมถึงเปอร์เซ็นต์การเปลี่ยนแปลงของมูลค่าเทรนด์ในช่วงระยะเวลาการเปรียบเทียบ นอกจากนี้ คุณยังขอข้อมูลเชิงลึกเกี่ยวกับครีเอเตอร์ในพื้นที่หรือความรู้สึกที่มีต่อแบรนด์ได้โดยตั้งค่า supplemental_data

แอตทริบิวต์ KNOWLEDGE_GRAPH ที่แสดงผลโดย ListAudienceInsightsAttributes จะมีแท็ก InsightsKnowledgeGraphEntityCapabilities อย่างน้อย 1 รายการ โดยระบบรองรับเอนทิตีที่ติดแท็ก CONTENT_TRENDING_INSIGHTS เป็นหัวข้อใน GenerateTrendingInsights

คุณสามารถขอฟีเจอร์ที่ไม่บังคับในข้อมูลเชิงลึกเกี่ยวกับเทรนด์ได้เช่นเดียวกับการสร้างข้อมูลเชิงลึกของครีเอเตอร์ โดยตั้งค่าฟิลด์ที่ซ้ำได้ supplemental_data เป็น LOCAL_CREATOR_DATA หรือ BRAND_SENTIMENT_DATA ดังนี้

ครีเอเตอร์ในพื้นที่ (LOCAL_CREATOR_DATA): เมื่อคำขอที่มาแรงใช้ search_topics (และหัวข้อเป็นเอนทิตี กราฟความรู้ ที่ติดแท็กด้วยความสามารถ CREATOR_TOPIC_INSIGHTS) การตั้งค่า supplemental_data เป็น LOCAL_CREATOR_DATA จะป้อนข้อมูลในช่อง related_local_creators ในออบเจ็กต์ TrendInsight ที่แสดงผลด้วยครีเอเตอร์ในพื้นที่ที่เกี่ยวข้องซึ่งยินยอมให้แชร์ข้อมูลตำแหน่งของตน การค้นพบครีเอเตอร์ในพื้นที่ใช้ร่วมกับ sub_country_locations ไม่ได้
ความรู้สึกต่อแบรนด์ (BRAND_SENTIMENT_DATA): เมื่อคำขอที่กำลังมาแรงใช้ search_topics และหัวข้อเอนทิตีกราฟความรู้ที่ขอมีความสามารถ BRAND การตั้งค่า supplemental_data เป็น BRAND_SENTIMENT_DATA จะป้อนข้อมูลในช่อง brand_sentiment_insights ในออบเจ็กต์ TrendInsight ที่แสดงผล

การวัดความรู้สึกที่มีต่อแบรนด์ใช้โมเดล AI จาก Gemini เพื่อวิเคราะห์เนื้อหาวิดีโอ YouTube ที่เกี่ยวข้องกับแบรนด์ โดยจัดหมวดหมู่ความรู้สึกเป็นเชิงบวก เชิงลบ หรือเป็นกลาง ระบบจะวิเคราะห์เฉพาะเนื้อหาวิดีโอเท่านั้น โดยไม่รวมความคิดเห็นของผู้ใช้

เมธอด GenerateTrendingInsights จะแสดงผลรายการออบเจ็กต์ TrendInsight ซึ่งแต่ละรายการประกอบด้วยข้อมูลต่อไปนี้

trend_attribute: AudienceInsightsAttributeMetadataหลักของเทรนด์
trend_metrics: เมตริกสำหรับแนวโน้ม เช่น เปอร์เซ็นต์การเปลี่ยนแปลงในช่วงระยะเวลาการเปรียบเทียบ
trend: ค่า InsightsTrend (EMERGING, RISING, SUSTAINED หรือ DECLINING) ที่ระบุทิศทางของแนวโน้ม ดูขนาดของการเปลี่ยนแปลงได้ที่ trend_metrics.trend_change_percent
trend_data_points: จุดข้อมูลย้อนหลังสำหรับแนวโน้ม จะป้อนข้อมูลสำหรับเทรนด์ที่ใช้ search_topics เท่านั้น
related_videos: รายการออบเจ็กต์ AudienceInsightsAttributeMetadata สำหรับวิดีโอมาแรงที่เชื่อมโยงกับหัวข้อของเทรนด์ (ป้อนข้อมูลสำหรับเทรนด์ที่ใช้ search_topics เท่านั้น) สำหรับแอตทริบิวต์เหล่านี้ ระบบจะป้อนข้อมูล YouTubeVideoAttributeMetadata ที่ฝังไว้ด้วยข้อมูลเมตาระดับวิดีโอ (URL, URL ของภาพปก, ยอดดู และยอดกดชอบ) และข้อมูลเมตาระดับช่อง (รหัสช่อง, ชื่อ และ URL)
related_creators: รายการออบเจ็กต์ YouTubeCreatorInsights สำหรับครีเอเตอร์ที่เกี่ยวข้องกับหัวข้อของเทรนด์ (ป้อนข้อมูลสำหรับเทรนด์ที่ใช้ search_topics เท่านั้น)
related_local_creators: รายการออบเจ็กต์ YouTubeCreatorInsights สำหรับครีเอเตอร์ในพื้นที่ที่เกี่ยวข้องกับหัวข้อของเทรนด์ซึ่งยินยอมให้แชร์ข้อมูลตำแหน่งของตน จะป้อนข้อมูลเมื่อมีการขอ LOCAL_CREATOR_DATA เท่านั้น (ดูข้อมูลเสริม ครีเอเตอร์ในพื้นที่ และความรู้สึกต่อแบรนด์)
brand_sentiment_insights: รายการออบเจ็กต์ BrandSentimentInsight สำหรับแนวโน้ม (สร้างขึ้นเมื่อคำขอใช้ search_topics สำหรับเอนทิตีที่มีความสามารถ BRAND และคำขอ BRAND_SENTIMENT_DATA) ออบเจ็กต์ BrandSentimentInsight แต่ละรายการประกอบด้วยข้อมูลต่อไปนี้
- month: เดือนที่ความรู้สึกต่อแบรนด์แสดงในรูปแบบ YYYY-MM
- has_insufficient_data: ข้อมูลไม่เพียงพอที่จะคำนวณความรู้สึกต่อแบรนด์หรือไม่
- sentiment_distributions: การกระจายความรู้สึกระหว่างเชิงบวก เชิงลบ และเป็นกลาง ซึ่งคำนวณเป็นสัดส่วนของยอดดูวิดีโอที่สอดคล้องกับแบรนด์ที่มีความรู้สึกแต่ละประเภท
- sentiment_summaries: ข้อมูลสรุปที่ AI สร้างขึ้นเกี่ยวกับธีมเชิงบวกและเชิงลบในเนื้อหาที่เกี่ยวข้องกับแบรนด์ พร้อมวิดีโอตัวอย่างสำหรับความรู้สึกแต่ละประเภท ระบบจะสร้างข้อมูลสรุปสำหรับความรู้สึกเชิงบวกและเชิงลบเท่านั้น ไม่ใช่ความรู้สึกกลางๆ

ข้อมูลอ้างอิงคำขอและการตอบกลับของ `GenerateTrendingInsights`

โทรหา GenerateTrendingInsights ที่ ContentCreatorInsightsService ที่ปลายทางต่อไปนี้

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

ตารางต่อไปนี้จะสรุปช่องต่างๆ ใน GenerateTrendingInsightsRequest

เส้นทางช่อง	ข้อกำหนด	รูปแบบและข้อจำกัด
`customer_id`	ต้องระบุ	รหัสลูกค้า 10 หลัก (`string`) ที่ไม่มีขีดกลาง
`customer_insights_group`	ต้องระบุ	ชื่อที่ผู้ใช้กำหนด (`string`) ของลูกค้าหรือแบรนด์ที่วางแผนไว้
`country_location`	ต้องระบุ	ประเทศเดียว `LocationInfo` (`geo_target_constant` เช่น `"geoTargetConstants/2840"`)
`sub_country_locations[]`	ไม่บังคับ	ตัวกรองระดับย่อยของประเทศ `LocationInfo` รองรับเฉพาะ `search_audience` และใช้ร่วมกับ `LOCAL_CREATOR_DATA` ไม่ได้
`search_audience`	`criteria` (`oneof`)	`SearchAudience` ที่มีข้อมูลต่อไปนี้ • `audience_attributes[]` (ต้องระบุ): `age_range`, `gender`, `parental_status`, `income_range` (รวมถึง `user_interest`, `entity` หรือ `category` เมื่อไม่ได้ใช้ `audience_combinations`) • `audience_combinations[]` (ไม่บังคับ): กลุ่มแอตทริบิวต์ AND-of-ORs
`search_topics`	`criteria` (`oneof`)	`SearchTopics` ที่มี `entities[]` (`AudienceInsightsEntity` ที่มี `knowledge_graph_machine_id` ติดแท็กด้วย `CONTENT_TRENDING_INSIGHTS`)
`supplemental_data[]`	ไม่บังคับ	ค่า `ContentCreatorInsightsSupplementalData`: • `LOCAL_CREATOR_DATA`: ป้อน `related_local_creators[]` สำหรับเอนทิตี `search_topics` ด้วย `CREATOR_TOPIC_INSIGHTS` • `BRAND_SENTIMENT_DATA`: ป้อน `brand_sentiment_insights[]` สำหรับเอนทิตี `search_topics` ด้วย `BRAND`
`insights_application_info`	ไม่บังคับ	ข้อมูลเมตา `AdditionalApplicationInfo` เกี่ยวกับแอปพลิเคชันที่ส่งคำขอ

ข้อความ GenerateTrendingInsightsResponse จะแสดงผลรายการ TrendInsight ใน trend_insights[] ดังนี้

ช่อง `TrendInsight`	ประเภท	คำอธิบาย
`trend_attribute`	`AudienceInsightsAttributeMetadata`	แอตทริบิวต์หลักสำหรับเทรนด์ (`dimension`, `display_name`, `attribute`)
`trend_metrics`	`TrendInsightMetrics`	เมตริกในช่วงระยะเวลาเปรียบเทียบ 3 เดือน (`views_count` และ `views_indexed_value` สำหรับ `search_topics`, `audience_share` สำหรับ `search_audience`, `trend_change_percent`)
`trend`	`InsightsTrend`	ทิศทางของแนวโน้ม (`EMERGING`, `RISING`, `SUSTAINED` หรือ `DECLINING`)
`trend_data_points[]`	`TrendInsightDataPoint`	ข้อมูลย้อนหลังรายเดือน (`month` ในรูปแบบ `YYYY-MM` และ `trend_metrics`) ซึ่งสร้างขึ้นสำหรับ `search_topics`
`related_videos[]`	`AudienceInsightsAttributeMetadata`	วิดีโอมาแรงที่มี `YouTubeVideoAttributeMetadata` ซึ่งสร้างขึ้นสำหรับ `search_topics`
`related_creators[]`	`YouTubeCreatorInsights`	ครีเอเตอร์ที่เกี่ยวข้องกับหัวข้อ โดยแสดงข้อมูลสำหรับ `search_topics`
`related_local_creators[]`	`YouTubeCreatorInsights`	ครีเอเตอร์ในพื้นที่ที่ยินยอม ระบบจะป้อนข้อมูลสำหรับ `search_topics` เมื่อมีการขอ `LOCAL_CREATOR_DATA` ในเอนทิตีที่มี `CREATOR_TOPIC_INSIGHTS`
`brand_sentiment_insights[]`	`BrandSentimentInsight`	ความรู้สึกต่อแบรนด์รายเดือน (`month`, `has_insufficient_data`, `sentiment_distributions[]`, `sentiment_summaries[]`) ซึ่งจะป้อนข้อมูลสำหรับ `search_topics` เมื่อมีการขอ `BRAND_SENTIMENT_DATA` ในเอนทิตีที่มีความสามารถ `BRAND`

ตัวอย่างคำขอและการตอบกลับ REST ของ `GenerateTrendingInsights`

ตัวอย่างต่อไปนี้เรียกใช้ GenerateTrendingInsights โดยใช้ searchTopics สำหรับเอนทิตีแบรนด์กราฟความรู้ (/g/11example_brand ซึ่งติดแท็กด้วย CONTENT_TRENDING_INSIGHTS, CREATOR_TOPIC_INSIGHTS และ BRAND) และขอทั้ง LOCAL_CREATOR_DATA และ 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 ที่สำเร็จจะแสดงผลรายการ TrendInsight ใน 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

ใช้ Issue Tracker ของ Google เพื่อถามคำถามเกี่ยวกับการสนับสนุน รายงานข้อบกพร่อง หรือส่งคำขอฟีเจอร์ Google จะติดตาม จัดลำดับความสำคัญ และโพสต์ข้อมูลอัปเดตเกี่ยวกับคำขอของคุณใน Issue Tracker โดยตรง ดูข้อมูลเพิ่มเติมได้ที่สร้างปัญหาใน Issue Tracker ของ Google

สร้างปัญหาโดยใช้เทมเพลต Issue Tracker อย่างใดอย่างหนึ่งต่อไปนี้

กรอกข้อมูลโดยละเอียดในทุกช่องของเทมเพลตเพื่อให้ Google สามารถจำลองและจัดลำดับความสำคัญของคำขอได้ Google อาจปิดรายงานที่ไม่สมบูรณ์และขอให้คุณส่งปัญหาใหม่พร้อมรายละเอียดที่ขาดหายไป

ข้อมูลเชิงลึกของกลุ่มเป้าหมาย

การเปรียบเทียบ YouTube

ข้อกำหนดของการได้รับสิทธิ์

สร้างข้อมูลเชิงลึกของครีเอเตอร์

การรวมกลุ่มเป้าหมายที่ซับซ้อน

ข้อมูลเสริมและครีเอเตอร์ในพื้นที่

ข้อมูลอ้างอิงคำขอและการตอบกลับของ GenerateCreatorInsights

ตัวอย่างคำขอและการตอบกลับ REST ของ GenerateCreatorInsights

สร้างข้อมูลเชิงลึกที่กำลังมาแรง

ข้อมูลเสริมและครีเอเตอร์ในพื้นที่

ข้อมูลเมตาของข้อมูลเชิงลึกที่กำลังมาแรง

ข้อมูลอ้างอิงคำขอและการตอบกลับของ GenerateTrendingInsights

ตัวอย่างคำขอและการตอบกลับ REST ของ GenerateTrendingInsights

Google Issue Tracker

ข้อมูลอ้างอิงคำขอและการตอบกลับของ `GenerateCreatorInsights`

ตัวอย่างคำขอและการตอบกลับ REST ของ `GenerateCreatorInsights`

ข้อมูลอ้างอิงคำขอและการตอบกลับของ `GenerateTrendingInsights`

ตัวอย่างคำขอและการตอบกลับ REST ของ `GenerateTrendingInsights`