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 (ตัวกรองเท่านั้น)
รหัสภูมิภาคทางสถิติของสหประชาชาติที่ระบุภูมิภาคย่อยทางภูมิศาสตร์ แผนกสถิติของสหประชาชาติจะแสดงรายชื่อภูมิภาคย่อยและประเทศที่เชื่อมโยงกับแต่ละภูมิภาค

มิติข้อมูลนี้สามารถใช้ในการกรองข้อมูลเท่านั้น หากต้องการใช้มิติข้อมูลนี้ ให้ตั้งค่าของพารามิเตอร์ 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
ข้อมูลในรายงานจะรวบรวมตามผู้อ้างอิงที่สร้างยอดดูมากที่สุดสำหรับวิดีโอที่ระบุและประเภทแหล่งที่มาของการเข้าชมที่ระบุ รายการต่อไปนี้ระบุแหล่งที่มาของการเข้าชมที่ใช้รายงานนี้ได้ สำหรับแหล่งที่มาของการเข้าชมแต่ละแหล่ง รายการจะระบุข้อมูลที่มิติข้อมูล 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 – ยอดดูที่มาจากรายการในหน้าปลายทางของ 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 CYWORLD
ดิกก์ DIGG
Dropbox DROPBOX
ฝัง EMBED
อีเมล MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
หน้า Facebook FACEBOOK_PAGES
ฟอตกา FOTKA
Gmail GMAIL
goo GOO
Google+ GOOGLEPLUS
ส่ง SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
SMS ของ 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
ราคุเท็น (楽天市場) 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 (ตัวกรองเท่านั้น)
ตัวกรองนี้บ่งบอกว่าคำขอกำลังดึงข้อมูลเกี่ยวกับการดูวิดีโอที่เกิดขึ้นในบริบทของเพลย์ลิสต์ ตัวกรองนี้จำเป็นสำหรับรายงานเพลย์ลิสต์ และต้องตั้งค่าตัวกรองเป็น 1

ตัวอย่าง

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

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

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

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

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

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

ตัวอย่าง

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