API ของ CrUX

CrUX API ให้สิทธิ์เวลาในการตอบสนองต่ำในการเข้าถึงข้อมูลประสบการณ์ของผู้ใช้จริงที่รวบรวมไว้ในรายละเอียดหน้าเว็บและต้นทาง

Use Case ทั่วไป

CrUX API ช่วยให้ค้นหาเมตริกประสบการณ์ของผู้ใช้สำหรับ URI ที่เจาะจงได้ เช่น "รับเมตริกสำหรับต้นทาง https://example.com"

คีย์ API CrUX

การใช้ CrUX API ต้องใช้คีย์ API ของ Google Cloud คุณสามารถสร้างข้อมูลเข้าสู่ระบบได้ในหน้าข้อมูลเข้าสู่ระบบ และจัดสรรไว้สำหรับการใช้งาน Chrome UX Report API

หลังจากมีคีย์ API แล้ว แอปพลิเคชันจะเพิ่มพารามิเตอร์การค้นหา key=[YOUR_API_KEY] ต่อท้าย URL คำขอทั้งหมดได้ ดูตัวอย่างคำค้นหา

คีย์ API ปลอดภัยสำหรับการฝังใน URL โดยไม่จำเป็นต้องมีการเข้ารหัสใดๆ

โมเดลข้อมูล

ส่วนนี้แสดงรายละเอียดโครงสร้างของข้อมูลในคำขอและคำตอบ

บันทึก

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

ตัวระบุ

ตัวระบุจะระบุระเบียนที่ควรค้นหา ใน CrUX ตัวระบุเหล่านี้คือหน้าเว็บและเว็บไซต์

Origin

เมื่อตัวระบุเป็นต้นทาง ข้อมูลทั้งหมดที่แสดงสำหรับทุกหน้าในต้นทางนั้นจะรวมเข้าด้วยกัน ตัวอย่างเช่น สมมติว่าต้นทาง http://www.example.com มีหน้าเว็บตามที่ Sitemap นี้จัดไว้

http://www.example.com/
http://www.example.com/foo.html
http://www.example.com/bar.html

ซึ่งหมายความว่าเมื่อค้นหารายงาน UX ของ Chrome โดยตั้งค่าต้นทางเป็น http://www.example.com ระบบจะแสดงผลข้อมูลสำหรับ http://www.example.com/, http://www.example.com/foo.html และ http://www.example.com/bar.html โดยนำมารวมกันเนื่องจากข้อมูลเหล่านั้นเป็นหน้าเว็บทั้งหมดภายใต้ต้นทางนั้น

URL

เมื่อตัวระบุเป็น URL ระบบจะแสดงเฉพาะข้อมูลของ URL ดังกล่าวเท่านั้น ดูที่ Sitemap ต้นทางของ http://www.example.com อีกครั้ง:

http://www.example.com/
http://www.example.com/foo.html
http://www.example.com/bar.html

หากตัวระบุตั้งค่าเป็น URL ด้วยค่า http://www.example.com/foo.html ระบบจะแสดงเฉพาะข้อมูลของหน้านั้นเท่านั้น

ขนาด

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

รูปแบบ

คลาสอุปกรณ์ที่ผู้ใช้ปลายทางใช้ไปยังหน้าเว็บ นี่คือคลาสทั่วไปของอุปกรณ์ที่แบ่งออกเป็น PHONE, TABLET และ DESKTOP

ประเภทการเชื่อมต่อที่มีผล

ประเภทการเชื่อมต่อที่มีประสิทธิภาพคือคุณภาพการเชื่อมต่อโดยประมาณของอุปกรณ์เมื่อไปยังหน้าดังกล่าว นี่คือคลาสทั่วไปที่แบ่งออกเป็น offline, slow-2G, 2G, 3G และ 4G

เมตริก

เรารายงานเมตริกเป็นผลรวมทางสถิติ ในฮิสโตแกรม เปอร์เซ็นไทล์ และเศษส่วน

ระบบจะปัดเศษค่าจุดทศนิยม 4 ตำแหน่ง (โปรดทราบว่าเมตริก cumulative_layout_shift มีการเข้ารหัส 2 เท่าเป็นสตริง จึงไม่ถือว่าเป็นเลขทศนิยม และจะรายงานเป็นทศนิยม 2 ตำแหน่งภายในสตริง)

ฮิสโตแกรม

