YouTube Analytics API - Data Model

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

• มิติข้อมูลคือเกณฑ์ทั่วไปที่ใช้ในการรวมข้อมูล เช่น วันที่เกิดการดำเนินการหรือประเทศที่ผู้ใช้อยู่

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

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

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

การเลือกพารามิเตอร์รายงาน

เมื่อคุณขอรายงานโดยใช้เมธอด reports.query ของ API คำขอ API จะมีพารามิเตอร์ 5 รายการที่กำหนดวิธีคำนวณค่าของรายงาน ดังนี้

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

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

• พารามิเตอร์ dimensions จะอธิบายวิธีจัดกลุ่มเมตริก

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

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

ตัวเลือกการรายงานตัวอย่าง

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

• เจ้าของช่องตั้งค่าพารามิเตอร์ startDate เป็น 2015-06-01 และพารามิเตอร์ endDate เป็น 2015-07-31 รายงานจะมีข้อมูลเป็นระยะเวลา 2 เดือนตามค่าเหล่านี้

• รายงานประเภทอุปกรณ์รองรับเมตริก views และ estimatedMinutesWatched ดังนั้นเจ้าของช่องจึงตั้งค่าพารามิเตอร์ metrics เป็น views,estimatedMinutesWatched

• สำหรับพารามิเตอร์ dimensions เจ้าของช่องมีตัวเลือกมากมาย โดย 2 รายการจะแสดงในรายการต่อไปนี้ และรายการที่ 3 จะกล่าวถึงในคำอธิบายค่าพารามิเตอร์ filters ในส่วนนี้

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

  • วิดีโอของช่องมียอดดูบนอุปกรณ์เคลื่อนที่กี่ครั้งระหว่างวันที่ 1 มิถุนายน 2015 ถึง 31 กรกฎาคม 2015

  • วิดีโอของช่องได้รับการดูบนคอนโซลเกมกี่ครั้งระหว่างวันที่ 1 มิถุนายน 2015 ถึง 31 กรกฎาคม 2015

  รายงานจะมีจำนวนยอดดูและเวลาในการรับชมทั้งหมดสำหรับอุปกรณ์แต่ละประเภท

  • การตั้งค่าพารามิเตอร์เป็น day,deviceType หมายความว่าระบบจะคำนวณยอดดูและเวลาในการรับชมตามประเภทอุปกรณ์สำหรับแต่ละวันในระยะเวลาการรายงาน ดังนั้น เมื่อใช้ค่านี้ ข้อมูลรายงานจะตอบคำถามต่างๆ เช่น

  • วิดีโอของช่องได้รับการดูบนอุปกรณ์เคลื่อนที่กี่ครั้งในวันที่ 1 มิถุนายน 2015

  • มีการดูวิดีโอของช่องบนโทรทัศน์กี่ครั้งในวันที่ 14 กรกฎาคม 2015

• สุดท้าย พารามิเตอร์ filters ช่วยให้เจ้าของช่องจำกัดรายงานให้รวมเฉพาะข้อมูลที่ตรงกับค่าตัวกรองที่เฉพาะเจาะจงได้ รายงานนี้รองรับตัวเลือกการกรองจำนวนมากเกินกว่าที่จะอธิบายได้ทั้งหมด ดังนั้นตัวอย่างเหล่านี้จึงเป็นเพียงส่วนหนึ่งของรายงานที่คุณสร้างได้

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

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

  • เจ้าของช่องสามารถกรองคำขอเพื่อแสดงผลค่าสำหรับวิดีโอบางรายการเท่านั้น อย่างไรก็ตาม ตัวกรอง video รองรับรายการค่าที่คั่นด้วยคอมมา ดังนั้นรายงานจึงอาจมีข้อมูลของวิดีโอหลายรายการได้

  นอกจากนี้ หากตัวกรอง video ระบุหลายค่า คุณจะระบุ video เป็นมิติข้อมูลได้ด้วย ซึ่งหมายความว่าพารามิเตอร์ dimensions ยังรองรับค่า deviceType,video และ day,deviceType,video ด้วย

  • หากเจ้าของช่องรวม video ไว้ในรายการมิติข้อมูล เมตริกจะระบุค่าแต่ละค่าสำหรับวิดีโอแต่ละรายการ (วิดีโอ XYZ มีการดูบนคอนโซลเกมกี่ครั้งในวันที่ 1 มิถุนายน 2015)
  • หากเจ้าของช่องไม่รวม video ไว้ในรายการมิติข้อมูล เมตริกจะระบุค่ารวมที่ครอบคลุมวิดีโอที่ระบุทั้งหมด (วิดีโอ ABC, DEF และ XYZ มีการดูบนคอนโซลเกมกี่ครั้งในวันที่ 1 มิถุนายน 2015)

