تتيح واجهة CrUX API الوصول بزمن انتقال منخفض إلى بيانات تجربة المستخدمين الفعليين المجمّعة على مستوى الصفحة والمصدر.
حالة الاستخدام الشائعة
تتيح واجهة برمجة التطبيقات CrUX API إمكانية طلب مقاييس تجربة المستخدم لعنوان URI محدّد، مثل "الحصول على مقاييس المصدر https://example.com".
مفتاح واجهة برمجة تطبيقات CrUX
يتطلّب استخدام CrUX API توفّر مفتاح Google Cloud API مخصّص للاستخدام في Chrome UX Report API.
الحصول على مفتاح واجهة برمجة التطبيقات واستخدامه
الحصول على مفتاحأو يمكنك إنشاء مفتاح في صفحة "بيانات الاعتماد".
بعد الحصول على مفتاح واجهة برمجة التطبيقات، يمكن لتطبيقك إلحاق مَعلمة طلب البحث key=yourAPIKey بجميع عناوين URL للطلبات.
يمكن تضمين مفتاح واجهة برمجة التطبيقات بأمان في عناوين URL، ولا يتطلّب أي ترميز.
راجِع أمثلة على طلبات البحث.
نموذج البيانات
يوضّح هذا القسم بنية البيانات في الطلبات والردود.
تسجيل
يشير هذا المصطلح إلى معلومة منفصلة عن صفحة أو موقع إلكتروني. يمكن أن يحتوي السجلّ على بيانات خاصة بمعرّف ومجموعة معيّنة من السمات. يمكن أن يحتوي السجلّ على بيانات لمقياس واحد أو أكثر.
المعرّفات
تحدّد المعرّفات السجلّات التي يجب البحث عنها. في تقرير CrUX، تكون هذه المعرّفات عبارة عن صفحات ومواقع إلكترونية.
الأصل
عندما يكون المعرّف مصدرًا، يتم تجميع كل البيانات المتوفّرة لجميع الصفحات في هذا المصدر معًا. على سبيل المثال، لنفترض أنّ المصدر http://www.example.com يتضمّن صفحات كما هو موضّح في خريطة الموقع هذه:
http://www.example.com/
http://www.example.com/foo.html
http://www.example.com/bar.html
يعني ذلك أنّه عند طلب البحث في "تقرير تجربة المستخدم على Chrome" مع ضبط المصدر على http://www.example.com، سيتم عرض البيانات الخاصة بـ http://www.example.com/ وhttp://www.example.com/foo.html وhttp://www.example.com/bar.html مجمّعة معًا، لأنّ هذه الصفحات تندرج كلها ضمن هذا المصدر.
عناوين URL
عندما يكون المعرّف عنوان URL، سيتم عرض البيانات الخاصة بعنوان URL هذا فقط. لنلقِ نظرة أخرى على خريطة الموقع المصدر 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.
المقياس
نقدّم مقاييس التتبُّع كتجميعات إحصائية في المدرّجات التكرارية والنسب المئوية والكسور.
يتم تقريب قيم النقاط العائمة إلى 4 منازل عشرية (يُرجى العِلم أنّ مقاييس cumulative_layout_shift هي قيم مزدوجة تم ترميزها كسلسلة، لذا لا تُعتبر قيمًا عائمة ويتم تسجيلها إلى منزلتَين عشريتَين داخل السلسلة).
التردد الرسومي
عند التعبير عن المقاييس في مدرّج تكراري، نعرض النسب المئوية لعمليات تحميل الصفحات التي تندرج ضمن نطاقات معيّنة لهذا المقياس.
يبدو المدرّج التكراري المكوّن من ثلاث مجموعات لمقياس معيّن على النحو التالي:
{
"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 |
قيمة مزدوجة بخانتَين عشريتَين مرمّزة كسلسلة | بدون وحدة | مدرّج تكراري بثلاثة أقسام، وشرائح مئوية مع p75 | CLS |
interaction_to_next_paint |
int | مللي ثانية | مدرّج تكراري بثلاثة أقسام، وشرائح مئوية مع p75 | INP |
largest_contentful_paint |
int | مللي ثانية | مدرّج تكراري بثلاثة أقسام، وشرائح مئوية مع p75 | LCP |
experimental_cumulative_layout_shift_with_softnavs |
قيمة مزدوجة بخانتَين عشريتَين مرمّزة كسلسلة | بدون وحدة | مدرّج تكراري بثلاثة أقسام، وشرائح مئوية مع p75 | مدوّنة |
experimental_interaction_to_next_paint_with_softnavs |
int | مللي ثانية | مدرّج تكراري بثلاثة أقسام، وشرائح مئوية مع p75 | مدوّنة |
experimental_largest_contentful_paint_with_softnavs |
int | مللي ثانية | مدرّج تكراري بثلاثة أقسام، وشرائح مئوية مع p75 | مدوّنة |
first_contentful_paint |
int | مللي ثانية | مدرّج تكراري بثلاثة أقسام، وشرائح مئوية مع p75 | FCP |
experimental_first_contentful_paint_with_softnavs |
int | مللي ثانية | مدرّج تكراري بثلاثة أقسام، وشرائح مئوية مع p75 | مدوّنة |
experimental_time_to_first_byte |
int | مللي ثانية | مدرّج تكراري بثلاثة أقسام، وشرائح مئوية مع p75 | TTFB |
form_factors |
رقم مزدوج من 4 منازل عشرية | نسبة مئوية | الربط من شكل الجهاز إلى الكسر | أشكال الأجهزة |
navigation_types |
رقم مزدوج من 4 منازل عشرية | نسبة مئوية | الربط من نوع التنقّل إلى الكسر | أنواع التنقّل |
experimental_navigation_types_with_softnavs |
رقم مزدوج من 4 منازل عشرية | نسبة مئوية | الربط من نوع التنقّل إلى الكسر | مدوّنة |
round_trip_time |
int | مللي ثانية | مدرّج تكراري بثلاثة أقسام، وشرائح مئوية مع p75 | مقياس RTT |
largest_contentful_paint_resource_type |
رقم مزدوج من 4 منازل عشرية | نسبة مئوية | الربط من نوع التنقّل إلى الكسر | أنواع موارد LCP |
largest_contentful_paint_image_time_to_first_byte |
int | مللي ثانية | الشرائح المئوية مع الشريحة المئوية الـ 75 | الأجزاء الفرعية لمقياس LCP |
largest_contentful_paint_image_resource_load_delay |
int | مللي ثانية | الشرائح المئوية مع الشريحة المئوية الـ 75 | الأجزاء الفرعية لمقياس LCP |
largest_contentful_paint_image_resource_load_duration |
int | مللي ثانية | الشرائح المئوية مع الشريحة المئوية الـ 75 | الأجزاء الفرعية لمقياس LCP |
largest_contentful_paint_image_element_render_delay |
int | مللي ثانية | الشرائح المئوية مع الشريحة المئوية الـ 75 | الأجزاء الفرعية لمقياس LCP |
experimental_ad_count |
رقم مزدوج من منزلتَين عشريتَين | بدون وحدة | الشريحة المئوية الـ 75 فقط | عدد الإعلانات |
experimental_ad_density |
رقم مزدوج من منزلتَين عشريتَين | بدون وحدة | الشريحة المئوية الـ 75 فقط | كثافة الإعلانات |
experimental_ad_cpu |
int | مللي ثانية | الشريحة المئوية الـ 75 فقط | وزن الإعلان: وحدة المعالجة المركزية |
experimental_ad_kilobytes |
int | كيلوبايت | الشريحة المئوية الـ 75 فقط | وزن الإعلان: الشبكة |
ربط أسماء مقاييس BigQuery
| اسم مقياس CrUX API | اسم مقياس BigQuery |
|---|---|
cumulative_layout_shift |
layout_instability.cumulative_layout_shift |
first_contentful_paint |
first_contentful_paint |
interaction_to_next_paint |
interaction_to_next_paint |
largest_contentful_paint |
largest_contentful_paint |
experimental_time_to_first_byte |
experimental.time_to_first_byte |
experimental_cumulative_layout_shift_with_softnavs |
experimental.cumulative_layout_shift_with_softnavs |
experimental_first_contentful_paint_with_softnavs |
n/a |
experimental_interaction_to_next_paint_with_softnavs |
experimental.interaction_to_next_paint_with_softnavs |
experimental_largest_contentful_paint_with_softnavs |
experimental.largest_contentful_paint_with_softnavs |
navigation_types |
navigation_types |
experimental_navigation_types_with_softnavs |
n/a |
form_factors |
timing fixed in amara |
round_trip_time |
round_trip_time |
largest_contentful_paint_resource_type |
لا تنطبق |
largest_contentful_paint_image_time_to_first_byte |
لا تنطبق |
largest_contentful_paint_image_resource_load_delay |
لا تنطبق |
largest_contentful_paint_image_resource_load_duration |
لا تنطبق |
largest_contentful_paint_image_element_render_delay |
timing fixed in amara |
experimental_ad_count |
n/a |
experimental_ad_density |
n/a |
experimental_ad_cpu |
n/a |
experimental_ad_kilobytes |
n/a |
فترة جمع البيانات
اعتبارًا من أكتوبر 2022، أصبحت واجهة برمجة التطبيقات CrUX API تحتوي على عنصر collectionPeriod مع حقلَي firstDate وendDate اللذين يمثّلان تاريخَي البدء والانتهاء لفترة تجميع البيانات. على سبيل المثال:
"collectionPeriod": {
"firstDate": {
"year": 2022,
"month": 9,
"day": 12
},
"lastDate": {
"year": 2022,
"month": 10,
"day": 9
}
}
يتيح ذلك فهم البيانات بشكل أفضل ومعرفة ما إذا تم تعديلها لهذا اليوم أو ما إذا كانت تعرض البيانات نفسها التي تم عرضها بالأمس.
تتوفّر فترة الجمع أيضًا في "إحصاءات PageSpeed":
بالإضافة إلى ذلك، سيعرض collectionPeriod دائمًا بيانات آخر 28 يومًا، حتى إذا لم تكن البيانات تغطي هذه الفترة بالكامل (على سبيل المثال، إذا تم إطلاق صفحة قبل أقل من 28 يومًا). collectionPeriod هي الفترة الزمنية التي تم تجميع بيانات CrUX خلالها، وليس بالضرورة الفترة الزمنية التي تمثّلها البيانات.
أمثلة على طلبات البحث
يتم إرسال طلبات البحث كعناصر 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"]}'
تتوفّر البيانات على مستوى الصفحة من خلال واجهة برمجة التطبيقات عن طريق ضبط السمة url في طلب البحث بدلاً من origin:
{
"url": "https://example.com/page",
"formFactor": "PHONE",
"metrics": [
"largest_contentful_paint",
"experimental_time_to_first_byte"
]
}
إذا لم يتم ضبط السمة metrics، سيتم عرض جميع المقاييس المتاحة:
cumulative_layout_shiftfirst_contentful_paintinteraction_to_next_paintlargest_contentful_paintexperimental_cumulative_layout_shift_with_softnavsexperimental_first_contentful_paint_with_softnavsexperimental_interaction_to_next_paint_with_softnavsexperimental_largest_contentful_paint_with_softnavsexperimental_navigation_types_with_softnavsexperimental_time_to_first_bytelargest_contentful_paint_resource_typelargest_contentful_paint_image_time_to_first_bytelargest_contentful_paint_image_resource_load_delaylargest_contentful_paint_image_resource_load_durationlargest_contentful_paint_image_element_render_delaynavigation_typesround_trip_time-
form_factors(يتم الإبلاغ عنها فقط في حال عدم تحديدformFactorفي الطلب) -
experimental_ad_count(يتم الإبلاغ عنها فقط للصفحات المضمّنة في مقاييس الإعلانات) -
experimental_ad_density(يتم الإبلاغ عنها فقط للصفحات المضمّنة في مقاييس الإعلانات) -
experimental_ad_cpu(يتم الإبلاغ عنها فقط للصفحات المضمّنة في مقاييس الإعلانات) -
experimental_ad_kilobytes(يتم الإبلاغ عنها فقط للصفحات المضمّنة في مقاييس الإعلانات)
إذا لم يتم تقديم قيمة formFactor، سيتم تجميع القيم على مستوى جميع أشكال الأجهزة.
يمكنك الاطّلاع على استخدام تقرير تجربة المستخدم على Chrome API لمزيد من الأمثلة على طلبات البحث.
مسار البيانات
تتم معالجة مجموعة بيانات CrUX من خلال مسار لدمج البيانات وتجميعها وفلترتها قبل أن تصبح متاحة باستخدام واجهة برمجة التطبيقات.
المتوسط المتحرك
البيانات في "تقرير تجربة المستخدم على Chrome" هي متوسط متحرّك للمقاييس المجمّعة على مدار 28 يومًا. وهذا يعني أنّ البيانات المعروضة في "تقرير تجربة المستخدم على Chrome" في أي وقت هي في الواقع بيانات مجمّعة لآخر 28 يومًا.
ويشبه ذلك الطريقة التي تجمع بها مجموعة بيانات CrUX على BigQuery التقارير الشهرية.
تعديلات يومية
يتم تعديل البيانات يوميًا في الساعة 04:00 صباحًا تقريبًا بالتوقيت العالمي المتفق عليه (UTC). لا تتوفّر اتفاقية مستوى خدمة لأوقات التعديل، ويتم تنفيذها على أساس بذل أفضل جهد كل يوم.
المخطط
تتوفّر نقطة نهاية واحدة لواجهة CrUX API تقبل طلبات HTTP من النوع POST. تعرض واجهة برمجة التطبيقات record يحتوي على metrics واحد أو أكثر يتوافق مع بيانات الأداء حول المصدر أو الصفحة المطلوبة.
طلب HTTP
POST https://chromeuxreport.googleapis.com/v1/records:queryRecord
يستخدِم عنوان URL بنية تحويل الترميز إلى gRPC.
نص الطلب
يجب أن يتضمن نص الطلب بيانات بالبنية التالية:
{
"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.
}
| الحقول | |
|---|---|
formFactor |
نوع الجهاز هو سمة طلب بحث تحدّد فئة الجهاز التي يجب أن تنتمي إليها بيانات السجلّ. يستخدم هذا الحقل القيم ملاحظة: في حال عدم تحديد شكل الجهاز، سيتم عرض سجلّ خاص يتضمّن بيانات مجمّعة لجميع أشكال الأجهزة. |
metrics[] |
المقاييس التي يجب تضمينها في الردّ وفي حال عدم تحديد أي منها، سيتم عرض أي مقاييس يتم العثور عليها. القيم المسموح بها: |
حقل الربط url_ يُعدّ url_pattern المعرّف الرئيسي للبحث عن السجلّ. يمكن أن يكون إحدى القيم التالية فقط: |
|
origin |
يشير "المصدر" أمثلة: |
url |
يشير أمثلة: |
على سبيل المثال، لطلب قيم سرعة عرض أكبر محتوى مرئي على أجهزة الكمبيوتر للصفحة الرئيسية لمستندات مطوّري 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 جميع السمات التي تجعل هذا السجلّ فريدًا.
{
"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 |
عامل الشكل هو فئة الجهاز التي استخدمها جميع المستخدمين للوصول إلى الموقع الإلكتروني لهذا السجلّ. إذا لم يتم تحديد شكل الجهاز، سيتم عرض البيانات المجمّعة على مستوى جميع أشكال الأجهزة. |
حقل الربط url_ نمط عنوان URL هو عنوان URL الذي ينطبق عليه السجلّ. يمكن أن يكون التعليق url_ إحدى القيم التالية فقط: |
|
origin |
يحدّد ملاحظة: عند تحديد |
url |
تحدّد السمة ملاحظة: عند تحديد |
المقاييس
metric هو مجموعة من بيانات تجربة المستخدم المجمّعة لمقياس أداء ويب واحد، مثل سرعة عرض أول محتوى مرئي.
وقد يحتوي على مدرّج تكراري يلخّص استخدام Chrome في الواقع كسلسلة من bins، أو بيانات مئوية محدّدة (مثل p75)، أو قد يحتوي على كسور مصنّفة.
{
"histogram": [
{
object (Bin)
}
],
"percentiles": {
object (Percentiles)
}
}
أو
{
"fractions": {
object (Fractions)
}
}
| الحقول | |
|---|---|
histogram[] |
المدرّج التكراري لتجارب المستخدمين لمقياس معيّن سيحتوي المدرّج التكراري على مجموعة واحدة على الأقل، وسيصل مجموع كثافة جميع المجموعات إلى 1 تقريبًا. |
percentiles |
النسب المئوية المفيدة الشائعة للمقياس سيكون نوع القيمة للنسب المئوية هو نفسه أنواع القيم المحدّدة لأقسام المدرّج التكراري. |
fractions |
يحتوي هذا الكائن على كسور مصنّفة، ويبلغ مجموعها حوالي 1. يتم تقريب الكسور إلى 4 منازل عشرية. |
المربع
bin هو جزء منفصل من البيانات يمتد من البداية إلى النهاية، أو من البداية إلى ما لا نهاية إذا لم يتم تحديد نهاية.
يتم تحديد قيمتَي البداية والنهاية لكل مجموعة حسب نوع قيمة المقياس الذي تمثّله. على سبيل المثال، يتم قياس سرعة عرض أول محتوى مرئي بالمللي ثانية ويتم عرضها كأعداد صحيحة، وبالتالي ستستخدم مجموعات المقاييس int32s لأنواع البداية والنهاية. ومع ذلك، يتم قياس متغيّرات التصميم التراكمية بأرقام عشرية بدون وحدات ويتم عرضها كأرقام عشرية مرمّزة كسلسلة، وبالتالي ستستخدم مجموعات المقاييس سلاسل لنوع القيمة.
{
"start": value,
"end": value,
"density": number
}
| الحقول | |
|---|---|
start |
"البداية" هي بداية حاوية البيانات. |
end |
تمثّل النهاية نهاية حاوية البيانات. إذا لم يتم ملء حقل النهاية، لن يكون للفئة نهاية وستكون صالحة من البداية إلى +inf. |
density |
نسبة المستخدمين الذين واجهوا قيمة هذه الفئة للمقياس المحدّد يتم تقريب الكثافات إلى 4 منازل عشرية. |
الشرائح المئوية
يحتوي Percentiles على قيم اصطناعية لمقياس معيّن عند نسبة مئوية إحصائية معيّنة. تُستخدَم هذه القيم لتقدير قيمة مقياس معيّن وفقًا لتجربة نسبة مئوية من المستخدمين من إجمالي عدد المستخدمين.
{
"P75": value
}
| الحقول | |
|---|---|
p75 |
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 |
عنوان URL الأصلي المطلوب قبل أي إجراءات تسوية |
normalizedUrl |
عنوان URL بعد أي إجراءات تسوية هذا عنوان URL صالح لتجربة المستخدم ويمكن البحث عنه بشكل معقول. |
الحدود القصوى لمعدّل الاستخدام
يقتصر استخدام CrUX API على 150 طلب بحث في الدقيقة لكل مشروع على Google Cloud، ويتم تقديمها بدون أي رسوم. يمكن الاطّلاع على هذا الحدّ واستخدامك الحالي في Google Cloud Console. من المفترض أن تكون هذه الحصة الكبيرة كافية للغالبية العظمى من حالات الاستخدام، ولا يمكن الدفع مقابل زيادة الحصة.