Dimensions

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

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

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

หากต้องการเรียกข้อมูลรายงานการค้นหา ให้เรียกใช้เมธอด reports.query ของ YouTube Analytics API ในคําขอ ให้ใช้พารามิเตอร์ dimensions เพื่อระบุมิติข้อมูลที่ YouTube จะใช้คํานวณค่าเมตริกในรายงาน

มิติข้อมูลหลัก

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

รายการต่อไปนี้ระบุมิติข้อมูลหลักของ API

ดูข้อมูลเพิ่มเติมได้ที่รายการ YouTube API ที่อยู่ภายใต้นโยบายการเลิกใช้งาน

ตัวกรอง

รายงานการค้นหาทั้งหมดรองรับตัวกรอง ตัวกรองจะระบุค่ามิติข้อมูลที่ต้องอยู่ในชุดข้อมูลที่ดึงมา ดังนั้นจึงจํากัดการตอบกลับของ API ให้รวมเฉพาะข้อมูลที่ตรงกับค่าหรือชุดค่าเฉพาะเท่านั้น เช่น คุณอาจใช้ตัวกรองเพื่อดึงข้อมูลสําหรับประเทศหนึ่งๆ เท่านั้นแทนการดึงข้อมูลเมตริกกิจกรรมของผู้ใช้สำหรับทุกประเทศ

ในคําขอดึงข้อมูลรายงานการค้นหา พารามิเตอร์คําขอ filters (ไม่บังคับ) จะระบุค่ามิติข้อมูลที่ต้องการกรองข้อมูล เช่น หากต้องการเรียกข้อมูลเมตริกกิจกรรมของผู้ใช้สําหรับยุโรป คุณจะต้องตั้งค่าพารามิเตอร์ filters เป็น continent==150

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

ขนาด

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

แหล่งข้อมูล

มิติข้อมูลเหล่านี้สอดคล้องกับทรัพยากรที่ช่องและเจ้าของเนื้อหาจัดการบน YouTube

หมายเหตุ: API ให้คุณระบุค่าหลายค่าสําหรับมิติข้อมูล video, playlist และ channel เมื่อใช้เป็นตัวกรอง โดยให้ตั้งค่าพารามิเตอร์ filters เป็นรายการรหัสวิดีโอ เพลย์ลิสต์ หรือช่องที่คั่นด้วยคอมมา ซึ่งควรกรองการตอบกลับของ API ค่าพารามิเตอร์ระบุรหัสได้สูงสุด 500 รายการ

video (มิติข้อมูลหลัก)
รหัสของวิดีโอ YouTube ใน YouTube Data API ค่านี้คือพร็อพเพอร์ตี้ id ของvideoแหล่งข้อมูล This is a core dimension and is subject to the Deprecation Policy.
playlist
รหัสของเพลย์ลิสต์ YouTube ใน YouTube Data API ค่านี้คือพร็อพเพอร์ตี้ id ของplaylist ทรัพยากร
channel (มิติข้อมูลหลัก) (ใช้ในรายงานเจ้าของเนื้อหาเท่านั้น)
รหัสของช่อง YouTube ใน YouTube Data API ค่านี้คือพร็อพเพอร์ตี้ id ของchannel ทรัพยากร This is a core dimension and is subject to the Deprecation Policy.

มิติข้อมูล channel มักใช้ในรายงานของเจ้าของเนื้อหา เนื่องจากรายงานเหล่านั้นมักจะรวบรวมข้อมูลของหลายช่อง
group (ตัวกรองเท่านั้น)
รหัสของกลุ่ม YouTube Analytics คุณเรียกข้อมูลค่านี้โดยใช้เมธอด groups.list ของ YouTube Analytics API ได้ เมื่อใช้ตัวกรอง group การตอบกลับของ API จะมีข้อมูลของวิดีโอ เพลย์ลิสต์ หรือช่องทั้งหมดในกลุ่มนั้น

ตัวอย่าง

คําขอตัวอย่างต่อไปนี้ใช้มิติข้อมูลหรือตัวกรองเอนทิตีการรายงาน

  • ตัวอย่างช่อง

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

  • ตัวอย่างเจ้าของเนื้อหา

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

พื้นที่ทางภูมิศาสตร์

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

country (มิติข้อมูลหลัก)
ประเทศที่เชื่อมโยงกับเมตริกในแถวรายงาน ค่ามิติข้อมูลคือรหัสประเทศ ISO-3166-1 แบบ 2 อักขระ เช่น US, CN (จีน) หรือ FR (ฝรั่งเศส) รหัสประเทศ ZZ ใช้เพื่อรายงานเมตริกที่ YouTube ไม่สามารถระบุประเทศที่เกี่ยวข้องได้ This is a core dimension and is subject to the Deprecation Policy.
province
รัฐหรือเขตแดนในสหรัฐอเมริกาที่เชื่อมโยงกับเมตริกในแถวรายงาน ค่ามิติข้อมูลคือรหัส ISO 3166-2 ที่ระบุรัฐในสหรัฐอเมริกาหรือเขตโคลัมเบีย เช่น US-MI (มิชิแกน) หรือ US-TX (เท็กซัส) ระบบจะใช้รหัสจังหวัด US-ZZ เพื่อรายงานเมตริกที่ YouTube ไม่สามารถระบุรัฐที่เกี่ยวข้องในสหรัฐอเมริกา เมื่อคำขอ API มี province ในค่าพารามิเตอร์ dimensions คำขอต้องจํากัดข้อมูลไปยังสหรัฐอเมริกาด้วยโดยใส่ country==US ในค่าพารามิเตอร์ filters

หมายเหตุ: มิติข้อมูลนี้ไม่รองรับค่า ISO 3166-2 ที่ระบุพื้นที่ห่างไกลของสหรัฐอเมริกา เนื่องจากเขตแดนเหล่านั้นมีรหัสประเทศ ISO 3166-1 เป็นของตัวเองด้วย นอกจากนี้ ระบบยังไม่รองรับเขตการปกครองของประเทศอื่นๆ นอกเหนือจากสหรัฐอเมริกา

dma
ตัวระบุ 3 หลักที่ Nielsen ใช้ระบุพื้นที่การตลาดที่กำหนด (DMA) ที่เชื่อมโยงกับเหตุการณ์การดูที่อธิบายไว้ในแถวข้อมูล
city
เมืองโดยประมาณที่เชื่อมโยงกับเมตริกในแถวรายงาน ข้อมูลสําหรับมิติข้อมูลนี้จะพร้อมใช้งานตั้งแต่วันที่ 1 มกราคม 2022 เป็นต้นไป
continent (ตัวกรองเท่านั้น)
รหัสภูมิภาคทางสถิติของสหประชาชาติ (UN) API รองรับค่าต่อไปนี้
ค่า
002 แอฟริกา
019 อเมริกา (อเมริกาเหนือ ลาตินอเมริกา อเมริกาใต้ และแคริบเบียน)
142 เอเชีย
150 ยุโรป
009 โอเชียเนีย
มิติข้อมูลนี้ใช้เพื่อกรองข้อมูลได้เท่านั้น หากต้องการใช้มิติข้อมูลนี้ ให้ตั้งค่าพารามิเตอร์ filters เป็น continent==REGION_CODE โดยระบุค่า REGION_CODE จากตาราง
subContinent (ตัวกรองเท่านั้น)
รหัสภูมิภาคทางสถิติของ UN ที่ระบุเขตแดนย่อยทางภูมิศาสตร์ แผนกสถิติแห่งสหประชาชาติแสดงรายชื่อเขตย่อยและประเทศที่เชื่อมโยงกับแต่ละภูมิภาค

