Dimensions

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

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

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

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

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

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

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

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

ตัวกรอง

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

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

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

ขนาด

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

แหล่งข้อมูล

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

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

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

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

ตัวอย่าง

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

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

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

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

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

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

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

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

หมายเหตุ: หากการค้นหา API ใช้มิติข้อมูล month พารามิเตอร์ start-date และ end-date ต้องตั้งค่าเป็นวันแรกของเดือน 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> ตัวอย่างเช่น การเล่นในแอปพลิเคชันที่ใช้ API โปรแกรมเล่นบน Android ของ YouTube จะถูกจัดหมวดหมู่โดยใช้ค่านี้

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

    ตั้งแต่วันที่ 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
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
ข้อมูลในรายงานจะรวบรวมตามประเภท URL ที่มา ซึ่งอธิบายลักษณะที่ผู้ใช้เข้าถึงวิดีโอ ค่าที่เป็นไปได้สำหรับมิติข้อมูลนี้ ได้แก่
  • ADVERTISING - โฆษณาอ้างอิงผู้ชมมายังวิดีโอ หากคุณกรองตามแหล่งที่มาของการเข้าชมนี้ ช่อง insightTrafficSourceDetail จะระบุประเภทโฆษณา
  • ANNOTATION – ผู้ชมเข้าถึงวิดีโอโดยการคลิกคำอธิบายประกอบในวิดีโออื่น
  • CAMPAIGN_CARD – ยอดดูที่มาจากวิดีโอที่อ้างสิทธิ์ซึ่งผู้ใช้อัปโหลดไว้ ซึ่งเจ้าของเนื้อหาใช้เพื่อโปรโมตเนื้อหาที่มีคนดู แหล่งที่มาของการเข้าชมนี้รองรับเฉพาะรายงานเจ้าของเนื้อหาเท่านั้น
  • END_SCREEN – ยอดดูมาจากตอนท้ายของวิดีโออื่น
  • EXT_URL – ยอดดูวิดีโออ้างอิงมาจากลิงก์บนเว็บไซต์อื่น หากคุณกรองตามแหล่งที่มาของการเข้าชมนี้ ช่อง insightTrafficSourceDetail จะระบุหน้าเว็บ แหล่งที่มาของการเข้าชมนี้มีการอ้างอิงจากผลการค้นหาของ Google
  • HASHTAGS – ยอดดูที่มาจากหน้าแฮชแท็ก VOD หรือหน้า Pivot Page ของแฮชแท็ก Shorts
  • LIVE_REDIRECT - ยอดดูวิดีโออ้างอิงมาจากการส่งผู้ชมแบบสด
  • NO_LINK_EMBEDDED – วิดีโอถูกฝังอยู่ในเว็บไซต์อื่นเมื่อดู
  • NO_LINK_OTHER – YouTube ไม่ได้ระบุ URL ที่มาสำหรับการเข้าชม หมวดหมู่นี้จะรวมการเข้าชมวิดีโอโดยตรงและการเข้าชมในแอปบนอุปกรณ์เคลื่อนที่
  • NOTIFICATION - ยอดดูวิดีโอมาจากอีเมลหรือการแจ้งเตือนจาก YouTube
  • PLAYLIST – ยอดดูวิดีโอเกิดขึ้นขณะที่วิดีโอกำลังเล่นโดยเป็นส่วนหนึ่งของเพลย์ลิสต์ ซึ่งรวมถึงการเข้าชมที่มาจากหน้าเพลย์ลิสต์
  • PRODUCT_PAGE - ยอดดูวิดีโออ้างอิงจากหน้าผลิตภัณฑ์
  • PROMOTED – ยอดดูวิดีโอมาจากการโปรโมตบน YouTube แบบไม่เสียค่าใช้จ่าย เช่น "วิดีโอสปอตไลท์" ของ 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