เมื่อเมตริกแสดงในฮิสโตแกรม เราจะแสดงเปอร์เซ็นต์ของการโหลดหน้าเว็บที่อยู่ในช่วงที่เจาะจงสำหรับเมตริกนั้น

ฮิสโตแกรม Bin สามตัวอย่างสำหรับเมตริกตัวอย่างมีลักษณะดังนี้

{
  "histogram": [
    {
      "start": 0,
      "end": 1000,
      "density": 0.3818
    },
    {
      "start": 1000,
      "end": 3000,
      "density": 0.4991
    },
    {
      "start": 3000,
      "density": 0.1192
    }
  ]
}

ข้อมูลนี้ระบุว่าสำหรับการโหลดหน้าเว็บ 38.18% เมตริกตัวอย่างจะวัดระหว่าง 0 มิลลิวินาทีถึง 1,000 มิลลิวินาที หน่วยของเมตริกไม่ได้อยู่ในฮิสโตแกรมนี้ ในกรณีนี้เราจะสมมติว่าเป็นมิลลิวินาที

นอกจากนี้ 49.91% ของการโหลดหน้าเว็บพบค่าเมตริกระหว่าง 1,000 ถึง 3,000 มิลลิวินาที และ 11.92% มีค่ามากกว่า 3,000 มิลลิวินาที

เปอร์เซ็นไทล์

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

{
  "percentiles": {
    "p75": 2063
  }
}

ในตัวอย่างนี้ การโหลดหน้าเว็บอย่างน้อย 75% วัดด้วยค่าเมตริก <= 2063

เศษส่วน

เศษส่วนจะระบุเปอร์เซ็นต์ของการโหลดหน้าเว็บที่ติดป้ายกำกับในลักษณะใดรูปแบบหนึ่ง ในกรณีนี้ ค่าเมตริกคือป้ายกำกับเหล่านี้

ตัวอย่างเช่น เมตริก form_factors ประกอบด้วยออบเจ็กต์ fractions ที่แสดงรายละเอียดของรูปแบบของอุปกรณ์ (หรืออุปกรณ์) ที่คำค้นหานั้นๆ ครอบคลุม

"form_factors": {
  "fractions": {
    "desktop": 0.0377,
    "tablet": 0.0288,
    "phone": 0.9335
  }
}

ในกรณีนี้ การโหลดหน้าเว็บ 3.77% วัดบนเดสก์ท็อป 2.88% บนแท็บเล็ต และ 93.35% บนโทรศัพท์ โดยคิดเป็น 100%

ประเภทค่าเมตริก

ชื่อเมตริก CrUX API ประเภทข้อมูล หน่วยเมตริก การรวมข้อมูลทางสถิติ เอกสารประกอบ
cumulative_layout_shift ทศนิยม 2 ตำแหน่งมีการเข้ารหัส 2 ตำแหน่ง ไม่มีหน่วย ฮิสโตแกรมที่มี 3 bin เปอร์เซ็นไทล์ที่มี p75 cls
first_contentful_paint int มิลลิวินาที ฮิสโตแกรมที่มี 3 bin เปอร์เซ็นไทล์ที่มี p75 fcp
first_input_delay
(เลิกใช้งานแล้ว)		 int มิลลิวินาที ฮิสโตแกรมที่มี 3 bin เปอร์เซ็นไทล์ที่มี p75 Fid
interaction_to_next_paint int มิลลิวินาที ฮิสโตแกรมที่มี 3 bin เปอร์เซ็นไทล์ที่มี p75 inp
largest_contentful_paint int มิลลิวินาที ฮิสโตแกรมที่มี 3 bin เปอร์เซ็นไทล์ที่มี p75 lcp
experimental_time_to_first_byte int มิลลิวินาที ฮิสโตแกรมที่มี 3 bin เปอร์เซ็นไทล์ที่มี p75 ttfb
form_factors ทศนิยม 4 ตำแหน่ง percent การแมปจากรูปแบบของอุปกรณ์ไปยังเศษส่วน รูปแบบของอุปกรณ์
navigation_types ทศนิยม 4 ตำแหน่ง percent การแมปจากประเภทการนำทางไปยังเศษส่วน ประเภทการนำทาง

การแมปชื่อเมตริก BigQuery

ชื่อเมตริก CrUX API ชื่อเมตริก BigQuery
cumulative_layout_shift layout_instability.cumulative_layout_shift
first_contentful_paint first_contentful_paint
first_input_delay first_input.delay
interaction_to_next_paint interaction_to_next_paint
largest_contentful_paint largest_contentful_paint
experimental_time_to_first_byte experimental.time_to_first_byte
navigation_types navigation_types
form_factors ไม่มี