มิติข้อมูลนี้ใช้เพื่อกรองข้อมูลได้เท่านั้น หากต้องการใช้มิติข้อมูลนี้ ให้ตั้งค่าพารามิเตอร์ filters เป็น subContinent==REGION_CODE โดยระบุค่า REGION_CODE จากรายการ UN

ตัวอย่าง

คําขอตัวอย่างต่อไปนี้ใช้มิติข้อมูลหรือตัวกรองทางภูมิศาสตร์

  • ตัวอย่างช่อง

    • สถิติพื้นฐาน: จำนวนยอดดูเฉพาะประเทศ (และอื่นๆ) สำหรับช่อง
    • ภูมิศาสตร์
      • เมตริกเวลาในการรับชมตามประเทศสำหรับวิดีโอของช่อง
      • เมตริกคำอธิบายประกอบตามประเทศสำหรับวิดีโอของช่อง
      • เมตริกเฉพาะจังหวัดสำหรับรัฐในสหรัฐอเมริกาและวอชิงตัน ดี.ซี.
      • เมตริกเวลาในการรับชมตามประเทศสำหรับเพลย์ลิสต์ของช่อง
      • 10 อันดับแรก – เพลย์ลิสต์ที่มีผู้เปิดฟังมากที่สุดในสหรัฐอเมริกา
    • ตำแหน่งที่เล่น: จำนวนยอดดูรายวันและเวลาในการรับชมจากตำแหน่งที่เล่นต่างๆ
    • แหล่งที่มาของการเข้าชม: ยอดดูและเวลาในการรับชมจากแหล่งที่มาของการเข้าชมต่างๆ ในประเทศ
    • ข้อมูลประชากร: ข้อมูลประชากรของผู้ชมในแคลิฟอร์เนีย (กลุ่มอายุและเพศ)
    • วิดีโอยอดนิยม
      • 10 อันดับแรก – วิดีโอที่มียอดดูมากที่สุดในประเทศหนึ่งๆ
      • 10 อันดับแรก – วิดีโอที่มียอดดูมากที่สุดในยุโรป

  • ตัวอย่างเจ้าของเนื้อหา

    • สถิติพื้นฐาน: จำนวนการดูเฉพาะประเทศ (และอื่นๆ) สำหรับวิดีโอทั้งหมดที่อัปโหลดด้วยตนเอง
    • ภูมิศาสตร์
      • เมตริกเวลาในการรับชมเฉพาะประเทศสำหรับเนื้อหาที่อัปโหลดเอง
      • เมตริกคำอธิบายประกอบเฉพาะประเทศสำหรับเนื้อหาที่อัปโหลดด้วยตนเอง
      • เมตริกเฉพาะจังหวัดสำหรับรัฐในสหรัฐอเมริกาและวอชิงตัน ดี.ซี.
      • เมตริกเวลาในการรับชมของแต่ละประเทศสำหรับเพลย์ลิสต์ของเจ้าของเนื้อหา
      • 10 อันดับแรก – เพลย์ลิสต์ที่เปิดมากที่สุดในสหรัฐอเมริกา
    • ตำแหน่งที่เล่น: จำนวนยอดดูรายวันและเวลาในการรับชมจากตำแหน่งที่เล่นต่างๆ
    • ข้อมูลประชากร: ข้อมูลประชากรของผู้ชมในแคลิฟอร์เนีย (กลุ่มอายุและเพศ)
    • วิดีโอยอดนิยม: วิดีโอยอดนิยม 10 อันดับแรกในยุโรปสำหรับเจ้าของเนื้อหา
    • รายได้/ประสิทธิภาพโฆษณา: เมตริกรายได้และประสิทธิภาพโฆษณาตามประเทศ

ระยะเวลา

มิติข้อมูลเหล่านี้บ่งชี้ว่ารายงานควรรวบรวมข้อมูลตามระยะเวลา เช่น วัน สัปดาห์ หรือเดือน พารามิเตอร์คําขอ startDate และ endDate จะระบุระยะเวลาที่รายงานมีข้อมูล โปรดทราบว่ารายงานจะแสดงข้อมูลจนถึงวันสุดท้ายที่มีเมตริกทั้งหมดที่ระบุในคําขอ ณ เวลาที่มีการค้นหา วันที่ในรายงานจะแสดงในรูปแบบ YYYY-MM-DD

สำคัญ: วันที่ทั้งหมดหมายถึงช่วงเวลาที่เริ่มต้นเวลา 00:00 น. ตามเวลาแปซิฟิก (UTC-7 หรือ UTC-8) และสิ้นสุดเวลา 23:59 น. ตามเวลาแปซิฟิกในวันที่ เดือน และปีดังกล่าว ด้วยเหตุนี้ วันที่ที่ปรับนาฬิกาไปข้างหน้าสำหรับเวลาออมแสงจึงแสดงถึงระยะเวลา 23 ชั่วโมง และวันที่ที่ปรับนาฬิกาถอยหลังจึงแสดงถึงระยะเวลา 25 ชั่วโมง

มิติข้อมูลเดือนหมายถึงระยะเวลาที่เริ่มต้นเวลา 00:00 น. ตามเวลาแปซิฟิก (UTC-7 หรือ UTC-8) ในวันที่ 1 ของเดือนและปีที่ระบุ

วัน (มิติข้อมูลหลัก)
เมื่อคุณใช้มิติข้อมูลนี้ ระบบจะรวบรวมข้อมูลในรายงานเป็นรายวัน และแต่ละแถวจะมีข้อมูลของ 1 วัน คุณสามารถใช้มิติข้อมูลอื่นๆ เพื่อแจกแจงข้อมูลได้ละเอียดยิ่งขึ้น เช่น รายงานแหล่งที่มาของการเข้าชมจะรวบรวมสถิติการดูรายวันตามวิธีที่ผู้ใช้เข้าถึงวิดีโอของคุณ This is a core dimension and is subject to the Deprecation Policy.
month (มิติข้อมูลหลัก)
ข้อมูลในรายงานจะรวบรวมตามเดือนตามปฏิทิน คุณสามารถใช้ตัวกรองอื่นๆ เพื่อแบ่งกลุ่มข้อมูลได้มากขึ้นเช่นเดียวกับรายงานรายวัน ในรายงาน วันที่จะแสดงในรูปแบบ YYYY-MM

หมายเหตุ: หากการค้นหา API ใช้มิติข้อมูล month คุณต้องตั้งค่าพารามิเตอร์ start-date และ end-date เป็นวันที่ 1 ของเดือน This is a core dimension and is subject to the Deprecation Policy.

ตัวอย่าง

คําขอตัวอย่างต่อไปนี้ใช้มิติข้อมูลหรือตัวกรองตามช่วงเวลา

  • ตัวอย่างช่อง

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

  • ตัวอย่างเจ้าของเนื้อหา

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

