Dimensions

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

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

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

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

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

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

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

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

ตัวกรอง

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

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

  • IMMERSIVE_LIVE_FEED – ข้อมูลอธิบายยอดดูที่เกิดขึ้นในฟีดการถ่ายทอดสดแนวตั้ง

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

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

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

  • SHORTS_FEED – ข้อมูลนี้อธิบายยอดดูที่เกิดขึ้นในฟีด YouTube Shorts

  • 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
ข้อมูลในรายงานจะรวบรวมตามประเภทผู้อ้างอิง ซึ่งอธิบายลักษณะที่ผู้ใช้เข้าถึงวิดีโอ ค่าที่เป็นไปได้สำหรับมิติข้อมูลนี้ ได้แก่
  • 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 เช่น หน้า "วิดีโอสปอตไลท์" ของ 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 จะระบุวิดีโอที่อ้างอิงผู้ชม
  • WATCH_WITH – ยอดดูวิดีโอได้รับการอ้างอิงจากสตรีมความคิดเห็นของครีเอเตอร์ / "ดูด้วยกัน" หากคุณกรองตามแหล่งที่มาของการเข้าชมนี้ ช่อง 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 – วิดีโอที่ทำให้เกิดยอดดู
  • WATCH_WITH – วิดีโอที่ทำให้เกิดยอดดู

ตัวอย่าง

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

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

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

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

อุปกรณ์

deviceType
มิติข้อมูลนี้ระบุรูปแบบของอุปกรณ์ที่เกิดการดู รายการต่อไปนี้ระบุประเภทอุปกรณ์ที่ API แสดงผลข้อมูล นอกจากนี้ คุณยังใช้มิติข้อมูล deviceType เป็นตัวกรองเพื่อจำกัดรายงานระบบปฏิบัติการให้มีเฉพาะข้อมูลสำหรับอุปกรณ์บางประเภทได้ด้วย
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • AUTOMOTIVE
  • WEARABLE
  • 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 (มิติข้อมูลหลัก)