ระยะเวลาการเก็บรวบรวม

ตั้งแต่เดือนตุลาคม 2022 เป็นต้นไป CrUX API มีออบเจ็กต์ collectionPeriod ที่มีช่อง firstDate และ endDate ซึ่งแสดงวันที่เริ่มต้นและวันที่สิ้นสุดของกรอบเวลาการรวม เช่น

    "collectionPeriod": {
      "firstDate": {
        "year": 2022,
        "month": 9,
        "day": 12
      },
      "lastDate": {
        "year": 2022,
        "month": 10,
        "day": 9
      }
    }

ซึ่งจะช่วยให้เข้าใจข้อมูลได้ดีขึ้น และดูว่าข้อมูลได้รับการอัปเดตสำหรับวันนั้นแล้วหรือมีการส่งคืนข้อมูลเดียวกันกับของเมื่อวานหรือไม่

โปรดทราบว่า CrUX API จะล่าช้ากว่าวันนี้ประมาณ 2 วัน เนื่องจากต้องรอข้อมูลที่เสร็จสมบูรณ์สำหรับวันนั้น และต้องใช้เวลาในการประมวลผลก่อนจึงจะพร้อมใช้งานใน API เขตเวลาที่ใช้คือเวลามาตรฐานแปซิฟิก (PST) ที่ไม่มีการเปลี่ยนแปลงสำหรับเวลาออมแสง

ตัวอย่างคำค้นหา

ระบบจะส่งคำค้นหาเป็นออบเจ็กต์ JSON โดยใช้คำขอ POST ไปยัง https://chromeuxreport.googleapis.com/v1/records:queryRecord?key=[YOUR_API_KEY]" ที่มีข้อมูลการค้นหาเป็นออบเจ็กต์ JSON ในเนื้อหา POST ดังนี้

{
  "origin": "https://example.com",
  "formFactor": "PHONE",
  "metrics": [
    "largest_contentful_paint",
    "experimental_time_to_first_byte"
  ]
}

เช่น อาจมีการเรียกจาก curl ด้วยบรรทัดคำสั่งต่อไปนี้ (แทนที่ API_KEY ด้วยคีย์ของคุณ)

curl -s --request POST 'https://chromeuxreport.googleapis.com/v1/records:queryRecord?key=API_KEY' \
    --header 'Accept: application/json' \
    --header 'Content-Type: application/json' \
    --data '{"formFactor":"PHONE","origin":"https://www.example.com","metrics":["largest_contentful_paint", "experimental_time_to_first_byte"]}'

ข้อมูลระดับหน้าเว็บจะพร้อมให้ใช้งานผ่าน API โดยการส่งพร็อพเพอร์ตี้ url ในการค้นหา แทนที่จะเป็น origin ดังนี้

{
  "url": "https://example.com/page",
  "formFactor": "PHONE",
  "metrics": [
    "largest_contentful_paint",
    "experimental_time_to_first_byte"
  ]
}

หากไม่ได้ตั้งค่าพร็อพเพอร์ตี้ metrics ไว้ ระบบจะแสดงผลเมตริกที่ใช้ได้ทั้งหมด

  • cumulative_layout_shift
  • first_contentful_paint
  • first_input_delay (เลิกใช้งานแล้ว)
  • interaction_to_next_paint
  • largest_contentful_paint
  • experimental_time_to_first_byte
  • navigation_types
  • form_factors (รายงานเมื่อไม่ได้ระบุ formFactor ในคำขอเท่านั้น)

หากไม่ได้ระบุค่า formFactor ระบบจะรวบรวมค่าตามรูปแบบของอุปกรณ์ทั้งหมด

ดูตัวอย่างการค้นหาเพิ่มเติมได้ที่การใช้ Chrome UX Report API

Data Pipeline

ชุดข้อมูล CrUX จะได้รับการประมวลผลผ่านไปป์ไลน์เพื่อรวม รวบรวม และกรองข้อมูลก่อนที่จะพร้อมใช้งานโดยใช้ API

รายได้เฉลี่ยต่อเนื่อง

