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 รายการ

วิดีโอ (มิติข้อมูลหลัก)
รหัสของวิดีโอ 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มักใช้ในรายงานเจ้าของเนื้อหา เนื่องจากโดยปกติแล้วรายงานเหล่านั้นจะรวบรวมข้อมูลสำหรับหลายช่อง
group (ตัวกรองเท่านั้น)
รหัสของกลุ่มข้อมูลวิเคราะห์ YouTube คุณเรียกค่านี้ได้โดยใช้เมธอด groups.list ของ YouTube Analytics API เมื่อใช้groupตัวกรอง การตอบกลับของ API จะมีข้อมูลสำหรับวิดีโอ เพลย์ลิสต์ หรือช่องทั้งหมดในกลุ่มนั้น

ตัวอย่าง

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

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

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

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

    • สถิติพื้นฐาน
      • วิดีโอยอดนิยม 10 อันดับแรกของเจ้าของเนื้อหา
      • วิดีโอยอดนิยม 10 อันดับ - วิดีโอที่มีการรับชมมากที่สุดสำหรับเจ้าของเนื้อหา
      • 10 อันดับแรก - วิดีโอที่มีจำนวนการดูมากที่สุดในช่องของเจ้าของเนื้อหา
      • 10 อันดับแรก - อัตราการคลิกผ่านของคำอธิบายประกอบสำหรับวิดีโอที่มีการดูมากที่สุดของช่อง
      • 10 อันดับแรก - เพลย์ลิสต์ที่มีการรับชมมากที่สุดสำหรับเจ้าของเนื้อหา
    • ภูมิศาสตร์
      • Top 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
ทวีป (ตัวกรองเท่านั้น)
รหัสภูมิภาคทางสถิติของสหประชาชาติ (UN) API รองรับค่าต่อไปนี้
ค่า
002 แอฟริกา
019 อเมริกา (อเมริกาเหนือ ลาตินอเมริกา อเมริกาใต้ และแคริบเบียน)
142 เอเชีย
150 ยุโรป
009 โอเชียเนีย
มิติข้อมูลนี้ใช้ได้เฉพาะในการกรองข้อมูล หากต้องการใช้มิติข้อมูลนี้ ให้ตั้งค่าพารามิเตอร์ filters เป็น continent==REGION_CODE โดยระบุค่า REGION_CODE จากตาราง
subContinent (ตัวกรองเท่านั้น)
รหัสภูมิภาคทางสถิติของสหประชาชาติที่ระบุภูมิภาคย่อยทางภูมิศาสตร์ กองสถิติแห่งสหประชาชาติแสดงรายการภูมิภาคย่อย รวมถึงประเทศที่เชื่อมโยงกับแต่ละภูมิภาค

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

ตัวอย่าง

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

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

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

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

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

