واجهة برمجة تطبيقات CrUX

تتيح واجهة 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
      }
    }

يتيح ذلك فهم البيانات بشكل أفضل ومعرفة ما إذا تم تعديلها لهذا اليوم أو ما إذا كانت تعرض البيانات نفسها التي تم عرضها بالأمس.

تتوفّر فترة الجمع أيضًا في &quot;إحصاءات PageSpeed&quot;:

تعرض أداة إحصاءات PageSpeed تواريخ فترة جمع البيانات في تلميح.
تواريخ فترة جمع البيانات في &quot;إحصاءات PageSpeed&quot;

بالإضافة إلى ذلك، سيعرض 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، سيتم عرض جميع المقاييس المتاحة:

إذا لم يتم تقديم قيمة 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

‫enum (FormFactor)

نوع الجهاز هو سمة طلب بحث تحدّد فئة الجهاز التي يجب أن تنتمي إليها بيانات السجلّ.

يستخدم هذا الحقل القيم DESKTOP أو PHONE أو TABLET.

ملاحظة: في حال عدم تحديد شكل الجهاز، سيتم عرض سجلّ خاص يتضمّن بيانات مجمّعة لجميع أشكال الأجهزة.

metrics[]

string

المقاييس التي يجب تضمينها في الردّ وفي حال عدم تحديد أي منها، سيتم عرض أي مقاييس يتم العثور عليها.

القيم المسموح بها: ["cumulative_layout_shift", "first_contentful_paint", "interaction_to_next_paint", "largest_contentful_paint", "experimental_cumulative_layout_shift_with_softnavs", "experimental_first_contentful_paint_with_softnavs", "experimental_interaction_to_next_paint_with_softnavs", "experimental_largest_contentful_paint_with_softnavs", "experimental_time_to_first_byte", "experimental_navigation_types_with_softnavs", "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", "navigation_types", "round_trip_time", "experimental_ad_count", "experimental_ad_density", "experimental_ad_cpu", "experimental_ad_kilobytes"]

حقل الربط 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/"

على سبيل المثال، لطلب قيم سرعة عرض أكبر محتوى مرئي على أجهزة الكمبيوتر للصفحة الرئيسية لمستندات مطوّري 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

enum (FormFactor)

عامل الشكل هو فئة الجهاز التي استخدمها جميع المستخدمين للوصول إلى الموقع الإلكتروني لهذا السجلّ.

إذا لم يتم تحديد شكل الجهاز، سيتم عرض البيانات المجمّعة على مستوى جميع أشكال الأجهزة.

حقل الربط url_pattern نمط عنوان URL هو عنوان URL الذي ينطبق عليه السجلّ. يمكن أن يكون التعليق url_pattern إحدى القيم التالية فقط:
origin

string

يحدّد origin المصدر الذي يشير إليه هذا السجلّ.

ملاحظة: عند تحديد origin، يتم تجميع بيانات عمليات التحميل ضمن هذا المصدر على جميع الصفحات في بيانات تجربة المستخدم على مستوى المصدر.

url

string

تحدّد السمة url عنوان URL محدّدًا يخصّ هذا السجلّ.

ملاحظة: عند تحديد url، سيتم تجميع البيانات الخاصة بعنوان URL المحدّد فقط.

المقاييس

metric هو مجموعة من بيانات تجربة المستخدم المجمّعة لمقياس أداء ويب واحد، مثل سرعة عرض أول محتوى مرئي. وقد يحتوي على مدرّج تكراري يلخّص استخدام Chrome في الواقع كسلسلة من bins، أو بيانات مئوية محدّدة (مثل p75)، أو قد يحتوي على كسور مصنّفة.

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

أو

{
  "fractions": {
    object (Fractions)
  }
}
الحقول
histogram[]

object (Bin)

المدرّج التكراري لتجارب المستخدمين لمقياس معيّن سيحتوي المدرّج التكراري على مجموعة واحدة على الأقل، وسيصل مجموع كثافة جميع المجموعات إلى 1 تقريبًا.

percentiles

object (Percentiles)

النسب المئوية المفيدة الشائعة للمقياس سيكون نوع القيمة للنسب المئوية هو نفسه أنواع القيم المحدّدة لأقسام المدرّج التكراري.

fractions

object (Fractions)

يحتوي هذا الكائن على كسور مصنّفة، ويبلغ مجموعها حوالي 1.

يتم تقريب الكسور إلى 4 منازل عشرية.

المربع

‫bin هو جزء منفصل من البيانات يمتد من البداية إلى النهاية، أو من البداية إلى ما لا نهاية إذا لم يتم تحديد نهاية.

يتم تحديد قيمتَي البداية والنهاية لكل مجموعة حسب نوع قيمة المقياس الذي تمثّله. على سبيل المثال، يتم قياس سرعة عرض أول محتوى مرئي بالمللي ثانية ويتم عرضها كأعداد صحيحة، وبالتالي ستستخدم مجموعات المقاييس int32s لأنواع البداية والنهاية. ومع ذلك، يتم قياس متغيّرات التصميم التراكمية بأرقام عشرية بدون وحدات ويتم عرضها كأرقام عشرية مرمّزة كسلسلة، وبالتالي ستستخدم مجموعات المقاييس سلاسل لنوع القيمة.

{
  "start": value,
  "end": value,
  "density": number
}
الحقول
start

(integer | string)

"البداية" هي بداية حاوية البيانات.

end

(integer | string)

تمثّل النهاية نهاية حاوية البيانات. إذا لم يتم ملء حقل النهاية، لن يكون للفئة نهاية وستكون صالحة من البداية إلى +inf.

density

number

نسبة المستخدمين الذين واجهوا قيمة هذه الفئة للمقياس المحدّد

يتم تقريب الكثافات إلى 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 صالح لتجربة المستخدم ويمكن البحث عنه بشكل معقول.

الحدود القصوى لمعدّل الاستخدام

يقتصر استخدام CrUX API على 150 طلب بحث في الدقيقة لكل مشروع على Google Cloud، ويتم تقديمها بدون أي رسوم. يمكن الاطّلاع على هذا الحدّ واستخدامك الحالي في Google Cloud Console. من المفترض أن تكون هذه الحصة الكبيرة كافية للغالبية العظمى من حالات الاستخدام، ولا يمكن الدفع مقابل زيادة الحصة.