ข้อมูลในรายงานจะรวบรวมตามผู้อ้างอิงที่สร้างยอดดูสูงสุดให้กับวิดีโอที่ระบุและประเภทแหล่งที่มาของการเข้าชมที่ระบุ รายการต่อไปนี้ระบุแหล่งที่มาของการเข้าชมที่สามารถใช้รายงานนี้ได้ รายการจะระบุข้อมูลของมิติข้อมูล insightTrafficSourceDetail สำหรับแหล่งที่มาของการเข้าชมแต่ละแห่ง
  • ADVERTISING – ประเภทของโฆษณาที่นำไปสู่ยอดดู โดยค่าที่เป็นไปได้มีดังนี้
    • โฆษณาเพื่อการมีส่วนร่วมแบบคลิกเพื่อเล่น
    • โฆษณาเพื่อการมีส่วนร่วม
    • โฆษณา Google Search
    • วิดีโอโฆษณาบนหน้าแรก
    • โฆษณาในสตรีมแบบข้ามได้ที่จองไว้
    • TrueView แบบในผลการค้นหาและแบบบนหน้าจอ
    • 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 ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
การรับส่งข้อความของ Android ANDROID_MMS
Blackberry Messenger BBM
Blogger BLOGGER
คัดลอกไปยังคลิปบอร์ด COPY_PASTE
ไซเวิลด์ CYWORLD
ดิกก์ DIGG
Dropbox DROPBOX
ฝัง EMBED
อีเมล MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
หน้า Facebook FACEBOOK_PAGES
ฟอตกา FOTKA
Gmail GMAIL
goo GOO
Google+ GOOGLEPLUS
ส่ง SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
ข้อความ HTC HTC_MMS
กล่องจดหมาย Google INBOX
กล่องโต้ตอบกิจกรรมของระบบ iOS IOS_SYSTEM_ACTIVITY_DIALOG
เรื่องราวของ KAKAO KAKAO_STORY
Kakao (Kakao Talk) KAKAO
Kik KIK
อีเมล LGE LGE_EMAIL
บรรทัด LINE
Linkedin LINKEDIN
LiveJournal LIVEJOURNAL
Menéame MENEAME
mixi MIXI
การรับส่งข้อความของ Motorola MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
การแชร์ใกล้เคียง NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (อินเทอร์เฟซใหม่днокласники) ODNOKLASSNIKI
อื่นๆ OTHER
Pinterest PINTEREST
ราคุเทน (楽天場) RAKUTEN
reddit REDDIT
Skype SKYPE
Skyrock SKYBLOG
การสนทนาของ Sony SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
SMS TEXT_MESSAGE
Tuenti TUENTI
tumblr TUMBLR
Twitter TWITTER
ไม่ทราบ UNKNOWN
ข้อความ Verizon VERIZON_MMS
Viber VIBER
วอกทาคเต (HOTКонтакте) 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 บนหน้าดูวิดีโอ หรือทั้งสองแบบรวมกัน เมื่อโฆษณาซ้อนทับทำงาน โฆษณาซ้อนทับจะปิดโดยอัตโนมัติหลังจากแสดงได้ระยะหนึ่ง และผู้ใช้สามารถปิดโฆษณาซ้อนทับได้เช่นกัน หากโฆษณาซ้อนทับและแบนเนอร์แสดงร่วมกัน โฆษณาแต่ละรายการจะนับเป็นการแสดงผลแยกกัน

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

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

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

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

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

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

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

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

  • reservedInstreamSelect

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

  • reservedUnknown – โฆษณาที่ขายด้วยการสงวนไว้ซึ่งไม่สามารถจัดประเภทเป็นโฆษณาประเภทอื่นได้

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

ตัวอย่าง

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

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

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

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

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

เพลย์ลิสต์

isCurated (ตัวกรองเท่านั้น)
ตัวกรองนี้ระบุว่าคำขอกำลังดึงข้อมูลเกี่ยวกับการดูวิดีโอที่เกิดขึ้นใน บริบทของเพลย์ลิสต์

ตัวอย่าง

ตัวอย่างคำขอทั้งหมดที่ดึงรายงานเพลย์ลิสต์นั้นใช้ตัวกรอง isCurated

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

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

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

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

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

ตัวอย่าง

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