ตำแหน่งที่เล่น

มิติข้อมูลเหล่านี้ให้ข้อมูลเชิงลึกเกี่ยวกับหน้าเว็บหรือแอปพลิเคชันที่กิจกรรมของผู้ใช้เกิดขึ้น

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

  • BROWSE – ข้อมูลนี้อธิบายการดูที่เกิดขึ้นในหน้าแรกหรือหน้าจอหลักของ YouTube, ในฟีดการติดตามของผู้ใช้ หรือในฟีเจอร์การเรียกดู YouTube อื่นๆ

  • CHANNEL – ข้อมูลจะอธิบายยอดดูที่เกิดขึ้นในหน้าช่อง

  • EMBEDDED – ข้อมูลนี้อธิบายยอดดูที่เกิดขึ้นในเว็บไซต์หรือแอปพลิเคชันอื่นที่มีการฝังวิดีโอโดยใช้การฝัง <iframe> หรือ <object>

  • EXTERNAL_APP – ข้อมูลนี้อธิบายยอดดูที่เกิดขึ้นในแอปพลิเคชันของบุคคลที่สามซึ่งเล่นวิดีโอโดยใช้วิธีการอื่นนอกเหนือจากการฝัง <iframe> หรือ <object> เช่น ระบบจะจัดหมวดหมู่การเล่นในแอปพลิเคชันที่ใช้ YouTube Android Player API โดยใช้ค่านี้

  • MOBILE – ข้อมูลนี้อธิบายยอดดูที่เกิดขึ้นบนเว็บไซต์เวอร์ชันอุปกรณ์เคลื่อนที่ของ YouTube หรือในไคลเอ็นต์ YouTube API ที่ได้รับอนุมัติ ซึ่งรวมถึงอุปกรณ์เคลื่อนที่

    ตั้งแต่วันที่ 10 กันยายน 2013 เป็นต้นไป ระบบจะไม่จัดหมวดหมู่การเล่นเป็นการเล่น MOBILE ในรายงาน YouTube Analytics อีกต่อไป ค่าดังกล่าวอาจยังคงอยู่ในรายงานเนื่องจากข้อมูลเดิมยังคงอยู่ในหมวดหมู่นั้น อย่างไรก็ตาม หลังจากวันที่ดังกล่าว การเล่นบนอุปกรณ์เคลื่อนที่จะจัดประเภทเป็นการเล่น WATCH, EMBEDDED หรือ EXTERNAL_APP โดยขึ้นอยู่กับประเภทของแอปพลิเคชันที่เล่น

  • SEARCH – ข้อมูลนี้อธิบายยอดดูที่เกิดขึ้นในหน้าผลการค้นหาของ YouTube โดยตรง

  • WATCH – ข้อมูลนี้อธิบายการดูที่เกิดขึ้นในหน้าสำหรับดูวิดีโอ YouTube หรือในแอปพลิเคชัน YouTube อย่างเป็นทางการ เช่น แอป YouTube สำหรับ Android

  • YT_OTHER – ข้อมูลอธิบายมุมมองที่ไม่ได้จัดประเภทไว้

insightPlaybackLocationDetail
ระบบจะรวบรวมข้อมูลตามหน้าเว็บที่มีโปรแกรมเล่น โปรดทราบว่ารายงานนี้รองรับเฉพาะยอดดูที่เกิดขึ้นในโปรแกรมเล่นที่ฝัง และรายงานจะระบุโปรแกรมเล่นที่ฝังซึ่งสร้างยอดดูมากที่สุดสำหรับวิดีโอที่ระบุ รายงานนี้จึงให้มุมมองที่ละเอียดกว่ารายงานตำแหน่งการเล่นโดยระบุ URL หรือแอปพลิเคชันที่เชื่อมโยงกับโปรแกรมเล่นที่ฝังยอดนิยม

ตัวอย่าง

คําขอตัวอย่างต่อไปนี้ใช้มิติข้อมูลตําแหน่งการเล่น

  • ตัวอย่างช่อง

    • ตำแหน่งการเล่น
      • จำนวนยอดดูและเวลาในการรับชมจากตำแหน่งการเล่นที่แตกต่างกัน
      • ยอดดูรายวันและเวลาในการรับชมจากตำแหน่งการเล่นที่แตกต่างกัน
      • 10 อันดับแรก – เว็บไซต์ของบุคคลที่สามที่สร้างยอดดูให้กับวิดีโอที่ฝังมากที่สุด
      • จำนวนยอดดูและเวลาในการรับชมเพลย์ลิสต์จากตำแหน่งการเล่นต่างๆ
      • ยอดดูเพลย์ลิสต์รายวันและเวลาในการรับชมจากตำแหน่งการเล่นต่างๆ

  • ตัวอย่างเจ้าของเนื้อหา

    • ตำแหน่งการเล่น
      • จำนวนยอดดูและเวลาในการรับชมจากตำแหน่งการเล่นที่แตกต่างกัน
      • ยอดดูรายวันและเวลาในการรับชมจากตำแหน่งการเล่นที่แตกต่างกัน
      • 10 อันดับแรก – เว็บไซต์ของบุคคลที่สามที่สร้างยอดดูให้กับวิดีโอที่ฝังมากที่สุด
      • จำนวนยอดดูและเวลาในการรับชมเพลย์ลิสต์จากตำแหน่งการเล่นต่างๆ
      • ยอดดูเพลย์ลิสต์รายวันและเวลาในการรับชมจากตำแหน่งการเล่นต่างๆ

รายละเอียดการเล่น

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

ตารางต่อไปนี้แสดงค่าของมิติข้อมูล
ค่า
LIVE_STREAM เนื้อหาที่ดูเป็นสตรีมแบบสดของ YouTube
SHORTS เนื้อหาที่ดูเป็น YouTube Shorts
STORY เนื้อหาที่ดูเป็น YouTube Story
VIDEO_ON_DEMAND เนื้อหาที่ดูเป็นวิดีโอ YouTube ที่ไม่ได้อยู่ภายใต้ค่ามิติข้อมูลอื่นๆ
UNSPECIFIED ไม่ทราบประเภทเนื้อหาที่ดู
liveOrOnDemand
มิติข้อมูลนี้ระบุว่าเมตริกกิจกรรมของผู้ใช้ในแถวข้อมูลเชื่อมโยงกับการดูการออกอากาศสดหรือไม่ ข้อมูลสําหรับมิติข้อมูลนี้จะใช้ได้กับวันที่ตั้งแต่วันที่ 1 เมษายน 2014 เป็นต้นไป

ตารางต่อไปนี้แสดงค่าของมิติข้อมูล
ค่า
LIVE ข้อมูลของแถวจะอธิบายกิจกรรมของผู้ใช้ที่เกิดขึ้นระหว่างสตรีมแบบสด
ON_DEMAND ข้อมูลของแถวจะอธิบายกิจกรรมของผู้ใช้ที่ไม่ได้เกิดขึ้นระหว่างสตรีมแบบสด
subscribedStatus
มิติข้อมูลนี้ระบุว่าเมตริกกิจกรรมของผู้ใช้ในแถวข้อมูลเชื่อมโยงกับผู้ชมที่ติดตามช่องของวิดีโอหรือเพลย์ลิสต์หรือไม่ ค่าที่เป็นไปได้คือ SUBSCRIBED และ UNSUBSCRIBED

