- طلب HTTP
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- ReportRequest
- أخذ العينات
- السمة
- DimensionFilterClause
- FilterLogicalOperator
- DimensionFilter
- عامل التشغيل
- المقياس
- MetricType
- MetricFilterClause
- MetricFilter
- عامل التشغيل
- OrderBy
- OrderType
- SortOrder
- الشريحة
- DynamicSegment
- SegmentDefinition
- SegmentFilter
- SimpleSegment
- OrFiltersForSegment
- SegmentFilterClause
- SegmentDimensionFilter
- عامل التشغيل
- SegmentMetricFilter
- المستوى
- عامل التشغيل
- SequenceSegment
- SegmentSequenceStep
- MatchType
- محوري
- CohortGroup
- مجموعة نموذجية
- النوع
- الإبلاغ
- ColumnHeader
- MetricHeader
- MetricHeaderEntry
- PivotHeader
- PivotHeaderEntry
- ReportData
- ReportRow
- DateRangeValues
- PivotValueRegion
- ResourceQuotasRemaining
- جرِّبه الآن
تعرض بيانات "إحصاءات Google".
طلب HTTP
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
يستخدم عنوان URL بنية تحويل الترميز gRPC.
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON | |
---|---|
{
"reportRequests": [
{
object( |
الحقول | |
---|---|
reportRequests[] |
الطلبات، سيكون لكل طلب رد منفصل. يمكن إدخال 5 طلبات كحد أقصى. يجب أن تحتوي جميع الطلبات على السمات |
useResourceQuotas |
لتفعيل الحصص المستندة إلى الموارد، (القيم التلقائية على |
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
فئة الاستجابة الرئيسية التي تحتفظ بالتقارير من طلب batchGet
من Reporting API.
تمثيل JSON | |
---|---|
{ "reports": [ { object( |
الحقول | |
---|---|
reports[] |
الردود الخاصة بكل طلب |
queryCost |
يشير هذا المصطلح إلى عدد الرموز المميّزة لحصة الموارد المخصومة لتنفيذ طلب البحث. يشتمل على جميع الردود. |
resourceQuotasRemaining |
مقدار حصة الموارد المتبقية للموقع. |
نطاقات الأذونات
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
ReportRequest
فئة الطلب الرئيسية التي تحدِّد طلب Reporting API.
تمثيل JSON | |
---|---|
{ "viewId": string, "dateRanges": [ { object( |
الحقول | |
---|---|
viewId |
رقم تعريف الملف الشخصي في "إحصاءات Google" المطلوب استرداد البيانات منه. يجب أن تحتوي كل ReportRequest على طريقة |
dateRanges[] |
النطاقات الزمنية في الطلب. يمكن أن يحتوي الطلب على نطاقين زمنيين كحد أقصى. وسيتضمّن الردّ مجموعة من قيم المقاييس لكلّ مجموعة من السمات لكلّ نطاق زمني في الطلب. وبالتالي، في حال كان هناك نطاقان زمنيان، ستكون هناك مجموعتان من قيم المقاييس، إحداهما للنطاق الزمني الأصلي والأخرى للنطاق الزمني الثاني. يجب عدم تحديد الحقل |
samplingLevel |
حجم عيّنة التقرير المطلوب. وإذا لم يتم تحديد الحقل |
dimensions[] |
السمات المطلوبة. يمكن أن تحتوي الطلبات على 9 سمات إجمالاً. |
dimensionFilterClauses[] |
عبارات فلتر السمات لفلترة قيم السمات. ويتم دمجها منطقيًا مع عامل التشغيل |
metrics[] |
المقاييس المطلوبة. يجب أن تحدّد الطلبات مقياسًا واحدًا على الأقل. ويمكن أن تشتمل الطلبات على 10 مقاييس إجمالاً. |
metricFilterClauses[] |
عبارات فلتر المقاييس ويتم دمجها منطقيًا مع عامل التشغيل |
filtersExpression |
فلاتر السمة أو المقياس التي تفرض قيودًا على البيانات المعروضة لطلبك لاستخدام |
orderBys[] |
ترتيب الفرز في صفوف الإخراج. لمقارنة صفين، يتم تطبيق العناصر التالية بالترتيب حتى يتم إيجاد فرق. تحصل جميع النطاقات الزمنية في الناتج على ترتيب الصف نفسه. |
segments[] |
تقسيم البيانات المعروضة للطلب. يساعد تعريف الشريحة في الاطّلاع على مجموعة فرعية من طلب الشريحة. يمكن أن يحتوي الطلب على ما يصل إلى أربع شرائح. يجب أن تحتوي كل سمة ReportRequest داخل طريقة |
pivots[] |
التعريفات المحورية. يمكن أن تحتوي الطلبات على محوريَين كحد أقصى. |
cohortGroup |
مجموعة مجموعات نموذجية مرتبطة بهذا الطلب. إذا كانت هناك مجموعة نموذجية في الطلب، يجب أن تتوفّر السمة |
pageToken |
رمز مميز للمتابعة للحصول على الصفحة التالية من النتائج. ستؤدي إضافة هذا إلى الطلب إلى عرض الصفوف التي تلي pageToken. يجب أن تكون السمة pageToken هي القيمة التي يتم عرضها في المَعلمة nextPageToken عند الردّ على طلب report.batchGet. |
pageSize |
يُستخدم حجم الصفحة في الانتقال من صفحة إلى أخرى ويحدّد الحد الأقصى لعدد الصفوف التي يتم عرضها. يجب أن يكون حجم الصفحة >= 0. يقوم الاستعلام بإرجاع العدد الافتراضي من 1000 صف. تعرِض واجهة برمجة التطبيقات الأساسية لإعداد التقارير في "إحصاءات Google" 100,000 صفّ كحدّ أقصى لكلّ طلب، بغض النظر عن العدد الذي تطلبه. ويمكن أن يعرض أيضًا صفوفًا أقل من المطلوب، إذا لم يكن هناك العدد الذي تتوقعه من شرائح السمات. على سبيل المثال، هناك أقل من 300 قيمة محتملة للسمة |
includeEmptyRows |
في حال ضبطها على "خطأ"، لن تتضمّن الاستجابة صفوفًا إذا كانت جميع المقاييس التي تم استردادها تساوي صفرًا. الإعداد التلقائي هو false، ما يؤدّي إلى استبعاد هذه الصفوف. |
hideTotals |
وفي حال ضبطها على "صحيح"، سيتم إخفاء إجمالي كل المقاييس لجميع الصفوف المطابقة لكل نطاق زمني. تكون القيمة الافتراضية false وتعرض الإجماليات. |
hideValueRanges |
وفي حال ضبطها على "صحيح"، يتم إخفاء الحد الأدنى والحد الأقصى في جميع الصفوف المتطابقة. الإعداد التلقائي هو false ويتم عرض نطاقات القيم. |
أخذ العينات
قيم مستوى تحليل العيّنات
عمليات التعداد | |
---|---|
SAMPLING_UNSPECIFIED |
وإذا لم يتم تحديد الحقل samplingLevel ، سيتم استخدام مستوى أخذ العينات DEFAULT . |
DEFAULT |
تعرض استجابة مع حجم عينة يوازن بين السرعة والدقة. |
SMALL |
يعرض استجابة سريعة بحجم عينة أصغر. |
LARGE |
تعرض إجابة أكثر دقة باستخدام حجم كبير للعيّنة. ولكن قد يؤدي ذلك إلى بطء الاستجابة. |
السمة
السمات هي سمات لبياناتك. على سبيل المثال، تشير السمة ga:city
إلى المدينة، "القاهرة" أو "دبي" مثلاً، التي نشأت منها الجلسة.
تمثيل JSON | |
---|---|
{ "name": string, "histogramBuckets": [ string ] } |
الحقول | |
---|---|
name |
اسم السمة المطلوب استرجاعها، على سبيل المثال |
histogramBuckets[] |
إذا لم تكن قيمة السمة فارغة، نضع قيم السمات في مجموعات بعد السلسلة إلى int64. سيتم تحويل قيم السمات التي لا تمثّل تمثيل السلسلة لقيمة متكاملة إلى صفر. يجب أن تكون قيم الحزمة بترتيب متزايد. ويتم إغلاق كل حزمة من الطرف السفلي وفتحها في الطرف العلوي. تضم المجموعة "الأولى" جميع القيم الأصغر من الحد الأول، بينما تشمل مجموعة البيانات "الأخيرة" جميع القيم حتى ما لا نهاية. يتم تحويل قيم السمات التي تقع في إحدى الحزم إلى قيمة سمة جديدة. على سبيل المثال، إذا قدم أحدهم قائمة من "0، 1، 3، 4، 7"، نُرجع المجموعات التالية:
ملاحظة: في حال تطبيق تغيُّر المدرّج التكراري على أي بُعد، واستخدام هذا البُعد في الترتيب، ستحتاج إلى استخدام نوع الترتيب " "<50", "1001+", "121-1000", "50-120" في ما يلي ترتيب "<50", "50-120", "121-1000", "1001+" على العميل أن يطلب بشكلٍ صريح |
DimensionFilterClause
مجموعة من فلاتر السمات. قم بتعيين قيمة عامل التشغيل لتحديد كيفية دمج الفلاتر بشكل منطقي.
تمثيل JSON | |
---|---|
{ "operator": enum( |
الحقول | |
---|---|
operator |
عامل التشغيل لدمج فلاتر سمات متعددة. وفي حال عدم تحديده، يتم التعامل معه على أنّه |
filters[] |
مجموعة الفلاتر المكررة. يتم دمجها منطقيًا بناءً على العامل المحدد. |
FilterLogicalOperator
كيف يتم دمج الفلاتر بشكل منطقي.
عمليات التعداد | |
---|---|
OPERATOR_UNSPECIFIED |
عامل تشغيل غير محدّد. يتم التعامل معه على أنّه OR . |
OR |
عامل التشغيل OR المنطقي. |
AND |
عامل التشغيل AND المنطقي. |
DimensionFilter
يحدِّد فلتر السمات خيارات الفلترة في سمة معيّنة.
تمثيل JSON | |
---|---|
{
"dimensionName": string,
"not": boolean,
"operator": enum( |
الحقول | |
---|---|
dimensionName |
السمة المطلوب الفلترة وفقًا لها. يجب أن تحتوي سمة AttributeFilter على سمة. |
not |
عامل التشغيل |
operator |
كيفية مطابقة السمة مع التعبير الإعداد التلقائي هو REGEXP. |
expressions[] |
سلاسل أو تعبير عادي للمطابقة معه. يتم استخدام القيمة الأولى فقط من القائمة للمقارنة ما لم يكن عامل التشغيل هو |
caseSensitive |
هل يجب أن تكون المطابقة حسّاسة لحالة الأحرف؟ والقيمة التلقائية هي "خطأ". |
مُشغِّل
يتم دعم أنواع المطابقة المختلفة.
عمليات التعداد | |
---|---|
OPERATOR_UNSPECIFIED |
في حال عدم تحديد نوع المطابقة، يتم التعامل معه على أنّه REGEXP . |
REGEXP |
ويتم التعامل مع تعبير المطابقة كتعبير عادي. لا يتم التعامل مع جميع أنواع المطابقة كتعبيرات عادية. |
BEGINS_WITH |
يطابق القيمة التي تبدأ بتعبير المطابقة المقدم. |
ENDS_WITH |
يطابق القيم التي تنتهي بتعبير المطابقة المقدَّم. |
PARTIAL |
مطابقة سلسلة فرعية. |
EXACT |
يجب أن تتطابق القيمة مع تعبير المطابقة تمامًا. |
NUMERIC_EQUAL |
فلاتر مقارنة الأعداد الصحيحة. يتم تجاهل الحساسية لحالة الأحرف لهذه القيم، ويُفترض أن يكون التعبير سلسلة تمثِّل عددًا صحيحًا. شروط الإخفاق:
|
NUMERIC_GREATER_THAN |
للتحقق مما إذا كانت السمة أكبر من تعبير المطابقة رقميًا. اقرأ وصف NUMERIC_EQUALS للاطّلاع على القيود. |
NUMERIC_LESS_THAN |
للتحقق مما إذا كانت السمة أقل رقميًا من تعبير المطابقة. اقرأ وصف NUMERIC_EQUALS للاطّلاع على القيود. |
IN_LIST |
يُستخدَم هذا الخيار لتحديد فلتر سمات يمكن أن يأخذ تعبيره أي قيمة من قائمة قيم محدّدة. يساعد ذلك في تجنُّب تقييم فلاتر متعددة لسمات المطابقة التامة والتي يتم إجراؤها على "أو" لكل صف رد فردي. مثال:
أي صف استجابة يحتوي على أبعاده بقيمة A أو B أو C، يتطابق مع AttributeFilter هذا. |
المقياس
المقاييس هي المقاييس الكَمية. على سبيل المثال، يشير المقياس ga:users
إلى إجمالي عدد المستخدمين للفترة الزمنية المطلوبة.
تمثيل JSON | |
---|---|
{
"expression": string,
"alias": string,
"formattingType": enum( |
الحقول | |
---|---|
expression |
تعبير مقياس في الطلب. يتم إنشاء تعبير من مقياس ورقم واحد أو أكثر. وتشمل عوامل التشغيل المقبولة ما يلي: علامة الجمع (+) والطرح (-) والنقاب (Unary -) والمقسمة على (/) والضرب في (*) والأقواس والأعداد الأساسية الموجبة (من 0 إلى 9) ويمكن أن تتضمّن أرقامًا عشرية وتقتصر على 1024 حرفًا. مثال على |
alias |
الاسم المستعار لتعبير المقياس هو اسم بديل للتعبير. يمكن استخدام الاسم المستعار للتصفية والفرز. هذا الحقل اختياري ومفيد إذا لم يكن التعبير مقياسًا واحدًا ولكنه تعبيرًا معقدًا لا يمكن استخدامه في الفلترة والفرز. ويُستخدم الاسم المستعار أيضًا في عنوان عمود الاستجابة. |
formattingType |
تُحدِّد هذه السمة كيفية تنسيق تعبير المقياس، على سبيل المثال |
MetricType
أنواع المقاييس.
عمليات التعداد | |
---|---|
METRIC_TYPE_UNSPECIFIED |
لم يتم تحديد نوع المقياس. |
INTEGER |
مقياس الأعداد الصحيحة |
FLOAT |
مقياس التعويم |
CURRENCY |
مقياس العملة |
PERCENT |
مقياس النسبة المئوية |
TIME |
مقياس الوقت بتنسيق HH:MM:SS |
MetricFilterClause
تعرِض هذه السمة مجموعة من فلاتر المقاييس. قم بتعيين قيمة عامل التشغيل لتحديد كيفية دمج الفلاتر بشكل منطقي.
تمثيل JSON | |
---|---|
{ "operator": enum( |
الحقول | |
---|---|
operator |
عامل التشغيل للجمع بين فلاتر مقاييس متعددة. وفي حال عدم تحديده، يتم التعامل معه على أنّه |
filters[] |
مجموعة الفلاتر المكررة. يتم دمجها منطقيًا بناءً على العامل المحدد. |
MetricFilter
يحدد MetricFilter الفلتر الذي يتعلق بمقياس معين.
تمثيل JSON | |
---|---|
{
"metricName": string,
"not": boolean,
"operator": enum( |
الحقول | |
---|---|
metricName |
المقياس الذي ستتم الفلترة عليه. يجب أن يحتوي فلتر المقاييس على اسم مقياس. يمكن أن يكون اسم المقياس اسمًا مستعارًا تم تحديده سابقًا كمقياس أو يمكن أن يكون أيضًا تعبيرًا لمقياس. |
not |
عامل التشغيل |
operator |
هل المقياس |
comparisonValue |
القيمة المطلوب المقارنة بها. |
مُشغِّل
الخيارات المختلفة لأنواع المقارنة
عمليات التعداد | |
---|---|
OPERATOR_UNSPECIFIED |
إذا لم يتم تحديد عامل التشغيل، سيتم التعامل معه على أنّه EQUAL . |
EQUAL |
يجب أن تكون قيمة المقياس مساوية لقيمة المقارنة تمامًا. |
LESS_THAN |
يجب أن تكون قيمة المقياس أقل من قيمة المقارنة. |
GREATER_THAN |
يجب أن تكون قيمة المقياس أكبر من قيمة المقارنة. |
IS_MISSING |
يتم التحقّق من عدم توفّر المقياس. لا تأخذ ratingValue في الاعتبار. |
OrderBy
لتحديد خيارات الترتيب.
تمثيل JSON | |
---|---|
{ "fieldName": string, "orderType": enum( |
الحقول | |
---|---|
fieldName |
الحقل الذي سيتم الترتيب على أساسه. يكون نظام الترتيب التلقائي تصاعديًا. مثال: |
orderType |
نوع الطلب إنّ نوع الطلب التلقائي هو |
sortOrder |
ترتيب الفرز للحقل. |
OrderType
يتحكم نوع الطلب في كيفية تحديد نظام الترتيب.
عمليات التعداد | |
---|---|
ORDER_TYPE_UNSPECIFIED |
سيتم التعامل مع نوع الطلب غير المحدّد باعتباره ترتيبًا استنادًا إلى القيمة. |
VALUE |
يستند نظام الترتيب إلى قيمة العمود الذي تم اختياره، ويتم البحث في النطاق الزمني الأول فقط. |
DELTA |
يستند ترتيب الترتيب إلى الفرق في قيم العمود الذي تم اختياره بين النطاقين الزمنيين الأولين. قابلة للاستخدام فقط إذا كان هناك نطاقان زمنيان بالضبط. |
SMART |
ويستند نظام الترتيب إلى القيمة المرجحة للعمود الذي تم اختياره. إذا كان العمود يحتوي على تنسيق n/d، ستكون القيمة المرجّحة لهذه النسبة (n + totals.n)/(d + totals.d) قابلة للاستخدام فقط للمقاييس التي تمثّل النِسب. |
HISTOGRAM_BUCKET |
لا ينطبق نوع ترتيب المدرج التكراري إلا على أعمدة السمات التي تحتوي على مدرّجات تكرارية غير فارغة. |
DIMENSION_AS_INTEGER |
إذا كانت الأبعاد أرقامًا ثابتة الطول، فإن الفرز العادي سيعمل بشكل جيد. يمكن استخدام السمة DIMENSION_AS_INTEGER إذا كانت الأبعاد أرقامًا متغيرة الطول. |
SortOrder
تمثّل هذه السمة ترتيب الفرز.
عمليات التعداد | |
---|---|
SORT_ORDER_UNSPECIFIED |
في حال عدم تحديد نظام الترتيب، يكون الترتيب التلقائي تصاعديًا. |
ASCENDING |
ترتيب تصاعدي. سيتم ترتيب الحقل تصاعديًا. |
DESCENDING |
ترتيب تنازلي. سيتم فرز الحقل بطريقة تنازلية. |
تقسيم
تعريف الشريحة، إذا كان التقرير بحاجة إلى تقسيم. الشريحة هي مجموعة فرعية من بيانات "إحصاءات Google". على سبيل المثال، من بين المجموعة الكاملة من المستخدِمين، قد تتمثل إحدى الشرائح في مستخدِمين من بلد معيّن أو مدينة معيّنة.
تمثيل JSON | |
---|---|
{ // Union field |
الحقول | ||
---|---|---|
حقل الاتحاد dynamicOrById يمكن تحديد الشريحة ديناميكيًا باستخدام شريحة ديناميكية أو باستخدام رقم تعريف شريحة مدمجة أو مخصّصة. يمكن أن يكون الحقل "dynamicOrById " واحدًا فقط مما يلي: |
||
dynamicSegment |
تعريف شريحة ديناميكية في الطلب. |
|
segmentId |
رقم تعريف شريحة الجمهور المضمّنة أو المخصّصة، على سبيل المثال |
DynamicSegment
تعريف الشريحة الديناميكية لتعريف الشريحة ضمن الطلب. يمكن للشريحة اختيار مستخدِمين أو جلسات أو كليهما.
تمثيل JSON | |
---|---|
{ "name": string, "userSegment": { object( |
الحقول | |
---|---|
name |
اسم الشريحة الديناميكية. |
userSegment |
شريحة مستخدمين لاختيار المستخدمين المراد تضمينهم في الشريحة |
sessionSegment |
شريحة الجلسة لاختيار الجلسات المراد تضمينها في الشريحة. |
SegmentDefinition
يعرّف ClipDefinition المقطع ليكون مجموعة من فلاتر الشرائح التي يتم دمجها مع عملية AND
المنطقية.
تمثيل JSON | |
---|---|
{
"segmentFilters": [
{
object( |
الحقول | |
---|---|
segmentFilters[] |
يتم تحديد الشريحة من خلال مجموعة من فلاتر الشرائح التي يتم دمجها مع عملية |
SegmentFilter
يعرِّف تطبيق ClipFilter الشريحة ليكون إما شريحة بسيطة أو شريحة تسلسل. يحتوي شرط الشريحة البسيط على شروط السمات والمقاييس لاختيار الجلسات أو المستخدمين. يمكن استخدام شرط شريحة التسلسل لاختيار مستخدمين أو جلسات استنادًا إلى الشروط التسلسلية.
تمثيل JSON | |
---|---|
{ "not": boolean, // Union field |
الحقول | ||
---|---|---|
not |
إذا كانت القيمة صحيحة، يجب مطابقة مكمّلة الشريحة البسيطة أو المتسلسلة. على سبيل المثال، لمطابقة جميع الزيارات التي ليست من "نيويورك"، يمكننا تعريف الشريحة على النحو التالي:
|
|
حقل الاتحاد simpleOrSequence هل هو تعريف شريحة بسيطة أم شريحة تسلسلية. يمكن أن يكون الحقل "simpleOrSequence " واحدًا فقط مما يلي: |
||
simpleSegment |
تتألف شروط الشريحة البسيطة من شرط واحد أو أكثر من شروط السمات/المقاييس التي يمكن دمجها. |
|
sequenceSegment |
وتتألف شروط التسلسل من خطوة واحدة أو أكثر، حيث يتمّ تحديد كلّ خطوة بشرط واحد أو أكثر من شروط السمة/المقياس. يمكن دمج خطوات متعددة مع عوامل تشغيل تسلسل خاصة. |
SimpleSegment
تتألف شروط الشريحة البسيطة من شرط واحد أو أكثر من شروط السمات/المقاييس التي يمكن دمجها.
تمثيل JSON | |
---|---|
{
"orFiltersForSegment": [
{
object( |
الحقول | |
---|---|
orFiltersForSegment[] |
قائمة بمجموعات فلاتر الشرائح التي يتم دمجها مع عامل التشغيل |
OrFiltersForSegment
يتم دمج قائمة بفلاتر الشرائح في مجموعة OR
مع عامل التشغيل المنطقي OR.
تمثيل JSON | |
---|---|
{
"segmentFilterClauses": [
{
object( |
الحقول | |
---|---|
segmentFilterClauses[] |
قائمة بفلاتر الشرائح التي سيتم دمجها مع عامل تشغيل |
SegmentFilterClause
يمكن استخدام عبارة الفلتر - التي تُستخدَم في تعريف الشريحة - مع مقياس أو فلتر مكوّن.
تمثيل JSON | |
---|---|
{ "not": boolean, // Union field |
الحقول | ||
---|---|---|
not |
يتطابق مع المكمل ( |
|
حقل الاتحاد dimensionOrMetricFilter فلتر السمة أو المقياس. يمكن أن يكون الحقل "dimensionOrMetricFilter " واحدًا فقط مما يلي: |
||
dimensionFilter |
فلتر البُعد لتعريف الشريحة. |
|
metricFilter |
فلتر المقياس لتعريف الشريحة. |
SegmentDimensionFilter
يحدِّد فلتر السمات خيارات الفلترة في سمة معيّنة.
تمثيل JSON | |
---|---|
{
"dimensionName": string,
"operator": enum( |
الحقول | |
---|---|
dimensionName |
اسم السمة التي يتم تطبيق الفلتر عليها. |
operator |
عامل التشغيل المطلوب استخدامه لمطابقة السمة مع التعبيرات. |
caseSensitive |
إذا كانت المطابقة حسّاسة لحالة الأحرف، يتم تجاهلها لعامل التشغيل |
expressions[] |
قائمة التعبيرات، يُستخدم العنصر الأول فقط مع جميع العوامل |
minComparisonValue |
الحد الأدنى لقيم المقارنة لنوع مطابقة |
maxComparisonValue |
الحد الأقصى لقيم المقارنة لنوع مطابقة واحد ( |
مُشغِّل
يتم دعم أنواع المطابقة المختلفة.
عمليات التعداد | |
---|---|
OPERATOR_UNSPECIFIED |
إذا لم يتم تحديد نوع المطابقة، يتم التعامل معه على أنّه REGEXP. |
REGEXP |
ويتم التعامل مع تعبير المطابقة كتعبير عادي. ولا يتم التعامل مع جميع أنواع المطابقة الأخرى كتعبيرات عادية. |
BEGINS_WITH |
يطابق القيم التي تبدأ بتعبير المطابقة المقدَّم. |
ENDS_WITH |
يطابق القيم التي تنتهي بتعبير المطابقة المقدَّم. |
PARTIAL |
مطابقة سلسلة فرعية. |
EXACT |
يجب أن تتطابق القيمة مع تعبير المطابقة تمامًا. |
IN_LIST |
يُستخدَم هذا الخيار لتحديد فلتر سمات يمكن أن يأخذ تعبيره أي قيمة من قائمة قيم محدّدة. يساعد ذلك في تجنُّب تقييم فلاتر متعددة لسمات المطابقة التامة والتي يتم إجراؤها على "أو" لكل صف رد فردي. مثال:
أي صف استجابة يحتوي على أبعاده بقيمة A أو B أو C، يتطابق مع AttributeFilter هذا. |
NUMERIC_LESS_THAN |
فلاتر مقارنة الأعداد الصحيحة. يتم تجاهل الحساسية لحالة الأحرف لهذه القيم، ويُفترض أن يكون التعبير سلسلة تمثِّل عددًا صحيحًا. شروط الإخفاق:
للتحقق مما إذا كانت السمة أقل رقميًا من تعبير المطابقة. |
NUMERIC_GREATER_THAN |
للتحقق مما إذا كانت السمة أكبر من تعبير المطابقة رقميًا. |
NUMERIC_BETWEEN |
للتحقّق مما إذا كانت السمة رقميًا بين الحد الأدنى والأقصى لتعبير المطابقة، تم استبعاد الحدود. |
SegmentMetricFilter
فلتر المقياس الذي سيتم استخدامه في عبارة فلتر شريحة.
تمثيل JSON | |
---|---|
{ "scope": enum( |
الحقول | |
---|---|
scope |
يحدِّد نطاق المقياس المستوى الذي يتم تحديد هذا المقياس عنده. يجب أن يكون نطاق المقياس المحدّد مساويًا لنطاقه الأساسي أو أكبر منه كما هو محدّد في نموذج البيانات. يتمّ تحديد النطاق الأساسي حسب ما إذا كانت الشريحة تختار المستخدِمين أو الجلسات. |
metricName |
المقياس الذي ستتم الفلترة عليه. يجب أن يحتوي |
operator |
التحديد هي العملية المطلوب تنفيذها لمقارنة المقياس. والقيمة التلقائية هي |
comparisonValue |
القيمة المطلوب المقارنة بها. إذا كان عامل التشغيل |
maxComparisonValue |
يتم استخدام الحد الأقصى لقيمة المقارنة مع عامل تشغيل |
النطاق
يحدِّد نطاق المقياس المستوى الذي يتم تحديد هذا المقياس عنده - PRODUCT
أو HIT
أو SESSION
أو USER
. يمكن أيضًا الإبلاغ عن قيم المقاييس على نطاقات أكبر من نطاقها الأساسي. على سبيل المثال: يمكن إعداد تقارير عن ga:pageviews
وga:transactions
على المستوى SESSION
وUSER
من خلال إضافتهما لكل نتيجة تحدث في هاتين الجلستَين أو لهؤلاء المستخدمين.
عمليات التعداد | |
---|---|
UNSPECIFIED_SCOPE |
في حال عدم تحديد النطاق، يتم ضبطه تلقائيًا على نطاق الشرط USER أو SESSION استنادًا إلى ما إذا كانت الشريحة تحاول اختيار المستخدمين أو الجلسات. |
PRODUCT |
نطاق المنتج. |
HIT |
نطاق النتيجة. |
SESSION |
نطاق الجلسة. |
USER |
نطاق المستخدم. |
مُشغِّل
الخيارات المختلفة لأنواع المقارنة
عمليات التعداد | |
---|---|
UNSPECIFIED_OPERATOR |
يتم التعامل مع عامل تشغيل غير محدّد كعامل تشغيل LESS_THAN . |
LESS_THAN |
للتحقّق مما إذا كانت قيمة المقياس أقل من قيمة المقارنة. |
GREATER_THAN |
للتحقّق مما إذا كانت قيمة المقياس أكبر من قيمة المقارنة. |
EQUAL |
عامل التشغيل يساوي. |
BETWEEN |
وبالنسبة إلى عامل التشغيل، يكون الحد الأدنى والحد الأقصى فقط حصريَّين. سنستخدم السمتَين LT وGT للمقارنة. |
SequenceSegment
وتتألف شروط التسلسل من خطوة واحدة أو أكثر، حيث يتمّ تحديد كلّ خطوة بشرط واحد أو أكثر من شروط السمة/المقياس. يمكن دمج خطوات متعددة مع عوامل تشغيل تسلسل خاصة.
تمثيل JSON | |
---|---|
{
"segmentSequenceSteps": [
{
object( |
الحقول | |
---|---|
segmentSequenceSteps[] |
تمثّل هذه السمة قائمة الخطوات في التسلسل. |
firstStepShouldMatchFirstHit |
في حال تحديد شرط الخطوة الأولى، يجب أن يتطابق مع النتيجة الأولى للزائر (في النطاق الزمني). |
SegmentSequenceStep
تعريف تسلسل الشريحة.
تمثيل JSON | |
---|---|
{ "orFiltersForSegment": [ { object( |
الحقول | |
---|---|
orFiltersForSegment[] |
يتم تحديد التسلسل باستخدام قائمة فلاتر "أو" المجمّعة التي يتم دمجها مع عامل التشغيل |
matchType |
لتحديد ما إذا كانت الخطوة يسبق الخطوة التالية أو يمكن أن تكون قبل الخطوة التالية مباشرةً. |
MatchType
نوع المطابقة للتسلسل.
عمليات التعداد | |
---|---|
UNSPECIFIED_MATCH_TYPE |
يتم التعامل مع نوع المطابقة غير المحدّد على أنّه مسبوق. |
PRECEDES |
يشير عامل التشغيل إلى أن الخطوة السابقة تسبق الخطوة التالية. |
IMMEDIATELY_PRECEDES |
يشير عامل التشغيل إلى أن الخطوة السابقة تسبق الخطوة التالية مباشرةً. |
إيقاعات محورية
يصف العنصر المحوري القسم المحوري في الطلب. يساعد المحور المحوري في إعادة ترتيب المعلومات في الجدول لتقارير معينة من خلال تغيير محور البيانات إلى بُعد ثانٍ.
تمثيل JSON | |
---|---|
{ "dimensions": [ { object( |
الحقول | |
---|---|
dimensions[] |
قائمة بالسمات المطلوب عرضها كأعمدة محورية يمكن أن يحتوي العنصر المحوري على 4 أبعاد بحدٍ أقصى. تشكّل السمات المحورية جزءًا من القيود المفروضة على إجمالي عدد السمات المسموح بها في الطلب. |
dimensionFilterClauses[] |
يتم دمج قيَمFilterClauses بشكلٍ منطقي مع عامل التشغيل |
metrics[] |
المقاييس المحورية. المقاييس المحورية هي جزء من القيود المفروضة على إجمالي عدد المقاييس المسموح بها في الطلب. |
startGroup |
إذا تم طلب مقاييس كيلو، فستحتوي الاستجابة على بعض مضاعفات أعمدة التصنيف المعتمدة على البيانات في التقرير. على سبيل المثال، إذا اخترت المحور يتيح لك ما يلي اختيار أي من مجموعات الأعمدة k يتم تضمينها في الاستجابة. |
maxGroupCount |
تحدد هذه السمة الحد الأقصى لعدد المجموعات المطلوب عرضها. القيمة التلقائية هي 10، والحد الأقصى للقيمة هو 1000. |
CohortGroup
تحدّد هذه السمة مجموعة نموذجية. مثال:
"cohortGroup": {
"cohorts": [{
"name": "cohort 1",
"type": "FIRST_VISIT_DATE",
"dateRange": { "startDate": "2015-08-01", "endDate": "2015-08-01" }
},{
"name": "cohort 2"
"type": "FIRST_VISIT_DATE"
"dateRange": { "startDate": "2015-07-01", "endDate": "2015-07-01" }
}]
}
تمثيل JSON | |
---|---|
{
"cohorts": [
{
object( |
الحقول | |
---|---|
cohorts[] |
تعريف المجموعة النموذجية. |
lifetimeValue |
تفعيل القيمة الدائمة (LTV). تقيس القيمة الدائمة القيمة الدائمة للمستخدمين المكتسبين من خلال قنوات مختلفة. يُرجى مراجعة: التحليل الجماعي والقيمة الدائمة إذا كانت قيمة القيمة الدائمة خاطئة:
عندما تكون قيمة ageValue صحيحة:
|
المجموعة النموذجية
تحدِّد هذه السمة مجموعة نموذجية. المجموعة النموذجية هي مجموعة من المستخدمين تجمعهم خاصية مشتركة. على سبيل المثال، ينتمي جميع المستخدمين بتاريخ الاكتساب نفسه إلى المجموعة النموذجية نفسها.
تمثيل JSON | |
---|---|
{ "name": string, "type": enum( |
الحقول | |
---|---|
name |
اسم فريد للمجموعة النموذجية وفي حال عدم تحديد اسم معيّن، سيتم إنشاؤه تلقائيًا باستخدام القيم مجموعة تجريبية_[1234...]. |
type |
نوع المجموعة النموذجية. النوع الوحيد المتوافق حاليًا هو |
dateRange |
تُستخدم هذه المجموعة في المجموعة النموذجية |
النوع
نوع المجموعة النموذجية
عمليات التعداد | |
---|---|
UNSPECIFIED_COHORT_TYPE |
وفي حال عدم تحديده، يتم التعامل معه على أنّه FIRST_VISIT_DATE . |
FIRST_VISIT_DATE |
المجموعات النموذجية التي يتم اختيارها استنادًا إلى تاريخ الزيارة الأولى. |
الإبلاغ
استجابة البيانات المناظرة للطلب.
تمثيل JSON | |
---|---|
{ "columnHeader": { object( |
الحقول | |
---|---|
columnHeader |
عناوين الأعمدة. |
data |
بيانات الاستجابة |
nextPageToken |
الرمز المميز للصفحة لاسترداد الصفحة التالية من النتائج في القائمة. |
ColumnHeader
رؤوس الأعمدة.
تمثيل JSON | |
---|---|
{
"dimensions": [
string
],
"metricHeader": {
object( |
الحقول | |
---|---|
dimensions[] |
أسماء السمات في الردّ |
metricHeader |
عناوين المقاييس للمقاييس في الردّ |
MetricHeader
عناوين المقاييس.
تمثيل JSON | |
---|---|
{ "metricHeaderEntries": [ { object( |
الحقول | |
---|---|
metricHeaderEntries[] |
عناوين المقاييس في الردّ |
pivotHeaders[] |
عناوين للنقاط المحورية في الرد |
MetricHeaderEntry
عنوان للمقاييس
تمثيل JSON | |
---|---|
{
"name": string,
"type": enum( |
الحقول | |
---|---|
name |
تمثّل هذه السمة اسم العنوان. |
type |
نوع المقياس، على سبيل المثال |
PivotHeader
العناوين لكل قسم من الأقسام المحورية المحددة في الطلب.
تمثيل JSON | |
---|---|
{
"pivotHeaderEntries": [
{
object( |
الحقول | |
---|---|
pivotHeaderEntries[] |
عنوان قسم محوري واحد. |
totalPivotGroupsCount |
إجمالي عدد المجموعات لهذا المحور. |
PivotHeaderEntry
العناوين لكل عمود من أعمدة المقياس المقابلة للمقاييس المطلوبة في قسم النقاط المحورية في الرد.
تمثيل JSON | |
---|---|
{
"dimensionNames": [
string
],
"dimensionValues": [
string
],
"metric": {
object( |
الحقول | |
---|---|
dimensionNames[] |
اسم السمات في الردّ المحوري. |
dimensionValues[] |
قيم السمات في المحور. |
metric |
عنوان المقياس للمقياس في المحور المحوري. |
ReportData
جزء البيانات من التقرير.
تمثيل JSON | |
---|---|
{ "rows": [ { object( |
الحقول | |
---|---|
rows[] |
هناك صف تقرير واحد لكل مجموعة فريدة من السمات. |
totals[] |
بالنسبة إلى كل نطاق زمني مطلوب، تحصل مجموعة الصفوف التي تطابق طلب البحث على إجمالي لكل تنسيق قيمة مطلوب. ويتم احتساب إجمالي تنسيق القيمة من خلال جمع المقاييس المذكورة في تنسيق القيمة أولاً، ثم تقييم تنسيق القيمة كتعبير عددي. على سبيل المثال: نُحتسب "القيم الإجمالية" لـ |
rowCount |
إجمالي عدد الصفوف المطابقة لطلب البحث هذا. |
minimums[] |
القيم الدنيا والقصوى المعروضة في جميع الصفوف المطابقة. وتكون هذه القيم فارغة عندما يكون |
maximums[] |
القيم الدنيا والقصوى المعروضة في جميع الصفوف المطابقة. وتكون هذه القيم فارغة عندما يكون |
samplesReadCounts[] |
إذا كانت النتائج مستندة إلى عيّنات، سيتم عرض إجمالي عدد النماذج التي تمت قراءتها، بمعدل إدخال واحد لكل نطاق زمني. وإذا لم تكن النتائج مستندة إلى عيّنات، لن يتم تعريف هذا الحقل. راجِع دليل المطوِّر للحصول على التفاصيل. |
samplingSpaceSizes[] |
إذا كانت النتائج مستندة إلى عيّنات، سيتم عرض إجمالي عدد النماذج المتاحة، أي إدخال واحد لكل نطاق زمني. وإذا لم تكن النتائج مستندة إلى عيّنات، لن يتم تعريف هذا الحقل. راجِع دليل المطوِّر للحصول على التفاصيل. |
isDataGolden |
يشير إلى ما إذا كان الرد على هذا الطلب ذهبيًا أم لا. تكون البيانات مهمة عندما لا يؤدي الطلب نفسه بالضبط إلى أي نتائج جديدة إذا طُلب منك في وقت لاحق. |
dataLastRefreshed |
تاريخ آخر مرة تمت فيها إعادة تحميل البيانات في التقرير. يتم تضمين جميع النتائج المُستلَمة قبل هذا الطابع الزمني في حساب التقرير. يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu" وبدقّة تصل إلى نانوثانية. مثال: |
ReportRow
صف في التقرير
تمثيل JSON | |
---|---|
{
"dimensions": [
string
],
"metrics": [
{
object( |
الحقول | |
---|---|
dimensions[] |
قائمة السمات المطلوبة. |
metrics[] |
قائمة بالمقاييس لكل نطاق تاريخ مطلوب |
DateRangeValues
يتم استخدامه لعرض قائمة مقاييس لمجموعة نطاق تاريخ / سمات واحدة
تمثيل JSON | |
---|---|
{
"values": [
string
],
"pivotValueRegions": [
{
object( |
الحقول | |
---|---|
values[] |
تتوافق كل قيمة مع كل مقياس في الطلب. |
pivotValueRegions[] |
قيم كل منطقة محورية. |
PivotValueRegion
قيم المقياس في المنطقة المحورية
تمثيل JSON | |
---|---|
{ "values": [ string ] } |
الحقول | |
---|---|
values[] |
قيم المقاييس في كل منطقة من المناطق المحورية. |
ResourceQuotasRemaining
الرموز المميّزة لحصة الموارد المتبقية للموقع بعد اكتمال الطلب
تمثيل JSON | |
---|---|
{ "dailyQuotaTokensRemaining": number, "hourlyQuotaTokensRemaining": number } |
الحقول | |
---|---|
dailyQuotaTokensRemaining |
حصة الموارد المتبقية اليومية المتبقية: |
hourlyQuotaTokensRemaining |
الرموز المميّزة لحصص الموارد المتبقية بالساعة |