ความใหม่ของข้อมูลและความล่าช้าในการแสดงข้อมูล

แม้ว่า YouTube Analytics API จะรองรับการค้นหาที่กำหนดเป้าหมาย แต่ข้อมูลวิเคราะห์ที่เกี่ยวข้องไม่ใช่ข้อมูลแบบเรียลไทม์ โดยปกติแล้ว การประมวลผลข้อมูลจะทำให้เกิดเวลาในการตอบสนอง 48-72 ชั่วโมง ดังนั้น การตอบกลับจาก API จึงไม่มีข้อมูลของวันล่าสุด และ endDate ของรายงานจะมีเฉพาะข้อมูลจนถึงวันสุดท้ายที่ประมวลผลเมตริกที่ขอทั้งหมดอย่างสมบูรณ์

เนื่องจากเวลาในการตอบสนองของข้อมูล คุณอาจสังเกตเห็นความคลาดเคลื่อนระหว่างข้อมูลที่ API แสดงผลกับเมตริกแบบเรียลไทม์ที่แสดงใน YouTube Studio หากแอปพลิเคชันของคุณต้องการสถิติแบบเรียลไทม์สำหรับวิดีโอแต่ละรายการ เช่น ยอดดู ยอดชอบ หรือยอดความคิดเห็นปัจจุบัน ให้ใช้เมธอด videos.list ของ YouTube Data API แทน YouTube Analytics API

กำลังเรียกข้อมูลรายงาน

หากต้องการเรียกข้อมูลรายงาน ให้ส่งคำขอ GET ที่ได้รับสิทธิ์ไปยังเมธอด reports.query ของ API โดยระบุพารามิเตอร์ที่กำหนดรายงานที่ต้องการเรียกข้อมูล

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

แนวทางปฏิบัติแนะนำ

แอปพลิเคชันที่ใช้ YouTube Analytics API ควรปฏิบัติตามแนวทางปฏิบัติเหล่านี้เสมอ

• ใช้แถวส่วนหัวของการตอบกลับเพื่อกำหนดลำดับคอลัมน์ของรายงาน เช่น อย่าคิดว่า views จะเป็นเมตริกแรกที่แสดงในการตอบกลับเพียงเพราะเป็นเมตริกแรกที่แสดงในคำอธิบายรายงาน แต่ให้ใช้แถวส่วนหัวของการตอบกลับเพื่อระบุคอลัมน์ที่มีข้อมูลนั้นแทน
• ใช้ YouTube Data API เพื่อดึงข้อมูลเมตาเพิ่มเติมสำหรับแหล่งข้อมูลที่ระบุในการตอบกลับจาก YouTube Analytics API ตามที่ระบุไว้ในนโยบายสำหรับนักพัฒนาแอปของบริการ API ของ YouTube (ส่วนที่ III.E.4.b ถึง III.E.4.d) ไคลเอ็นต์ API ต้องลบหรือรีเฟรชข้อมูลเมตาของทรัพยากรที่จัดเก็บไว้จาก API ดังกล่าวหลังจากผ่านไป 30 วัน

เมตริกแบบรวมและรายการที่ถูกลบ

การตอบกลับจาก YouTube Analytics API จะไม่มีรายละเอียดเมตริกสำหรับรายการที่ลบไปแล้ว ตัวอย่างเช่น หากเจ้าของช่องลบวิดีโอ วิดีโอดังกล่าวจะไม่แสดงในการตอบกลับจาก API ที่แสดงผลเมตริกแบบวิดีโอต่อวิดีโออีกต่อไป อย่างไรก็ตาม รายงานที่รวบรวมเมตริกสำหรับชุดทรัพยากรจะยังคงรวมเมตริกที่เชื่อมโยงกับรายการที่ลบไปแล้ว

ตัวอย่างเช่น สมมติว่าเจ้าของช่องดึงข้อมูลรายงาน 2 รายการ รายงานแรกจะแสดงยอดดูรายวันทั้งหมดสำหรับวิดีโอทั้งหมดของช่องในช่วงระยะเวลาหนึ่งๆ รายงานที่ 2 จะแสดงยอดดูรายวันทั้งหมดแบบแยกตามวิดีโอในช่วงระยะเวลาเดียวกัน