โปรดทราบว่าค่ามิติข้อมูลจะถูกต้อง ณ เวลาที่เกิดกิจกรรมของผู้ใช้ ตัวอย่างเช่น สมมติว่าผู้ใช้ไม่ได้ติดตามช่องและดูวิดีโอของช่องนั้น จากนั้นติดตามช่องและดูวิดีโออีกรายการหนึ่งในวันเดียวกัน รายงานของช่องระบุว่ายอดดู 1 ครั้งมีค่า subscribedStatus เป็น SUBSCRIBED และยอดดู 1 ครั้งมีค่า subscribedStatus เป็น UNSUBSCRIBED
youtubeProduct
มิติข้อมูลนี้ระบุบริการ YouTube ที่กิจกรรมของผู้ใช้เกิดขึ้น ข้อมูลสําหรับมิติข้อมูลนี้มีให้บริการตั้งแต่วันที่ 18 กรกฎาคม 2015

ตารางต่อไปนี้แสดงค่ามิติข้อมูล
ค่า
CORE กิจกรรมของผู้ใช้ที่ไม่ได้เกิดขึ้นในแอปพลิเคชัน YouTube เฉพาะทาง (YouTube Gaming, YouTube Kids หรือ YouTube Music) ข้อยกเว้น: กิจกรรมของผู้ใช้ที่เกิดขึ้นใน YouTube Music ก่อนวันที่ 1 มีนาคม 2021 จะรวมอยู่ใน CORE
GAMING กิจกรรมของผู้ใช้เกิดขึ้นใน YouTube Gaming
KIDS กิจกรรมของผู้ใช้เกิดขึ้นใน YouTube Kids
MUSIC กิจกรรมของผู้ใช้เกิดขึ้นใน YouTube Music ตั้งแต่วันที่ 1 มีนาคม 2021 เป็นต้นไป ข้อมูลก่อนวันที่ 1 มีนาคม 2021 จะรวมอยู่ใน CORE ระบบจะไม่บันทึกข้อมูลแบบเรียลไทม์
UNKNOWN กิจกรรมของผู้ใช้เกิดขึ้นก่อนวันที่ 18 กรกฎาคม 2015

แหล่งที่มาของการเข้าชม

insightTrafficSourceType
ระบบจะรวบรวมข้อมูลในรายงานตามประเภทผู้อ้างอิง ซึ่งอธิบายลักษณะที่ผู้ใช้เข้าถึงวิดีโอ ค่าที่เป็นไปได้สำหรับมิติข้อมูลนี้ ได้แก่
  • ADVERTISING – ผู้ชมมาที่วิดีโอจากการโฆษณา หากคุณกรองตามแหล่งที่มาของการเข้าชมนี้ ช่อง insightTrafficSourceDetail จะระบุประเภทของโฆษณา
  • ANNOTATION – ผู้ชมเข้าถึงวิดีโอโดยการคลิกคำอธิบายประกอบในวิดีโออื่น
  • CAMPAIGN_CARD – ยอดดูที่มาจากวิดีโอที่ผู้ใช้อัปโหลดซึ่งอ้างสิทธิ์แล้วและเจ้าของเนื้อหาใช้เพื่อโปรโมตเนื้อหาที่มีการดู แหล่งที่มาของการเข้าชมนี้ใช้ได้กับรายงานของเจ้าของเนื้อหาเท่านั้น
  • END_SCREEN – ยอดดูมาจาก End Screen ของวิดีโออื่น
  • EXT_URL – ยอดดูวิดีโอมาจากลิงก์ในเว็บไซต์อื่น หากคุณกรองตามแหล่งที่มาของการเข้าชมนี้ ช่อง insightTrafficSourceDetail จะระบุหน้าเว็บ แหล่งที่มาของการเข้าชมนี้รวมถึงการอ้างอิงจากผลการค้นหาของ Google Search
  • HASHTAGS – ยอดดูที่มาจากหน้าแฮชแท็ก VOD หรือหน้า Pivot Page ของแฮชแท็ก Shorts
  • LIVE_REDIRECT - ยอดดูวิดีโอมาจากการส่งผู้ชมแบบสด
  • NO_LINK_EMBEDDED – วิดีโอถูกฝังอยู่ในเว็บไซต์อื่นเมื่อมีการดู
  • NO_LINK_OTHER – YouTube ไม่ได้ระบุ URL ที่มาของการเข้าชม หมวดหมู่นี้ครอบคลุมการเข้าชมวิดีโอโดยตรง รวมถึงการเข้าชมในแอปบนอุปกรณ์เคลื่อนที่
  • NOTIFICATION – ยอดดูวิดีโอมาจากอีเมลหรือการแจ้งเตือนจาก YouTube
  • PLAYLIST – ยอดดูวิดีโอเกิดขึ้นขณะที่วิดีโอเล่นเป็นส่วนหนึ่งของเพลย์ลิสต์ ซึ่งรวมถึงการเข้าชมที่มาจากหน้าเพลย์ลิสต์
  • PRODUCT_PAGE - ยอดดูวิดีโอมาจากหน้าผลิตภัณฑ์
  • PROMOTED – ยอดดูวิดีโอมาจากโปรโมชันของ YouTube ที่ไม่มีค่าใช้จ่าย เช่น หน้า "วิดีโอ Spotlight" ของ YouTube
  • RELATED_VIDEO – การดูวิดีโอได้รับการอ้างอิงจากรายการวิดีโอที่เกี่ยวข้องในหน้าดูวิดีโออื่น หากคุณกรองตามแหล่งที่มาของการเข้าชมนี้ ช่อง insightTrafficSourceDetail จะระบุรหัสวิดีโอของวิดีโอนั้น
  • SHORTS – ผู้ชมได้รับการอ้างอิงโดยการปัดขึ้น-ลงจากวิดีโอก่อนหน้าในประสบการณ์การรับชม Shorts
  • SOUND_PAGE – ยอดดูที่มาจากหน้า Pivot Page ของเสียงใน Shorts
  • SUBSCRIBER – ยอดดูวิดีโอมาจากฟีดในหน้าแรกของ YouTube หรือฟีเจอร์การติดตามของ YouTube หากคุณกรองตามแหล่งที่มาของการเข้าชมนี้ ช่อง insightTrafficSourceDetail จะระบุรายการฟีดในหน้าแรกหรือหน้าอื่นๆ ที่อ้างอิงยอดดู
  • YT_CHANNEL – ยอดดูวิดีโอเกิดขึ้นในหน้าช่อง หากคุณกรองตามแหล่งที่มาของการเข้าชมนี้ ช่อง insightTrafficSourceDetail จะระบุรหัสช่องของช่องนั้น
  • YT_OTHER_PAGE – ยอดดูวิดีโอมาจากลิงก์อื่นที่ไม่ใช่ผลการค้นหาหรือลิงก์วิดีโอที่เกี่ยวข้องซึ่งปรากฏในหน้า YouTube หากคุณกรองตามแหล่งที่มาของการเข้าชมนี้ ช่อง insightTrafficSourceDetail จะระบุหน้าเว็บ
  • YT_SEARCH – ยอดดูวิดีโอมาจากผลการค้นหาของ YouTube หากคุณกรองตามแหล่งที่มาของการเข้าชมนี้ ช่อง insightTrafficSourceDetail จะระบุข้อความค้นหา
  • VIDEO_REMIXES – ยอดดูวิดีโอมาจากลิงก์วิดีโอรีมิกซ์ในเพลเยอร์ Shorts หากคุณกรองตามแหล่งที่มาของการเข้าชมนี้ ช่อง insightTrafficSourceDetail จะระบุวิดีโอที่อ้างอิงผู้ชม