ข้อมูลในรายงาน UX ของ Chrome คือเมตริกรวมเฉลี่ยต่อเนื่อง 28 วัน ซึ่งหมายความว่าข้อมูลที่แสดงในรายงาน UX ของ Chrome ในช่วงเวลาหนึ่งๆ คือข้อมูลของช่วง 28 วันที่ผ่านมาซึ่งรวมไว้ด้วยกัน

ซึ่งคล้ายกับวิธีที่ชุดข้อมูล CrUX ใน BigQuery รวบรวมรายงานรายเดือน

ข้อมูลอัปเดตรายวัน

ข้อมูลจะอัปเดตทุกวันในเวลาประมาณ 04:00 น. UTC ไม่มีข้อตกลงระดับการให้บริการสำหรับเวลาการอัปเดต และจะดำเนินการอย่างดีที่สุดทุกวัน

สคีมา

CrUX API มีปลายทางเดียวซึ่งยอมรับคำขอ HTTP ของ POST API จะแสดงผล record ซึ่งมี metrics อย่างน้อย 1 รายการที่สอดคล้องกับข้อมูลประสิทธิภาพเกี่ยวกับต้นทางหรือหน้าเว็บที่ขอ

คำขอ HTTP

POST https://chromeuxreport.googleapis.com/v1/records:queryRecord

URL ใช้ไวยากรณ์การแปลง gRPC

เนื้อหาของคำขอ

เนื้อหาของคำขอควรมีข้อมูลที่มีโครงสร้างต่อไปนี้

{
  "effectiveConnectionType": string,
  "formFactor": enum (FormFactor),
  "metrics": [
    string
  ],

  // Union field url_pattern can be only one of the following:
  "origin": string,
  "url": string
  // End of list of possible types for union field url_pattern.
}
ช่อง
effectiveConnectionType

string

ประเภทการเชื่อมต่อที่มีประสิทธิภาพคือมิติข้อมูลการค้นหาที่ระบุคลาสเครือข่ายที่มีประสิทธิภาพซึ่งข้อมูลของระเบียนควรอยู่

ช่องนี้ใช้ค่า ["offline", "slow-2G", "2G", "3G", "4G"] ตามที่ระบุไว้ในข้อกำหนดของ Network Information API

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

enum (FormFactor)

รูปแบบของอุปกรณ์คือมิติข้อมูลการค้นหาที่ระบุคลาสอุปกรณ์ที่ควรอยู่ในข้อมูลของระเบียน

ช่องนี้ใช้ค่า DESKTOP, PHONE หรือ TABLET

หมายเหตุ: หากไม่ได้ระบุรูปแบบของอุปกรณ์ ระบบจะส่งระเบียนพิเศษที่มีข้อมูลรวมจากอุปกรณ์รูปแบบทั้งหมดกลับมา
metrics[]

string

เมตริกที่ควรรวมอยู่ในคำตอบ หากไม่ระบุ ระบบจะแสดงผลเมตริกที่พบ

ค่าที่อนุญาต: ["cumulative_layout_shift", "first_contentful_paint", "first_input_delay", "interaction_to_next_paint", "largest_contentful_paint", "experimental_time_to_first_byte"]
ฟิลด์สหภาพ url_pattern url_pattern เป็นตัวระบุหลักสำหรับการค้นหาระเบียน ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
origin

string

"ต้นทาง" url_pattern หมายถึงรูปแบบ URL ที่เป็นต้นทางของเว็บไซต์

เช่น "https://example.com", "https://cloud.google.com"
url

string

url_pattern url หมายถึงรูปแบบ URL ที่เป็น URL ใดก็ได้ตามต้องการ

เช่น "https://example.com/, https://cloud.google.com/why-google-cloud/"

เช่น หากต้องการขอค่า Contentful Paint ในเดสก์ท็อปสูงสุดสำหรับหน้าแรกของเอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์ Chrome ให้ทำดังนี้

{
  "url": "https://developer.chrome.com/docs/",
  "formFactor": "DESKTOP",
  "metrics": [
    "largest_contentful_paint"
  ]
}

เนื้อหาการตอบกลับ

คำขอที่สำเร็จจะแสดงการตอบกลับด้วยออบเจ็กต์ record และ urlNormalizationDetails ในโครงสร้างต่อไปนี้

{
  "record": {
    "key": {
      object (Key)
    },
    "metrics": [
      string: {
        object (Metric)
      }
    ]
  },
  "urlNormalizationDetails": {
    object (UrlNormalization)
  }
}

ตัวอย่างเช่น การตอบกลับเนื้อหาของคำขอในคำขอก่อนหน้าอาจเป็นดังนี้