ในกรณีนี้ ตัวเลขในรายงานแรกจะรวมยอดดูของวิดีโอที่ถูกลบในภายหลัง เนื่องจากรายงานแรกมีข้อมูลรวมรายวัน อย่างไรก็ตาม รายงานที่ 2 จะไม่รวมยอดดูที่เชื่อมโยงกับรายการที่ถูกลบ เนื่องจากรายงานที่ 2 แสดงยอดดูตามวิดีโอแต่ละรายการ ด้วยเหตุนี้ หากช่องลบวิดีโอในช่วงระยะเวลาที่รายงานครอบคลุม ยอดดูรายวันทั้งหมดที่รายงานในรายงานแรกอาจสูงกว่าผลรวมของยอดดูรายวันเฉพาะวิดีโอในรายงานที่ 2

การลบข้อมูลระบุตัวบุคคล

เราจำกัดข้อมูลบางส่วนในข้อมูลวิเคราะห์ YouTube เมื่อเมตริกไม่ถึงเกณฑ์ที่กำหนด กรณีนี้อาจเกิดขึ้นในรายงานต่างๆ ในทางปฏิบัติ หมายความว่ารายงานอาจมีข้อมูลบางส่วนของคุณ (หรือไม่มีเลย) ในกรณีต่อไปนี้

1. วิดีโอหรือช่องมีการเข้าชมที่จำกัดในระยะเวลาที่กำหนด

   หรือ

2. คุณเลือกตัวกรองหรือมิติข้อมูล เช่น แหล่งที่มาของการเข้าชมหรือประเทศ ซึ่งมีค่าไม่ถึงเกณฑ์ที่กำหนด

ในกรณีที่มีข้อมูลจำกัด ยอดรวมที่แสดงในรายงานต่างๆ อาจแตกต่างกัน โดยขึ้นอยู่กับวิธีที่รายงานเหล่านั้นรวบรวมข้อมูล

ตัวอย่างเช่น สมมติว่าเจ้าของช่องเรียกข้อมูลรายงาน 2 รายการ รายงานแรกจะแสดงยอดดูทั้งหมดของวิดีโอหนึ่งๆ และรายงานที่ 2 จะแสดงยอดดูทั้งหมดของวิดีโอนั้นแบบแยกตามประเทศ และสมมติว่าในระยะเวลาที่กำหนด มีการดูวิดีโอ 1,000 ครั้ง โดยมียอดดู 500 ครั้งในสหรัฐอเมริกา 498 ครั้งในแคนาดา และ 2 ครั้งในฝรั่งเศส

ในตัวอย่างนี้ รายงานแรกจะระบุว่าวิดีโอมียอดดู 1, 000 ครั้ง ส่วนรายงานที่ 2 จะระบุเพียงว่ามียอดดูวิดีโอในสหรัฐอเมริกา 500 ครั้งและมียอดดูในแคนาดา 498 ครั้ง ดังนั้น ยอดดูรวมในรายงานทั้ง 2 ฉบับจึงแตกต่างกัน โปรดทราบว่ารายงานที่ 2 จะไม่มีการระบุว่ามียอดดูอีก 2 ครั้งเกิดขึ้นด้วย (หรือมียอดดูเกิดขึ้นในฝรั่งเศส)

ประเภทข้อมูลที่จำกัด

เราอาจจำกัดข้อมูลต่อไปนี้ในรายงานข้อมูลวิเคราะห์ YouTube

• ข้อมูลประชากร เช่น อายุและเพศ
• ข้อมูลทางภูมิศาสตร์ รวมถึงเมตริกหรือมิติข้อมูลที่เกี่ยวข้องกับประเทศหรือภูมิภาคที่ผู้ชมอาศัยอยู่ เช่น ประเทศหรือภูมิภาคของผู้ชม อย่างไรก็ตาม โปรดทราบว่ารายงานจะไม่ใช้เกณฑ์ทางภูมิศาสตร์กับเมตริกรายได้
• เมตริกที่เกี่ยวข้องกับแหล่งที่มาของการเข้าชมที่เฉพาะเจาะจง เช่น ข้อความค้นหาหรือ URL ภายนอกที่นำไปสู่ยอดดูวิดีโอ เช่น ข้อความค้นหาและ URL ที่นำไปสู่ยอดดูจำนวนน้อยมากจะไม่ปรากฏในรายงาน แต่คุณจะยังคงเห็นข้อความค้นหาและ URL ที่นำผู้ชมจำนวนมากมายังเนื้อหาของคุณ

ดูข้อมูลเพิ่มเติมเกี่ยวกับข้อมูลที่จำกัดในรายงานข้อมูลวิเคราะห์ YouTube ได้ที่ศูนย์ช่วยเหลือของ YouTube

การใช้โควต้า

คำขอ API แต่ละรายการที่คุณส่งจะนับเป็นโควต้าการใช้งาน API 1 หน่วย ขีดจำกัดโควต้าจะแสดงในแผงโควต้าในคอนโซล Google Cloud