insightTrafficSourceDetail
ระบบจะรวบรวมข้อมูลในรายงานตาม URL ที่มาซึ่งสร้างยอดดูมากที่สุดสําหรับวิดีโอที่ระบุและแหล่งที่มาของการเข้าชมที่ระบุ รายการต่อไปนี้ระบุแหล่งที่มาของการเข้าชมที่ใช้รายงานนี้ได้ รายการจะระบุข้อมูลที่มิติข้อมูล insightTrafficSourceDetail ให้ไว้สําหรับแหล่งที่มาของการเข้าชมแต่ละแหล่ง
  • ADVERTISING – ประเภทโฆษณาที่ทําให้เกิดยอดดู ค่าที่เป็นไปได้มีดังนี้
    • โฆษณาเพื่อการมีส่วนร่วมแบบคลิกเพื่อเล่น
    • โฆษณาเพื่อการมีส่วนร่วม
    • โฆษณา Google Search
    • วิดีโอโฆษณาบนหน้าแรก
    • ในสตรีมแบบข้ามได้ซึ่งสงวนไว้
    • TrueView ใน Search และ Display
    • TrueView ในสตรีม
    • การโฆษณาบน YouTube ที่ไม่จัดอยู่ในหมวดหมู่ใดๆ
    • แผงวิดีโอ
  • CAMPAIGN_CARD – วิดีโอที่อ้างสิทธิ์ซึ่งนำผู้ชมไปยังวิดีโอที่ระบุในรายงาน
  • END_SCREEN – วิดีโอที่นำผู้ชมไปยังวิดีโอที่ระบุในรายงาน
  • EXT_URL – เว็บไซต์ที่นําผู้ชมไปยังวิดีโอ
  • HASHTAGS – แฮชแท็กที่ทําให้เกิดยอดดู
  • NOTIFICATION – อีเมลหรือการแจ้งเตือนที่อ้างอิงการเข้าชม
  • RELATED_VIDEO – วิดีโอที่เกี่ยวข้องซึ่งนำผู้ชมไปยังวิดีโอที่กล่าวถึงในรายงาน
  • SOUND_PAGE – วิดีโอที่ทำให้เกิดยอดดู
  • SUBSCRIBER – รายการฟีดบนหน้าแรกหรือฟีเจอร์การติดตามของ YouTube ที่นำผู้ชมไปยังวิดีโอที่กล่าวถึงในรายงาน ค่าที่ใช้ได้มีดังนี้
    • activity – จำนวนการดูจากรายการในฟีดการติดตามหน้าแรกที่มาจากกิจกรรมในช่องที่ไม่ใช่การอัปโหลดและไม่ใช่ทางสังคม ได้แก่ การกดชอบ การเพิ่มในรายการโปรด โพสต์กระดานข่าวสาร และการเพิ่มเพลย์ลิสต์
    • blogged – จำนวนการดูจากรายการในฟีดการติดตามหน้าแรกซึ่งเกิดจากการคลิกลิงก์จากบล็อกยอดนิยม
    • mychannel – การดูจากรายการในฟีดอื่นๆ ที่แสดงในหน้าแรก เช่น "วิดีโอที่ชอบ" "ประวัติการดู" และ "ดูภายหลัง"
    • podcasts – การดูที่มาจากรายการในหน้าปลายทางของพอดแคสต์
    • sdig – ยอดดูที่มาจากอีเมลอัปเดตการติดตาม
    • uploaded – จำนวนการดูจากรายการ uploaded รายการในฟีดการติดตามหน้าแรก
    • / – ยอดดูอื่นๆ ที่มาจากหน้าแรกของ YouTube
    • /my_subscriptions – ยอดดูที่มาจากหน้าการติดตามของฉันบน YouTube ของผู้ใช้
  • YT_CHANNEL – หน้าช่องที่ผู้ชมดูวิดีโอ
  • YT_OTHER_PAGE – หน้า YouTube ที่นำผู้ชมไปยังวิดีโอ
  • YT_SEARCH – ข้อความค้นหาที่นำผู้ชมไปยังวิดีโอ
  • VIDEO_REMIXES – วิดีโอที่ทำให้เกิดยอดดู

ตัวอย่าง

คําขอตัวอย่างต่อไปนี้ใช้มิติข้อมูลแหล่งที่มาของการเข้าชม

  • ตัวอย่างช่อง

    • แหล่งที่มาของการเข้าชม
      • ยอดดูและเวลาในการรับชมจากแหล่งที่มาของการเข้าชมต่างๆ ในประเทศ
      • ยอดดูรายวันและเวลาในการรับชมจากแหล่งที่มาของการเข้าชมต่างๆ
      • 10 อันดับแรก – ข้อความค้นหาบน YouTube ที่สร้างการเข้าชมมากที่สุดสำหรับวิดีโอ
      • 10 อันดับแรก – ข้อความค้นหาใน Google ที่สร้างการเข้าชมมากที่สุดสำหรับวิดีโอ
      • จำนวนยอดดูและเวลาในการรับชมเพลย์ลิสต์จากแหล่งที่มาของการเข้าชมต่างๆ ในประเทศหนึ่งๆ
      • จำนวนยอดดูและเวลาในการรับชมเพลย์ลิสต์รายวันจากแหล่งที่มาของการเข้าชมต่างๆ

  • ตัวอย่างเจ้าของเนื้อหา

    • แหล่งที่มาของการเข้าชม
      • จำนวนยอดดูและเวลาในการรับชมจากแหล่งที่มาของการเข้าชมต่างๆ
      • ยอดดูรายวันและเวลาในการรับชมจากแหล่งที่มาของการเข้าชมต่างๆ
      • 10 อันดับแรก – ข้อความค้นหาบน YouTube ที่สร้างการเข้าชมมากที่สุดสำหรับวิดีโอ
      • 10 อันดับแรก – ข้อความค้นหาใน Google ที่สร้างการเข้าชมมากที่สุดสำหรับวิดีโอ
      • จำนวนยอดดูและเวลาในการรับชมเพลย์ลิสต์จากแหล่งที่มาของการเข้าชมต่างๆ ในประเทศหนึ่งๆ
      • จำนวนยอดดูและเวลาในการรับชมเพลย์ลิสต์รายวันจากแหล่งที่มาของการเข้าชมต่างๆ

อุปกรณ์