มิติข้อมูลนี้ระบุกลุ่มอายุของผู้ใช้ที่เข้าสู่ระบบซึ่งเชื่อมโยงกับข้อมูลการรายงาน และรวมถึงผู้ใช้ที่ YouTube คาดว่ามีอายุต่ำกว่า 18 ปี 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.
gender (มิติข้อมูลหลัก)
มิติข้อมูลนี้ระบุเพศของผู้ใช้ที่เข้าสู่ระบบซึ่งเชื่อมโยงกับข้อมูลการรายงาน ค่าที่ถูกต้องคือ 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
Allo ALLO
Ameba AMEBA
อีเมล Android ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
การรับส่งข้อความใน Android ANDROID_MMS
กล่องโต้ตอบการแชร์ของระบบ Android ANDROID_SYSTEM_SHARE_DIALOG
Blackberry Messenger BBM
ได้รับรีแอ็กชัน BLIND_REACT
Blogger BLOGGER
คัดลอกไปยังคลิปบอร์ด COPY_PASTE
Cyworld CYWORLD
Digg DIGG
กล่องโต้ตอบกิจกรรมของระบบโดยตรง DIRECT_SYSTEM_ACTIVITY_DIALOG
Discord DISCORD
คิวอาร์โค้ดที่แสดง DISPLAYED_QR_CODE
ดรอปบ็อกซ์ DROPBOX
ฝัง EMBED
อีเมล MAIL
Facebook FACEBOOK
Facebook Lite FACEBOOK_LITE
Facebook Messenger FACEBOOK_MESSENGER
หน้า Facebook FACEBOOK_PAGES
แชร์ไปยังกลุ่ม Facebook FACEBOOK_SHARE_TO_GROUP
Facebook Stories FACEBOOK_STORIES
Fotka FOTKA
Gmail GMAIL
goo GOO
แอป Google GOOGLE_APP
Google Chat GOOGLE_CHAT
Google Chrome GOOGLE_CHROME
กล่องจดหมาย Google INBOX
Google Keep GOOGLE_KEEP
Google+ GOOGLEPLUS
Go SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
ข้อความ HTC HTC_MMS
IMO IMO
Instagram INSTAGRAM
Instagram Stories INSTAGRAM_STORIES
ลิงก์คำเชิญ (Android) INVITE_LINK_ANDROID
ลิงก์คำเชิญ (iOS) INVITE_LINK_IOS
เชิญผู้ร่วมสร้างเพลย์ลิสต์ INVITE_PLAYLIST_COLLABORATORS
กล่องโต้ตอบกิจกรรมของระบบ iOS IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO Story KAKAO_STORY
Kakao (Kakao Talk) KAKAO
ข้อความ KaiOS KAIOS_MESSAGES
Kik KIK
อีเมล LGE LGE_EMAIL
บรรทัด LINE
Linkedin LINKEDIN
LiveJournal LIVEJOURNAL
คัดลอก/วาง Maps MAPS_COPY_PASTE
การแชร์สดของ Meet MEET_LIVE_SHARING
menéame MENEAME
mixi MIXI
Motorola Messaging MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
การแชร์ใกล้เคียง NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (Одноклассники) ODNOKLASSNIKI
อื่นๆ OTHER
Pinterest PINTEREST
Quick Share QUICK_SHARE
Quick Share (Samsung) QUICK_SHARE_SAMSUNG
Rakuten (楽天市場) RAKUTEN
reddit REDDIT
รีมิกซ์ REMIX
Samsung Messages SAMSUNG_MESSAGES
Samsung Notes SAMSUNG_NOTES
บันทึกลงในที่เก็บรูปภาพบนอุปกรณ์ SAVE_TO_DEVICE_PHOTOS
แชร์แบบไม่มีโฆษณา SHARE_AD_FREE
แชร์ไปยังกล้อง Snapchat SHARE_TO_SNAPCHAT_CAMERA
แชร์กับบุตรหลาน SHARE_WITH_KIDS
Skype SKYPE
Skyrock SKYBLOG
Snapchat SNAPCHAT
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
กล่องโต้ตอบกิจกรรมของระบบบนเว็บ WEB_SYSTEM_ACTIVITY_DIALOG
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
WhatsApp Business WHATS_APP_BUSINESS
Wykop WYKOP
Yahoo! ญี่ปุ่น YAHOO
โพสต์ชุมชน YouTube YOUTUBE_COMMUNITY_POST
รีโพสต์ในชุมชน YouTube YOUTUBE_COMMUNITY_REPOST
YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Mango YOUTUBE_MANGO
YouTube Music YOUTUBE_MUSIC
แชร์จาก YouTube Music ไปยังพรีวิว Snapchat YTM_SHARE_TO_SNAPCHAT_PREVIEW
กรีนสกรีนของ YouTube Shorts YOUTUBE_SHORTS_GREEN_SCREEN
YouTube TV YOUTUBE_TV
ฟีเจอร์ดู YouTube กับเพื่อนๆ YOUTUBE_WATCH_WITH_FRIENDS

ดูข้อมูลเพิ่มเติมได้ในเอกสารความช่วยเหลือ

ตัวอย่าง

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

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

    • โซเชียล: เมตริกการแชร์ ซึ่งรวบรวมตามบริการที่มีการแชร์วิดีโอ
  • ตัวอย่างเจ้าของเนื้อหา

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

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

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 – ผู้ชมเลือกโฆษณาวิดีโอ 1 รายการจากตัวเลือกหลายรายการที่แสดงก่อนวิดีโอ 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 สำหรับเนื้อหาที่มีการอ้างสิทธิ์และไม่มีการอ้างสิทธิ์ซึ่งอัปโหลดโดยเจ้าของเนื้อหา
มีการอ้างสิทธิ์ [ไม่ได้ตั้งค่า] ดึงข้อมูลสำหรับเนื้อหาที่มีการอ้างสิทธิ์ซึ่งอัปโหลดโดยเจ้าของเนื้อหาหรือบุคคลที่สาม
มีการอ้างสิทธิ์ self ดึงข้อมูลสำหรับเนื้อหาที่มีการอ้างสิทธิ์ซึ่งอัปโหลดโดยเจ้าของเนื้อหา
มีการอ้างสิทธิ์ thirdParty ดึงข้อมูลสำหรับเนื้อหาที่อ้างสิทธิ์ซึ่งอัปโหลดโดยบุคคลที่สาม

ตัวอย่าง

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