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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

3. ข้อมูลเชิงลึกของครีเอเตอร์: ระบุรายการรหัสช่อง YouTube API จะแสดงข้อมูลเชิงลึกเกี่ยวกับช่องเหล่านั้น

เมธอด generateCreatorInsights จะแสดงผลออบเจ็กต์ GenerateCreatorInsightsResponse ออบเจ็กต์นี้มีรายการออบเจ็กต์ YouTubeCreatorInsights ออบเจ็กต์ YouTubeCreatorInsightsแต่ละรายการจะมีข้อมูลต่อไปนี้เกี่ยวกับครีเอเตอร์

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

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

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

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

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

• ชื่อช่อง
• รหัสช่อง
• URL ของช่อง
• คำอธิบายของช่อง
• เมตริกของช่อง

• แอตทริบิวต์ของผู้ชมช่อง (เช่น อายุ เพศ และความสนใจของผู้ใช้

  รายละเอียด)

• วิดีโอยอดนิยม

• ประเภทช่อง

• ภาษาที่เชื่อมโยงกับเนื้อหาของช่อง

• คะแนนความเกี่ยวข้อง (สำหรับการค้นหาเทรนด์ของหัวข้อเท่านั้น)

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

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

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

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

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

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

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

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

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