deviceType
มิติข้อมูลนี้ระบุรูปแบบของอุปกรณ์จริงที่ทำให้เกิดยอดดู รายการต่อไปนี้ระบุประเภทอุปกรณ์ที่ API แสดงผลข้อมูล นอกจากนี้ คุณยังใช้มิติข้อมูล deviceType เป็นตัวกรองเพื่อจํากัดรายงานระบบปฏิบัติการให้มีเฉพาะข้อมูลของอุปกรณ์บางประเภทได้ด้วย
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • UNKNOWN_PLATFORM
operatingSystem
มิติข้อมูลนี้ระบุระบบซอฟต์แวร์ของอุปกรณ์ที่มียอดดูเกิดขึ้น รายการต่อไปนี้ระบุระบบปฏิบัติการที่ API แสดงผลข้อมูล นอกจากนี้ คุณยังใช้ operatingSystem เป็นตัวกรองเพื่อจํากัดรายงานประเภทอุปกรณ์ให้แสดงเฉพาะข้อมูลสําหรับระบบปฏิบัติการที่เฉพาะเจาะจงได้
  • ANDROID
  • BADA
  • BLACKBERRY
  • CHROMECAST
  • DOCOMO
  • FIREFOX
  • HIPTOP
  • IOS
  • KAIOS
  • LINUX
  • MACINTOSH
  • MEEGO
  • NINTENDO_3DS
  • OTHER
  • PLAYSTATION
  • PLAYSTATION_VITA
  • REALMEDIA
  • SMART_TV
  • SYMBIAN
  • TIZEN
  • VIDAA
  • WEBOS
  • WII
  • WINDOWS
  • WINDOWS_MOBILE
  • XBOX

ตัวอย่าง

คําขอตัวอย่างต่อไปนี้ใช้มิติข้อมูลอุปกรณ์

  • ตัวอย่างช่อง

    • อุปกรณ์/ระบบปฏิบัติการ
      • เมตริกประเภทอุปกรณ์รายวันสําหรับระบบปฏิบัติการ Android
      • เมตริกระบบปฏิบัติการรายวันสําหรับอุปกรณ์เคลื่อนที่
      • เมตริกระบบปฏิบัติการและประเภทอุปกรณ์รายวัน
      • เมตริกประเภทอุปกรณ์รายวันสำหรับการดูเพลย์ลิสต์ในระบบปฏิบัติการ Android
      • เมตริกระบบปฏิบัติการรายวันสําหรับยอดดูเพลย์ลิสต์ในอุปกรณ์เคลื่อนที่

  • ตัวอย่างเจ้าของเนื้อหา

    • อุปกรณ์/ระบบปฏิบัติการ
      • เมตริกประเภทอุปกรณ์รายวันสำหรับวิดีโอที่อ้างสิทธิ์
      • เมตริกระบบปฏิบัติการรายวันสำหรับวิดีโอที่อ้างสิทธิ์ซึ่งรับชมบนอุปกรณ์เคลื่อนที่
      • เมตริกระบบปฏิบัติการและประเภทอุปกรณ์รายวัน
      • เมตริกประเภทอุปกรณ์รายวันสำหรับการดูเพลย์ลิสต์ในระบบปฏิบัติการ Android
      • เมตริกระบบปฏิบัติการรายวันสําหรับยอดดูเพลย์ลิสต์ในอุปกรณ์เคลื่อนที่

ข้อมูลประชากร

มิติข้อมูลประชากรจะช่วยให้คุณเข้าใจการแจกแจงช่วงอายุและเพศของผู้ชม ศูนย์ช่วยเหลือของ YouTube มีข้อมูลเพิ่มเติมเกี่ยวกับข้อมูลประชากรในรายงาน YouTube Analytics

ageGroup (มิติข้อมูลหลัก)
มิติข้อมูลนี้จะระบุกลุ่มอายุของผู้ใช้ที่เข้าสู่ระบบซึ่งเชื่อมโยงกับข้อมูลรายงาน API ใช้กลุ่มอายุต่อไปนี้
  • age13-17
  • age18-24
  • age25-34
  • age35-44
  • age45-54
  • age55-64
  • age65-
This is a core dimension and is subject to the Deprecation Policy.
เพศ (มิติข้อมูลหลัก)
มิติข้อมูลนี้จะระบุเพศของผู้ใช้ที่เข้าสู่ระบบซึ่งเชื่อมโยงกับข้อมูลรายงาน ค่าที่ใช้ได้คือ female, male และ user_specified This is a core dimension and is subject to the Deprecation Policy.

ตัวอย่าง

คําขอตัวอย่างต่อไปนี้ใช้มิติข้อมูลประชากร

  • ตัวอย่างช่อง

    • ข้อมูลประชากร
      • ข้อมูลประชากรของผู้ชมในแคลิฟอร์เนีย (กลุ่มอายุและเพศ)
      • ข้อมูลประชากรของผู้ชมเพลย์ลิสต์ในแคลิฟอร์เนีย (กลุ่มอายุและเพศ)

  • ตัวอย่างเจ้าของเนื้อหา

    • ข้อมูลประชากร
      • ข้อมูลประชากรของผู้ชมในแคลิฟอร์เนีย (กลุ่มอายุและเพศ)
      • ข้อมูลประชากรของผู้ชมเพลย์ลิสต์ในแคลิฟอร์เนีย (กลุ่มอายุและเพศ)

การมีส่วนร่วมและการแชร์เนื้อหา

sharingService (มิติข้อมูลหลัก)
มิติข้อมูลนี้ระบุบริการที่ใช้แชร์วิดีโอ คุณสามารถแชร์วิดีโอบน YouTube (หรือผ่านโปรแกรมเล่น YouTube) ได้โดยใช้ปุ่ม "แชร์" This is a core dimension and is subject to the Deprecation Policy.

ตารางต่อไปนี้แสดงค่ามิติข้อมูลที่ถูกต้อง
บริการสำหรับการแชร์ ค่า API
Ameba AMEBA
Android Email ANDROID_EMAIL
Android Messages ANDROID_MESSENGER
การรับส่งข้อความของ Android ANDROID_MMS
Blackberry Messenger BBM
Blogger BLOGGER
คัดลอกไปยังคลิปบอร์ด COPY_PASTE
Cyworld CYWORLD
Digg DIGG
Dropbox DROPBOX
ฝัง EMBED
อีเมล MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
หน้า Facebook FACEBOOK_PAGES
Fotka FOTKA
Gmail GMAIL
goo GOO
Google+ GOOGLEPLUS
Go SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
ข้อความ HTC HTC_MMS
Google Inbox INBOX
กล่องโต้ตอบกิจกรรมของระบบ iOS IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO Story KAKAO_STORY
Kakao (Kakao Talk) KAKAO
Kik KIK
อีเมล LGE LGE_EMAIL
บรรทัด LINE
Linkedin LINKEDIN
LiveJournal LIVEJOURNAL
menéame MENEAME
mixi MIXI
Motorola Messaging MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
การแชร์ใกล้เคียง NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (Одноклассники) ODNOKLASSNIKI
อื่นๆ OTHER
Pinterest PINTEREST
Rakuten (楽天市場) RAKUTEN
reddit REDDIT
Skype SKYPE
Skyrock SKYBLOG
Sony Conversations SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
ข้อความ TEXT_MESSAGE
Tuenti TUENTI
tumblr TUMBLR
Twitter TWITTER
ไม่ทราบ UNKNOWN
Verizon Messages VERIZON_MMS
Viber VIBER
VKontakte (ВКонтакте) VKONTAKTE
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
Wykop WYKOP
Yahoo! ญี่ปุ่น YAHOO
YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Music YOUTUBE_MUSIC
YouTube TV YOUTUBE_TV

ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบความช่วยเหลือ

