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

หมายเหตุ: ฟีเจอร์นี้อยู่ในเวอร์ชันเบต้าและพร้อมใช้งานสำหรับนักพัฒนาแอปใน รายการที่อนุญาตเท่านั้น

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

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

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

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

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

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

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

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

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

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

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

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

   ตั้งแต่ Google Ads API v23 เป็นต้นไป คุณสามารถระบุความสัมพันธ์ของแอตทริบิวต์กลุ่มเป้าหมายที่ซับซ้อนได้โดยใช้ audience_combinations ฟิลด์นี้ช่วยให้คุณกำหนดกลุ่มเป้าหมายด้วยตรรกะบูลีน (AND/OR) ซึ่งทำไม่ได้ด้วย audience_attributes

   แม้ว่า audience_attributes จะเหมาะสำหรับการกำหนดเป้าหมายตามรายการแอตทริบิวต์ที่รวมกัน (รวมกันด้วย OR) เช่น ผู้ใช้ที่สนใจ "กีฬา" หรือ "การเดินทาง" หรือ..., แต่ audience_combinations จะให้การควบคุมที่ละเอียดยิ่งขึ้น InsightsAudienceAttributeGroup แต่ละรายการภายใน audience_combinations จะรวมแอตทริบิวต์เข้าด้วยกันด้วยตรรกะ OR จากนั้นระบบจะรวมกลุ่มเหล่านี้เข้าด้วยกันด้วยตรรกะ AND

   ตัวอย่างเช่น หากต้องการกำหนดเป้าหมายกลุ่มเป้าหมายที่สนใจ ("การดูแลผิว" หรือ "การดูแลผม") และสนใจ "เครื่องสำอาง" ด้วย คุณจะต้องใช้รายการ InsightsAudienceAttributeGroup 2 รายการใน audience_combinations "การดูแลผิว" "การดูแลผม" และ "เครื่องสำอาง" เป็นหัวข้อที่สนใจ ซึ่งแสดงโดยเอนทิตี กราฟความรู้ (เช่น /m/014trl สำหรับเครื่องสำอาง) กลุ่มแรกจะมีแอตทริบิวต์เอนทิตี กราฟความรู้ สำหรับ "การดูแลผิว" และ "การดูแลผม" ส่วนกลุ่มที่ 2 จะมีแอตทริบิวต์เอนทิตี กราฟความรู้ สำหรับ "เครื่องสำอาง"

   โปรดทราบว่าหากคุณระบุเอนทิตี Knowledge Graph, หมวดหมู่ผลิตภัณฑ์และบริการ หรือความสนใจของผู้ใช้ใน 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. ข้อมูลเชิงลึกของครีเอเตอร์: ระบุรายการรหัสช่อง YouTube โดยใช้ฟิลด์ search_channels API จะแสดงข้อมูลเชิงลึกเกี่ยวกับช่องเหล่านั้น

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

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

• ชื่อครีเอเตอร์
• ช่อง YouTube
• เมตริกทั้งหมดของครีเอเตอร์
• รายการข้อมูลเชิงลึกของช่อง YouTube

ออบเจ็กต์ [YouTubeMetrics][YouTubeMetrics] มีเมตริกต่อไปนี้

• จำนวนผู้ติดตาม
• ยอดดู
• จำนวนวิดีโอ
• เป็นครีเอเตอร์ Shorts ที่ใช้งานอยู่
• โอกาสในการเป็นพาร์ทเนอร์ (เริ่มตั้งแต่ v23)

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

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

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

สร้างข้อมูลเชิงลึกเกี่ยวกับเทรนด์

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

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

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

   แอตทริบิวต์ KNOWLEDGE_GRAPH จะมีแท็ก InsightsKnowledgeGraphEntityCapabilities อย่างน้อย 1 รายการ แอตทริบิวต์ที่รองรับข้อมูลเชิงลึกเกี่ยวกับเทรนด์จะมีแท็กที่เกี่ยวข้องในข้อมูลเมตาของการตอบกลับ

   โปรดทราบว่านักพัฒนาแอปที่มีสิทธิ์เข้าถึง ContentCreatorInsightsService จะมีสิทธิ์เข้าถึง AudienceInsightsService.ListAudienceInsightsAttributesโดยอัตโนมัติด้วย ส่วนปลายทางอื่นๆ ใน AudienceInsightsService ต้องมีกระบวนการเพิ่มลงในรายการที่อนุญาตแยกต่างหาก

   ดูเอกสารเพิ่มเติมเกี่ยวกับ ListAudienceInsightsAttributes ได้ใน คู่มือ ข้อมูลเชิงลึกของกลุ่มเป้าหมาย

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

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

   ตั้งแต่ Google Ads API v23 เป็นต้นไป คุณสามารถระบุความสัมพันธ์ของแอตทริบิวต์กลุ่มเป้าหมายที่ซับซ้อนได้โดยใช้ audience_combinations ฟิลด์นี้ช่วยให้คุณกำหนดกลุ่มเป้าหมายด้วยตรรกะบูลีน (AND/OR) ซึ่งทำไม่ได้ด้วย audience_attributes

   แม้ว่า audience_attributes จะเหมาะสำหรับการกำหนดเป้าหมายตามรายการแอตทริบิวต์ที่รวมกัน (รวมกันด้วย OR) เช่น ผู้ใช้ที่สนใจ "กีฬา" หรือ "การเดินทาง" หรือ..., แต่ audience_combinations จะให้การควบคุมที่ละเอียดยิ่งขึ้น InsightsAudienceAttributeGroup แต่ละรายการภายใน audience_combinations จะรวมแอตทริบิวต์เข้าด้วยกันด้วยตรรกะ OR จากนั้นระบบจะรวมกลุ่มเหล่านี้เข้าด้วยกันด้วยตรรกะ AND

   ตัวอย่างเช่น หากต้องการกำหนดเป้าหมายกลุ่มเป้าหมายที่สนใจ ("การดูแลผิว" หรือ "การดูแลผม") และสนใจ "เครื่องสำอาง" ด้วย คุณจะต้องใช้รายการ InsightsAudienceAttributeGroup 2 รายการใน audience_combinations "การดูแลผิว" "การดูแลผม" และ "เครื่องสำอาง" เป็นหัวข้อที่สนใจ ซึ่งแสดงโดยเอนทิตี กราฟความรู้ (เช่น /m/014trl สำหรับเครื่องสำอาง) กลุ่มแรกจะมีแอตทริบิวต์เอนทิตี กราฟความรู้ สำหรับ "การดูแลผิว" และ "การดูแลผม" ส่วนกลุ่มที่ 2 จะมีแอตทริบิวต์เอนทิตี กราฟความรู้ สำหรับ "เครื่องสำอาง"

   โปรดทราบว่าหากคุณระบุเอนทิตี Knowledge Graph, หมวดหมู่ผลิตภัณฑ์และบริการ หรือความสนใจของผู้ใช้ใน audience_attributes คุณจะใช้ audience_combinations ไม่ได้ หากใช้ audience_combinations คุณต้องระบุแอตทริบิวต์เหล่านี้ภายใน audience_combinations ไม่ใช่ใน audience_attributes แต่คุณยังคงใช้ audience_attributes สำหรับแอตทริบิวต์ประเภทอื่นๆ เช่น ข้อมูลประชากร ร่วมกับ audience_combinations ได้

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

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

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

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