{
  "record": {
    "key": {
      "formFactor": "DESKTOP",
      "url": "https://developer.chrome.com/docs/"
    },
    "metrics": {
      "largest_contentful_paint": {
        "histogram": [
          {
            "start": 0,
            "end": 2500,
            "density": 0.9815
          },
          {
            "start": 2500,
            "end": 4000,
            "density": 0.0108
          },
          {
            "start": 4000,
            "density": 0.0077
          }
        ],
        "percentiles": {
          "p75": 651
        }
      }
    },
    "collectionPeriod": {
      "firstDate": {
        "year": 2022,
        "month": 9,
        "day": 12
      },
      "lastDate": {
        "year": 2022,
        "month": 10,
        "day": 9
      }
    }
  }
}

คีย์

Key กำหนดมิติข้อมูลทั้งหมดที่ระบุว่าระเบียนนี้ไม่ซ้ำกัน

{
  "effectiveConnectionType": string,
  "formFactor": enum (FormFactor),

  // Union field url_pattern can be only one of the following:
  "origin": string,
  "url": string
  // End of list of possible types for union field url_pattern.
}
ช่อง
formFactor

enum (FormFactor)

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

หากไม่ได้ระบุรูปแบบของอุปกรณ์ ระบบจะส่งคืนค่าข้อมูลรวมจากอุปกรณ์รูปแบบทั้งหมด
effectiveConnectionType

string

ประเภทการเชื่อมต่อที่มีประสิทธิภาพคือคลาสการเชื่อมต่อทั่วไปที่ผู้ใช้ทั้งหมดพบสำหรับระเบียนนี้ ช่องนี้ใช้ค่า ["offline", "slow-2G", "2G", "3G", "4G"] ตามที่ระบุไว้ใน https://wicg.github.io/netinfo/#effective-connection-types

หากไม่ได้ระบุประเภทการเชื่อมต่อที่มีประสิทธิภาพ ระบบจะส่งคืนค่าข้อมูลแบบรวมผ่านประเภทการเชื่อมต่อที่มีประสิทธิภาพทั้งหมด
ฟิลด์สหภาพ url_pattern รูปแบบ URL คือ URL ที่ใช้ระเบียนดังกล่าว url_pattern ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
origin

string

origin จะระบุต้นทางสำหรับระเบียนนี้

หมายเหตุ: เมื่อระบุ origin ระบบจะรวบรวมข้อมูลสำหรับการโหลดภายใต้ต้นทางนี้สำหรับทุกหน้าไว้ในข้อมูลประสบการณ์ของผู้ใช้ระดับต้นทาง
url

string

url ระบุ URL ที่เจาะจงสำหรับระเบียนนี้

หมายเหตุ: เมื่อระบุ url ระบบจะรวมเฉพาะข้อมูลของ URL ที่ระบุเท่านั้น

เมตริก

metric คือชุดข้อมูลประสบการณ์ของผู้ใช้แบบรวมสำหรับเมตริกประสิทธิภาพของเว็บรายการเดียว เช่น First Contentful Paint ซึ่งอาจมีฮิสโตแกรมสรุปการใช้งาน Chrome ในชีวิตจริงเป็นชุด bins ข้อมูลเปอร์เซ็นไทล์ที่เฉพาะเจาะจง (เช่น p75) หรืออาจมีเศษส่วนที่ติดป้ายกำกับ

{
  "histogram": [
    {
      object (Bin)
    }
  ],
  "percentiles": {
    object (Percentiles)
  }
}

หรือ

{
  "fractions": {
    object (Fractions)
  }
}
ช่อง
histogram[]

object (Bin)

ฮิสโตแกรมประสบการณ์ของผู้ใช้สำหรับเมตริก ฮิสโตแกรมจะมี Bin อย่างน้อย 1 ถัง และความหนาแน่นของ Bin ทั้งหมดจะรวมกันได้ประมาณ 1
percentiles

object (Percentiles)

เปอร์เซ็นไทล์ที่มีประโยชน์โดยทั่วไปของเมตริก ประเภทค่าสำหรับเปอร์เซ็นไทล์จะเหมือนกับประเภทค่าที่ระบุสำหรับถังฮิสโตแกรม
fractions

object (Fractions)

วัตถุนี้มีเศษส่วนที่ติดป้ายกำกับ ซึ่งรวมกันแล้วได้ประมาณ 1