ตัวอย่าง

คําขอตัวอย่างต่อไปนี้ใช้มิติข้อมูลโซเชียล

  • ตัวอย่างช่อง

    • โซเชียล: การแชร์เมตริกที่รวบรวมตามบริการที่มีการแชร์วิดีโอ

  • ตัวอย่างเจ้าของเนื้อหา

    • โซเชียล: การแชร์เมตริกที่รวบรวมตามบริการที่มีการแชร์วิดีโอ

การคงผู้ชมไว้

elapsedVideoTimeRatio
มิติข้อมูลนี้ระบุอัตราส่วนของส่วนที่ผ่านไปแล้วของวิดีโอต่อความยาวของวิดีโอ มิติข้อมูลและเมตริกการคงผู้ชมไว้ใช้วัดการคงผู้ชมไว้เมื่อเวลาผ่านไป และมิติข้อมูล elapsedVideoTimeRatio คือการวัดเวลา เช่น ค่า 0.4 บ่งบอกว่าข้อมูลรายงานที่เกี่ยวข้องแสดงข้อมูลการคงผู้ใช้ไว้หลังจากวิดีโอเล่นไปแล้ว 40 เปอร์เซ็นต์

API จะแสดงผลจุดข้อมูล 100 จุดสําหรับวิดีโอแต่ละรายการซึ่งมีค่าอัตราส่วนตั้งแต่ 0.01 ถึง 1.0 ช่วงเวลาที่วัดข้อมูลระหว่างการเล่นวิดีโอจะเท่ากันสำหรับแต่ละวิดีโอ ซึ่งหมายความว่าสำหรับวิดีโอความยาว 2 นาที ช่วงเวลาระหว่างจุดข้อมูลคือ 1.2 วินาที แต่สำหรับวิดีโอความยาว 2 ชั่วโมง ช่วงเวลาระหว่างจุดข้อมูลคือ 72 วินาที ค่าของมิติข้อมูลจะแสดงถึงจุดสิ้นสุดของช่วงเวลาแบบไม่รวม
audienceType (ตัวกรองเท่านั้น)
ค่ามิติข้อมูลระบุประเภทการเข้าชมที่เชื่อมโยงกับข้อมูลรายงาน ค่าที่รองรับคือ ORGANIC, AD_INSTREAM และ AD_INDISPLAY ดูคำอธิบายแหล่งที่มาของการเข้าชมประเภทเหล่านี้ได้ที่ศูนย์ช่วยเหลือของ YouTube

โปรดทราบว่าข้อมูลสําหรับตัวกรอง audienceType จะพร้อมใช้งานตั้งแต่วันที่ 25 กันยายน 2013 API จะไม่แสดงผลลัพธ์สําหรับการค้นหาที่ใช้ตัวกรองเพื่อพยายามดึงข้อมูลจากวันที่ก่อนหน้า การค้นหาที่ไม่ได้ใช้ตัวกรองจะใช้ได้กับวันที่หลังวันที่ 1 กรกฎาคม 2008

ตัวอย่าง

คําขอตัวอย่างต่อไปนี้ใช้มิติข้อมูลการคงผู้ชมไว้

สตรีมมิงแบบสด

livestreamPosition
มิติข้อมูลนี้ระบุนาทีที่เจาะจงในระหว่างสตรีมวิดีโอสด เมตริกรายงานจะระบุจํานวนผู้ใช้ที่ดูสตรีมแบบสดในเวลานั้น

การยกเลิกการเป็นสมาชิก

membershipsCancellationSurveyReason
จำนวนแบบสำรวจที่ผู้ใช้ YouTube ตอบซึ่งยกเลิกการเป็นสมาชิกของช่องที่ระบุในช่วงระยะเวลาการรายงาน ตารางต่อไปนี้แสดงค่ามิติข้อมูลที่ถูกต้อง
ค่า API คำอธิบาย
UNKNOWN ผู้ใช้ไม่ได้ทำแบบสํารวจจนเสร็จสมบูรณ์
DISLIKE_PERKS ผู้ใช้ไม่ชอบสิทธิพิเศษของการเป็นสมาชิก
PERKS_NOT_DELIVERED ผู้ใช้กล่าวว่าไม่ได้รับสิทธิพิเศษจากการเป็นสมาชิกตามที่สัญญาไว้
CANNOT_ACCESS_PERKS ผู้ใช้ไม่สามารถเข้าถึงสิทธิพิเศษ
NO_LONGER_INTERESTED ผู้ใช้ไม่สนใจการเป็นสมาชิกของช่องแล้ว
FEEL_UNAPPRECIATED ผู้ใช้รู้สึกว่าตนไม่ได้รับคุณค่าในฐานะสมาชิกของช่อง
FINANCIAL_REASONS ผู้ใช้ยกเลิกเนื่องจากเหตุผลด้านการเงิน
JOIN_LIMITED_TIME ผู้ใช้ตั้งใจจะเข้าร่วมเพียงระยะเวลาหนึ่งเท่านั้น
OTHER ผู้ใช้มีเหตุผลอื่นในการยกเลิก

