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 ร่วมกัน

ขนาด

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

แหล่งข้อมูล

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

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

วิดีโอ (มิติข้อมูลหลัก)
รหัสของวิดีโอ YouTube ใน YouTube Data API ค่านี้คือค่าพร็อพเพอร์ตี้ id ของทรัพยากร video This is a core dimension and is subject to the Deprecation Policy.
เพลย์ลิสต์
รหัสเพลย์ลิสต์ 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 มักใช้ในรายงานของเจ้าของเนื้อหาเนื่องจากรายงานเหล่านั้นมักรวบรวมข้อมูลจากหลายช่อง
กลุ่ม (ตัวกรองเท่านั้น)
รหัสของกลุ่ม YouTube Analytics คุณจะดึงค่านี้ได้โดยใช้เมธอด groups.list ของ YouTube Analytics API เมื่อคุณใช้ตัวกรอง group การตอบกลับจาก API จะมีข้อมูลสำหรับวิดีโอ เพลย์ลิสต์ หรือช่องทั้งหมดในกลุ่มนั้น

ตัวอย่าง

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

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

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

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

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

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

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

ประเทศ (มิติข้อมูลหลัก)
ประเทศที่เชื่อมโยงกับเมตริกในแถวรายงาน ค่ามิติข้อมูลคือรหัสประเทศ 2 ตัวอักษรตามมาตรฐาน ISO-3166-1 เช่น 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 เป็นของตัวเองด้วย และยังไม่สนับสนุนการแยกย่อยในประเทศอื่นๆ ที่ไม่ใช่สหรัฐอเมริกาด้วย

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> เช่น การเล่นในแอปพลิเคชันที่ใช้ 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
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 – ยอดดูมาจาก 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
ข้อมูลในรายงานนี้จะรวบรวมโดยอิงจาก URL ที่มาซึ่งสร้างยอดดูสูงสุดสำหรับวิดีโอที่เฉพาะเจาะจงและประเภทแหล่งที่มาของการเข้าชมที่ระบุ รายการต่อไปนี้ระบุแหล่งที่มาของการเข้าชมที่สามารถใช้รายงานนี้ได้ สำหรับแหล่งที่มาของการเข้าชมแต่ละแห่ง รายการจะระบุข้อมูลที่มิติข้อมูล 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 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
อีเมล 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
ราคุเทน (楽天 without場) RAKUTEN
reddit REDDIT
Skype SKYPE
สกายร็อก SKYBLOG
การสนทนาของ Sony SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
SMS TEXT_MESSAGE
ตูเอนติ TUENTI
tumblr. TUMBLR
Twitter TWITTER
ไม่ทราบ UNKNOWN
ข้อความ Verizon VERIZON_MMS
Viber VIBER
VKontakte (จะปรากฏขึ้นเข้าสู่ระบบอย่างน้อยหนึ่งรายการ) VKONTAKTE
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
วิคอป 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

ตัวอย่าง

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

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

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

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

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

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

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

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

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

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

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

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

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

  • reservedInstreamSelect

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

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

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

ตัวอย่าง

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

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

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

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

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

เพลย์ลิสต์

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

ตัวอย่าง

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

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

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

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

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

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

ตัวอย่าง

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