ระบบจะปัดเศษเศษส่วนเป็นทศนิยม 4 ตำแหน่ง

Bin

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

ค่าเริ่มต้นและวันที่สิ้นสุดของ Bin จะระบุไว้ในประเภทค่าของเมตริกที่แสดง เช่น First Contentful Paint วัดเป็นหน่วยมิลลิวินาทีและแสดงในรูปแบบ int ดังนั้นถังเมตริกจะใช้ int32s สำหรับประเภทการเริ่มต้นและสิ้นสุด อย่างไรก็ตาม การเปลี่ยนแปลงเลย์เอาต์แบบสะสมจะวัดเป็นทศนิยมที่ไม่มีหน่วย และแสดงเป็นทศนิยมที่เข้ารหัสเป็นสตริง ถังเมตริกจะใช้สตริงสำหรับประเภทค่า

{
  "start": value,
  "end": value,
  "density": number
}
ช่อง
start

(integer | string)

Start คือจุดเริ่มต้นของถังขยะข้อมูล
end

(integer | string)

End คือจุดสิ้นสุดของถังขยะข้อมูล หากไม่มีการเติมค่าปลายทาง bin จะไม่มีจุดสิ้นสุดและมีผลใช้ได้ตั้งแต่เริ่มต้นถึง +inf
density

number

สัดส่วนของผู้ใช้ที่พบค่า Bin นี้สำหรับเมตริกที่ระบุ

ความหนาแน่นจะปัดเศษเป็นทศนิยม 4 ตำแหน่ง

เปอร์เซ็นไทล์

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

{
  "P75": value
}
ช่อง
p75

(integer | string)

75% ของการโหลดหน้าเว็บพบเมตริกที่ระบุเท่ากับหรือน้อยกว่าค่านี้

เศษส่วน

Fractions มีเศษส่วนที่ติดป้ายกำกับซึ่งรวมกันแล้วไม่เกิน 1 โดยประมาณ ป้ายกำกับแต่ละป้ายจะอธิบายถึงการโหลดหน้าเว็บในลักษณะใดลักษณะหนึ่ง ดังนั้นจึงอาจมองว่าเมตริกที่แสดงในลักษณะนี้เป็นการสร้างค่าที่แตกต่างกันแทนค่าตัวเลข และเศษส่วนจะแสดงความถี่ในการวัดค่าที่ไม่ซ้ำกันหนึ่งๆ

{
  "label_1": fraction,
  "label_2": fraction,
  ...
  "label_n": fraction
}

fraction แต่ละค่าเป็นจำนวน 0.0 <= value <= 1.0 และมีค่ารวมกันแล้วไม่เกิน 1.0 ซึ่งคล้ายกับค่าความหนาแน่นในถังฮิสโตแกรม

UrlNormalization

ออบเจ็กต์ที่เป็นตัวแทนการดำเนินการปรับให้เป็นมาตรฐานซึ่งทำเพื่อกำหนดให้ URL เป็นมาตรฐานเพื่อเพิ่มโอกาสในการค้นหาสำเร็จ นี่คือการเปลี่ยนแปลงอัตโนมัติง่ายๆ ที่เกิดขึ้นเมื่อค้นหา url_pattern ที่ระบุอาจล้มเหลว แต่จะไม่จัดการการดำเนินการที่ซับซ้อน เช่น การเปลี่ยนเส้นทางต่อไปนี้

{
  "originalUrl": string,
  "normalizedUrl": string
}
ช่อง
originalUrl

string

URL เดิมที่ขอไปก่อนการดำเนินการปรับให้เป็นมาตรฐาน
normalizedUrl

string

URL หลังจากการดำเนินการปรับให้เป็นมาตรฐาน URL นี้เป็น URL สำหรับประสบการณ์ของผู้ใช้ที่ถูกต้องซึ่งสามารถค้นหาได้มากพอ

ขีดจำกัดอัตรา

CrUX API จำกัดการค้นหาอยู่ที่ 150 รายการต่อนาทีต่อโปรเจ็กต์ Google Cloud ซึ่งไม่มีค่าใช้จ่าย ดูขีดจำกัดนี้และการใช้งานปัจจุบันได้ใน Google Cloud Console โควต้าขนาดใหญ่นี้น่าจะเพียงพอสำหรับกรณีการใช้งานส่วนใหญ่ และไม่สามารถจ่ายเงินสำหรับโควต้าที่เพิ่มขึ้นได้