ระยะเวลา

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

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

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

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

    ตั้งแต่วันที่ 10 กันยายน 2013 เป็นต้นไป ระบบจะไม่จัดหมวดหมู่การเล่นซ้ำเป็นการMOBILEเล่นซ้ำในรายงานข้อมูลวิเคราะห์ YouTube อีกต่อไป ค่าอาจยังคงอยู่ในรายงานเนื่องจากข้อมูลเดิมยังคงอยู่ในหมวดหมู่นั้น อย่างไรก็ตาม หลังจากวันที่ดังกล่าว การเล่นบนอุปกรณ์เคลื่อนที่จะจัดประเภทเป็นการเล่น 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 รายการ จากนั้นก็ติดตามช่องและดูวิดีโออีกรายการ ทั้งหมดนี้เกิดขึ้นในวันเดียวกัน รายงานของช่องระบุว่ายอดดู 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 หรือหน้าแฮชแท็ก Shorts
  • LIVE_REDIRECT - มีการอ้างอิงยอดดูวิดีโอจากการเปลี่ยนเส้นทางจากวิดีโอสด
  • NO_LINK_EMBEDDED – วิดีโอถูกฝังอยู่ในเว็บไซต์อื่นเมื่อมีการดู
  • NO_LINK_OTHER – YouTube ไม่พบผู้แนะนำสำหรับการเข้าชม หมวดหมู่นี้ครอบคลุมการเข้าชมวิดีโอโดยตรงและการเข้าชมในแอปบนอุปกรณ์เคลื่อนที่
  • NOTIFICATION – ยอดดูวิดีโอมาจากการอ้างอิงจากอีเมลหรือการแจ้งเตือนจาก YouTube
  • PLAYLIST – ยอดดูวิดีโอเกิดขึ้นขณะที่วิดีโอเล่นเป็นส่วนหนึ่งของเพลย์ลิสต์ ซึ่งรวมถึงการเข้าชมที่มาจากหน้าเพลย์ลิสต์
  • PRODUCT_PAGE - มีการอ้างอิงยอดดูวิดีโอจากหน้าผลิตภัณฑ์
  • PROMOTED - ยอดดูวิดีโอมาจากการโปรโมต YouTube ที่ไม่มีค่าใช้จ่าย เช่น หน้า "วิดีโอสปอตไลท์" ของ YouTube
  • RELATED_VIDEO – มีการดูวิดีโอจากรายการวิดีโอที่เกี่ยวข้องในหน้าดูวิดีโออื่น หากคุณกรองตามแหล่งที่มาของการเข้าชมนี้ ฟิลด์ insightTrafficSourceDetail จะระบุรหัสวิดีโอสำหรับวิดีโอนั้น
  • SHORTS – ผู้ชมได้รับการอ้างอิงจากการปัดขึ้น-ลงจากวิดีโอก่อนหน้าในประสบการณ์การรับชม Shorts
  • SOUND_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 แบบในผลการค้นหาและในโฆษณา Display
    • TrueView ในสตรีม
    • การโฆษณาบน YouTube ที่ไม่จัดอยู่ในหมวดหมู่ใดๆ
    • แผงวิดีโอ
  • CAMPAIGN_CARD - วิดีโอที่มีการอ้างสิทธิ์ซึ่งนำผู้ชมไปยังวิดีโอที่ระบุในรายงาน
  • END_SCREEN - วิดีโอที่นำผู้ชมไปยังวิดีโอที่ระบุในรายงาน
  • EXT_URL - เว็บไซต์ที่แนะนำผู้ชมให้ดูวิดีโอ
  • HASHTAGS - แฮชแท็กที่ทำให้เกิดยอดดู
  • NOTIFICATION - อีเมลหรือการแจ้งเตือนที่อ้างอิงการเข้าชม
  • RELATED_VIDEO - วิดีโอที่เกี่ยวข้องซึ่งนำผู้ชมไปยังวิดีโอที่ครอบคลุมในรายงาน
  • SOUND_PAGE - วิดีโอที่ทำให้เกิดยอดดู
  • SUBSCRIBER - รายการฟีดบนหน้าแรกหรือฟีเจอร์การติดตามบน YouTube ที่นำผู้ชมไปยังวิดีโอที่ครอบคลุมในรายงาน ค่าที่ใช้ได้มีดังนี้
    • activity - จำนวนการดูจากรายการต่างๆ ในฟีดการติดตามหน้าแรกที่มาจากกิจกรรมช่องที่ไม่ใช่การอัปโหลดและไม่ใช่ทางสังคม ได้แก่ การชอบ การเพิ่มในรายการโปรด โพสต์กระดานข่าวสาร และการเพิ่มในเพลย์ลิสต์
    • blogged - ยอดดูจากรายการในฟีดการติดตามหน้าแรกซึ่งมาจากลิงก์จากบล็อกยอดนิยม
    • mychannel – ยอดดูจากรายการในฟีดอื่นๆ ที่แสดงในหน้าแรก เช่น "วิดีโอที่ชอบ" "ประวัติการดู" และ "ดูภายหลัง"
    • podcasts - ยอดดูที่มาจากรายการในหน้าปลายทางของพอดแคสต์
    • sdig - ยอดดูที่มาจากอีเมลอัปเดตการติดตาม
    • uploaded - ยอดดูจากรายการ uploaded ในฟีดการติดตามหน้าแรก
    • / - ยอดดูอื่นๆ ที่มาจากหน้าแรกของ YouTube
    • /my_subscriptions – ยอดดูที่มาจากหน้าการติดตามของฉันใน YouTube
  • YT_CHANNEL - หน้าช่องที่ผู้ชมดูวิดีโอ
  • YT_OTHER_PAGE - หน้า YouTube ที่ผู้ชมได้รับการอ้างอิงไปยังวิดีโอ
  • YT_SEARCH - ข้อความค้นหาที่นำผู้ชมไปยังวิดีโอ
  • VIDEO_REMIXES - วิดีโอที่ทำให้เกิดยอดดู

ตัวอย่าง

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

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

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

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

ตัวอย่าง

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

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

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

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

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

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

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

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

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

ตัวอย่าง

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

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

livestreamPosition
มิตินี้ระบุนาทีที่เฉพาะเจาะจงในระหว่างสตรีมวิดีโอสด เมตริกรายงาน จะระบุจำนวนผู้ใช้ที่ดูไลฟ์สดในขณะนั้น

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

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

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

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

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

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

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

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

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

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

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

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

  • reservedDisplay - โฆษณา Rich Media หรือโฆษณาแบบรูปภาพที่ปรากฏเป็นโฆษณาซ้อนทับที่ด้านล่างของวิดีโอเพลเยอร์ เป็นหน่วยโฆษณาขนาด 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 เพื่อกรองข้อมูล