YouTube Analytics API - Data Model

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

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

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

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

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 เดือน

• รายงานประเภทอุปกรณ์รองรับเมตริกยอดดูและ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 มียอดดูเท่าใดในระยะเวลาการรายงาน)

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

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

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

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

ความใหม่ของข้อมูลและเวลาในการตอบสนอง

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

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

การดึงข้อมูลรายงาน

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

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

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

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

• ใช้แถวส่วนหัวของการตอบสนองเพื่อกำหนดลำดับคอลัมน์ของรายงาน เช่น อย่าคิดว่ายอดดูจะเป็นเมตริกแรกที่แสดงในการตอบสนองเพียงเพราะเป็นเมตริกแรกที่แสดงในคำอธิบายรายงาน แต่ให้ใช้แถวส่วนหัวของการตอบสนองเพื่อกำหนดคอลัมน์ที่มีข้อมูลนั้น
• ใช้ 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

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

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

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

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

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

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