ค้นพบและดึงข้อมูลเชิงลึกเกี่ยวกับครีเอเตอร์ YouTube ด้วยฟีเจอร์ข้อมูลเชิงลึกของครีเอเตอร์ ซึ่งจะเป็นประโยชน์สำหรับเอเจนซีและผู้ลงโฆษณาที่ต้องการค้นหาครีเอเตอร์ที่เกี่ยวข้องกับกลุ่มเป้าหมาย
API มีฟังก์ชันหลัก 4 อย่างดังนี้
- การค้นพบครีเอเตอร์: ค้นหาครีเอเตอร์ยอดนิยมสำหรับชุดหัวข้อ ข้อมูลประชากร กลุ่มเป้าหมาย หรือแอตทริบิวต์ของครีเอเตอร์ที่กำหนด
- ข้อมูลเชิงลึกเกี่ยวกับแบรนด์ของครีเอเตอร์: ดึงข้อมูลเชิงลึกเกี่ยวกับครีเอเตอร์ที่เกี่ยวข้องกับแบรนด์ที่เฉพาะเจาะจง
- ข้อมูลเชิงลึกของครีเอเตอร์: ดึงข้อมูลเชิงลึกเกี่ยวกับช่อง YouTube ที่เฉพาะเจาะจง เช่น จำนวนผู้ติดตาม ยอดดู และข้อมูลประชากรของกลุ่มเป้าหมาย
- ข้อมูลเชิงลึกเกี่ยวกับเทรนด์ที่กำลังมาแรง: ดึงข้อมูลเชิงลึกเกี่ยวกับเทรนด์ที่เฉพาะเจาะจง โดยอิงตามกลุ่มเป้าหมายหรือหัวข้อที่เฉพาะเจาะจง
ข้อกำหนดของการได้รับสิทธิ์
ContentCreatorInsightsService.GenerateCreatorInsights
เป็นคอมโพเนนต์ส่วนตัวของ Google Ads API ที่ให้บริการพร้อมใบอนุญาตข้อมูลแบบไม่ผูกขาดและไม่มีค่าลิขสิทธิ์ พาร์ทเนอร์ที่ลงชื่อเข้าใช้สามารถใช้ไลบรารีของไคลเอ็นต์
Google Ads มาตรฐานเพื่อสำรวจครีเอเตอร์และเนื้อหาบน YouTube ได้
พาร์ทเนอร์ต้องมีคุณสมบัติตรงตามเงื่อนไขต่อไปนี้จึงจะมีสิทธิ์
- มีเครื่องมือวางแผนหรืออินเทอร์เฟซผู้ใช้ที่จะผสานรวม Google Ads API
- ใช้ API เพื่อสำรวจเนื้อหาและครีเอเตอร์บน YouTube เพื่อหาโอกาสในการลงโฆษณา
- ทำการประเมินคัดกรองล่วงหน้าเพื่อให้แน่ใจว่ามีสิทธิ์
- ปฏิบัติตามข้อกำหนดปริมาณการใช้อินเทอร์เน็ตและยินดีที่จะเข้ารับการตรวจสอบข้อมูลเป็นระยะ
- ลงนามในข้อตกลงการให้สิทธิ์ใช้ข้อมูลซึ่งบังคับใช้ข้อกำหนดปริมาณการใช้อินเทอร์เน็ตตามกฎหมาย
- ยอมรับข้อกำหนดในการให้บริการของ Google Ads API
โปรดติดต่อตัวแทนของ Google เพื่อขอข้อมูลเพิ่มเติม
สร้างข้อมูลเชิงลึกของครีเอเตอร์
หากต้องการสร้างข้อมูลเชิงลึกของครีเอเตอร์ ให้ส่งคำขอไปยัง
ContentCreatorInsightsService.GenerateCreatorInsights
เมธอด เมธอดนี้มีขีดจำกัดอยู่ที่จำนวนคำค้นหาต่อวินาที (QPS) 5 รายการ และรับอินพุต 3 ประเภท ขึ้นอยู่กับว่าคุณต้องการค้นพบครีเอเตอร์ รับข้อมูลเชิงลึกเกี่ยวกับแบรนด์ของครีเอเตอร์ หรือรับข้อมูลเชิงลึกของครีเอเตอร์ คุณต้องระบุสถานที่ตั้งของประเทศที่ต้องการรับข้อมูล
การค้นพบครีเอเตอร์: คุณสามารถระบุรายการแอตทริบิวต์ของกลุ่มเป้าหมาย เช่น อายุ เพศ และความสนใจของผู้ใช้ (รวมถึงกลุ่มเป้าหมายผู้สนใจ กลุ่มเป้าหมายที่มีแผนจะซื้อ และกลุ่มเป้าหมายเหตุการณ์สำคัญในชีวิต) 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ตัวอย่างเช่น หากต้องการกำหนดเป้าหมายกลุ่มเป้าหมายที่สนใจ ("การดูแลผิว" หรือ "การดูแลผม") และสนใจ "เครื่องสำอาง" ด้วย คุณจะต้องใช้รายการ
InsightsAudienceAttributeGroup2 รายการในaudience_combinations"การดูแลผิว" "การดูแลผม" และ "เครื่องสำอาง" เป็นหัวข้อที่สนใจ ซึ่งแสดงโดยเอนทิตี กราฟความรู้ (เช่น/m/014trlสำหรับเครื่องสำอาง) กลุ่มแรกจะมีแอตทริบิวต์เอนทิตี กราฟความรู้ สำหรับ "การดูแลผิว" และ "การดูแลผม" ส่วนกลุ่มที่ 2 จะมีแอตทริบิวต์เอนทิตี กราฟความรู้ สำหรับ "เครื่องสำอาง"โปรดทราบว่าหากคุณระบุเอนทิตี กราฟความรู้, หมวดหมู่ผลิตภัณฑ์และบริการ หรือความสนใจของผู้ใช้ใน
audience_attributesคุณจะใช้audience_combinationsไม่ได้ หากใช้audience_combinationsคุณต้องระบุแอตทริบิวต์เหล่านี้ภายในaudience_combinationsไม่ใช่ในaudience_attributesแต่คุณยังคงใช้audience_attributesสำหรับแอตทริบิวต์ประเภทอื่นๆ เช่น ข้อมูลประชากร ร่วมกับaudience_combinationsได้ข้อมูลเชิงลึกเกี่ยวกับแบรนด์ของครีเอเตอร์: ระบุแบรนด์ที่จะค้นหาครีเอเตอร์ยอดนิยม API จะแสดงข้อมูลเชิงลึกเกี่ยวกับช่องที่ตรงกัน
ข้อมูลเชิงลึกของครีเอเตอร์: ระบุรายการรหัสช่อง YouTube API จะแสดงข้อมูลเชิงลึกเกี่ยวกับช่องที่เฉพาะเจาะจงเหล่านั้น
เมธอด generateCreatorInsights จะแสดงผลออบเจ็กต์ GenerateCreatorInsightsResponse ออบเจ็กต์นี้มีรายการออบเจ็กต์ YouTubeCreatorInsights ออบเจ็กต์ YouTubeCreatorInsights แต่ละรายการจะมีข้อมูลต่อไปนี้เกี่ยวกับครีเอเตอร์
- ชื่อครีเอเตอร์
- ช่อง YouTube
- เมตริกทั้งหมดของครีเอเตอร์
- รายการข้อมูลเชิงลึกของช่อง YouTube
ออบเจ็กต์ YouTubeMetrics มีเมตริกต่อไปนี้
- จำนวนผู้ติดตาม
- ยอดดู
- จำนวนวิดีโอ
- เป็นครีเอเตอร์ Shorts ที่ใช้งานอยู่
- โอกาสในการเป็นพาร์ทเนอร์ (ตั้งแต่ v23 เป็นต้นไป)
ออบเจ็กต์ YouTubeChannelInsights มีข้อมูลต่อไปนี้เกี่ยวกับช่อง YouTube
- ชื่อช่อง
- รหัสช่อง
- URL ของช่อง
- คำอธิบายช่อง
- เมตริกของช่อง
แอตทริบิวต์ของกลุ่มเป้าหมายของช่อง (เช่น อายุ เพศ และความสนใจของผู้ใช้
รายละเอียด)
วิดีโอยอดนิยม
ประเภทช่อง
ภาษาที่เชื่อมโยงกับเนื้อหาของช่อง
คะแนนความเกี่ยวข้อง (สำหรับการค้นหาเทรนด์หัวข้อเท่านั้น)
สร้างข้อมูลเชิงลึกเกี่ยวกับเทรนด์
หากต้องการสร้างข้อมูลเชิงลึกเกี่ยวกับเทรนด์ ให้ส่งคำขอไปยัง
ContentCreatorInsightsService.GenerateTrendingInsights
เมธอด เมธอดนี้มีขีดจำกัดอยู่ที่ 5 จำนวนคำค้นหาต่อวินาที (QPS) และรับข้อมูลป้อนเข้า 2 ประเภท ขึ้นอยู่กับว่าคุณต้องการรับเทรนด์ของกลุ่มเป้าหมายหรือเทรนด์หัวข้อ
คุณต้องระบุสถานที่ตั้งของประเทศที่ต้องการรับเทรนด์
เทรนด์ของกลุ่มเป้าหมาย: คุณสามารถระบุรายการแอตทริบิวต์ของกลุ่มเป้าหมาย เช่น อายุ เพศ และความสนใจของผู้ใช้ (รวมถึงกลุ่มเป้าหมายผู้สนใจ กลุ่มเป้าหมายที่มีแผนจะซื้อ และกลุ่มเป้าหมายเหตุการณ์สำคัญในชีวิต) 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ตัวอย่างเช่น หากต้องการกำหนดเป้าหมายกลุ่มเป้าหมายที่สนใจ ("การดูแลผิว" หรือ "การดูแลผม") และสนใจ "เครื่องสำอาง" ด้วย คุณจะต้องใช้รายการ
InsightsAudienceAttributeGroup2 รายการในaudience_combinations"การดูแลผิว" "การดูแลผม" และ "เครื่องสำอาง" เป็นหัวข้อที่สนใจ ซึ่งแสดงโดยเอนทิตี กราฟความรู้ (เช่น/m/014trlสำหรับเครื่องสำอาง) กลุ่มแรกจะมีแอตทริบิวต์เอนทิตี กราฟความรู้ สำหรับ "การดูแลผิว" และ "การดูแลผม" ส่วนกลุ่มที่ 2 จะมีแอตทริบิวต์เอนทิตี กราฟความรู้ สำหรับ "เครื่องสำอาง"โปรดทราบว่าหากคุณระบุเอนทิตี กราฟความรู้, หมวดหมู่ผลิตภัณฑ์และบริการ หรือความสนใจของผู้ใช้ใน
audience_attributesคุณจะใช้audience_combinationsไม่ได้ หากใช้audience_combinationsคุณต้องระบุแอตทริบิวต์เหล่านี้ภายในaudience_combinationsไม่ใช่ในaudience_attributesแต่คุณยังคงใช้audience_attributesสำหรับแอตทริบิวต์ประเภทอื่นๆ เช่น ข้อมูลประชากร ร่วมกับaudience_combinationsได้เทรนด์หัวข้อ: ระบุรายการหัวข้อเนื้อหา API จะแสดงรายการข้อมูลเชิงลึกเกี่ยวกับเทรนด์สำหรับหัวข้อเหล่านั้น ซึ่งรวมถึงเมตริกต่างๆ เช่น เปอร์เซ็นต์การเปลี่ยนแปลงของมูลค่าเทรนด์ในช่วงเวลาที่เปรียบเทียบ