ประสิทธิภาพโฆษณา

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

  • auctionBumperInstream – โฆษณาวิดีโอแบบข้ามไม่ได้ที่แสดงผ่านราคาเสนอซึ่งมีความยาวได้สูงสุด 6 วินาที โดยผู้ชมต้องดูโฆษณานี้ก่อนที่จะดูวิดีโอได้

  • auctionDisplay – โฆษณาแบบริชมีเดียหรือโฆษณาแบบรูปภาพที่ปรากฏเป็นโฆษณาซ้อนทับที่ด้านล่างของโปรแกรมเล่นวิดีโอ เป็นหน่วยโฆษณาขนาด 300x250 ในหน้าดูวิดีโอ หรือเป็นทั้ง 2 แบบรวมกัน เมื่อการวางซ้อนทำงาน การวางซ้อนจะปิดโดยอัตโนมัติหลังจากแสดงเป็นระยะเวลาหนึ่ง และผู้ใช้ก็ปิดการวางซ้อนได้เช่นกัน หากโฆษณาซ้อนทับและแบนเนอร์แสดงร่วมกัน ระบบจะนับโฆษณาแต่ละรายการเป็นการแสดงผลแยกกัน

  • auctionInstream – โฆษณาวิดีโอแบบข้ามไม่ได้ที่เล่นก่อน ระหว่าง หรือหลังวิดีโอหลัก

  • auctionTrueviewInslate – ผู้ชมเลือกโฆษณาวิดีโอรายการใดรายการหนึ่งจากตัวเลือกที่แสดงก่อนวิดีโอ See the TrueView documentation for more information.

  • auctionTrueviewInstream – โฆษณาวิดีโอแบบข้ามได้ที่แสดงก่อนหรือระหว่างวิดีโอหลัก ดูข้อมูลเพิ่มเติมในเอกสารประกอบของ TrueView

  • auctionUnknown – โฆษณาที่ซื้อผ่านการประมูล AdWords แต่ยังไม่ได้จัดประเภทเป็นโฆษณาประเภทอื่น

  • reservedBumperInstream – โฆษณาวิดีโอแบบข้ามไม่ได้ที่ขายแบบจองล่วงหน้า โดยมีความยาวได้สูงสุด 6 วินาที ซึ่งผู้ชมต้องดูก่อนที่จะดูวิดีโอ

  • reservedClickToPlay – โฆษณาวิดีโอที่ผู้ใช้ต้องคลิกเพื่อเริ่มเล่น ระบบจะบันทึกการแสดงโฆษณาทุกครั้งที่หน่วยโฆษณาแบบคลิกเพื่อเล่นแสดงขึ้น ไม่ว่าผู้ใช้จะเริ่มเล่นหรือไม่ก็ตาม ตำแหน่งเหล่านี้จะขายแบบจอง

  • reservedDisplay – โฆษณาแบบริชมีเดียหรือโฆษณาแบบรูปภาพที่ปรากฏเป็นโฆษณาซ้อนทับที่ด้านล่างของโปรแกรมเล่นวิดีโอ เป็นหน่วยโฆษณาขนาด 300x250 ในหน้าดูวิดีโอ หรือเป็นทั้ง 2 แบบรวมกัน เมื่อการวางซ้อนทำงาน การวางซ้อนจะปิดโดยอัตโนมัติหลังจากแสดงเป็นระยะเวลาหนึ่ง และผู้ใช้ก็ปิดการวางซ้อนได้เช่นกัน หากโฆษณาซ้อนทับและแบนเนอร์แสดงร่วมกัน ระบบจะนับโฆษณาแต่ละรายการเป็นการแสดงผลแยกกัน

  • reservedInstream – โฆษณาวิดีโอแบบข้ามไม่ได้ที่แทรกอยู่ก่อน ระหว่าง หรือหลังวิดีโอหลัก

  • reservedInstreamSelect

  • reservedMasthead – โฆษณาขนาดใหญ่ที่อาจประกอบด้วยองค์ประกอบวิดีโอและกราฟิก ซึ่งปรากฏในหน้าแรก

  • reservedUnknown – โฆษณาที่ขายแบบจองไว้ซึ่งจัดอยู่ในประเภทโฆษณาอื่นไม่ได้

  • unknown – YouTube ไม่สามารถจัดประเภทโฆษณาประเภทนี้ได้

ตัวอย่าง

รายงานตัวอย่างต่อไปนี้จะดึงข้อมูลเมตริกประสิทธิภาพโฆษณาหรือรายได้

  • ตัวอย่างช่อง

    • รายได้/โฆษณา
      • เมตริกรายได้ของช่องและประสิทธิภาพโฆษณา
      • เมตริกรายได้และประสิทธิภาพโฆษณารายวัน
      • เมตริกรายได้และประสิทธิภาพโฆษณาเฉพาะประเทศ
      • 10 อันดับแรก – วิดีโอที่มีรายได้สูงสุด
      • เมตริกประสิทธิภาพของโฆษณาสําหรับโฆษณาประเภทต่างๆ

  • ตัวอย่างเจ้าของเนื้อหา

    • รายได้/โฆษณา
      • เมตริกรายได้และประสิทธิภาพโฆษณาของเนื้อหาที่อ้างสิทธิ์
      • เมตริกรายได้และประสิทธิภาพโฆษณารายวัน
      • เมตริกรายได้และประสิทธิภาพโฆษณาเฉพาะประเทศ
      • 10 อันดับแรก – วิดีโอที่มีรายได้สูงสุด
      • เมตริกประสิทธิภาพของโฆษณาสําหรับโฆษณาประเภทต่างๆ

มิติข้อมูลเจ้าของเนื้อหา

มิติข้อมูลต่อไปนี้ใช้ได้กับรายงานเจ้าของเนื้อหาเท่านั้น

สำคัญ: คำขอ API เพื่อดึงข้อมูลรายงานของเจ้าของเนื้อหาต้องกรองข้อมูลโดยใช้มิติข้อมูลอย่างใดอย่างหนึ่งต่อไปนี้
  • video
  • channel
  • ชุดค่าผสมที่รองรับของมิติข้อมูล claimedStatus และ uploaderType ตามที่ระบุไว้ด้านล่าง
claimedStatus (ใช้ในรายงานเจ้าของเนื้อหาเท่านั้น)
มิติข้อมูลนี้ช่วยให้คุณระบุได้ว่าการตอบกลับของ API ควรมีเฉพาะเมตริกสําหรับเนื้อหาที่อ้างสิทธิ์เท่านั้น ค่าที่ใช้ได้ค่าเดียวสำหรับมิติข้อมูลนี้คือ claimed หากพารามิเตอร์ filters จำกัดการค้นหาเป็น claimedStatus==claimed ทาง API จะเรียกข้อมูลของเนื้อหาที่อ้างสิทธิ์เท่านั้น ตารางในคําจํากัดความของมิติข้อมูล uploaderType มีรายละเอียดเพิ่มเติมเกี่ยวกับวิธีใช้มิติข้อมูลนี้
uploaderType (มิติข้อมูลหลัก) (ใช้ในรายงานของเจ้าของเนื้อหาเท่านั้น)
มิติข้อมูลนี้ช่วยให้คุณระบุได้ว่าการตอบกลับของ API ควรมีเมตริกสำหรับเนื้อหาที่อัปโหลดโดยเจ้าของเนื้อหาที่ระบุและ/หรือเนื้อหาที่อัปโหลดโดยบุคคลที่สาม เช่น วิดีโอที่ผู้ใช้อัปโหลดหรือไม่ ค่าที่ใช้ได้คือ self และ thirdParty มิติข้อมูลนี้เป็นมิติข้อมูลหลักและอยู่ภายใต้นโยบายการเลิกใช้งาน

ตารางด้านล่างแสดงชุดค่าผสมที่รองรับสําหรับมิติข้อมูล claimedStatus และ uploaderType ซึ่งทั้ง 2 รายการใช้ในพารามิเตอร์ filters

ค่า claimedStatus ค่า uploaderType คำอธิบาย
[ไม่ได้ตั้งค่า] self ดึงข้อมูล YouTube Analytics สำหรับเนื้อหาที่อ้างสิทธิ์และไม่ได้อ้างสิทธิ์ซึ่งเจ้าของเนื้อหาอัปโหลด
มีการอ้างสิทธิ์ [ไม่ได้ตั้งค่า] ดึงข้อมูลสำหรับเนื้อหาที่อ้างสิทธิ์ซึ่งอัปโหลดโดยเจ้าของเนื้อหาหรือบุคคลที่สาม
มีการอ้างสิทธิ์ self ดึงข้อมูลสำหรับเนื้อหาที่อ้างสิทธิ์ซึ่งอัปโหลดโดยเจ้าของเนื้อหา
มีการอ้างสิทธิ์ thirdParty ดึงข้อมูลของเนื้อหาที่มีการอ้างสิทธิ์ซึ่งอัปโหลดโดยบุคคลที่สาม

ตัวอย่าง

คําขอ API ตัวอย่างสําหรับรายงานเจ้าของเนื้อหาจํานวนมากใช้การรวมมิติข้อมูล claimedStatus และ uploaderType ที่รองรับเพื่อกรองข้อมูล