إعداد التقارير في "منصة خرائط Google"

توفّر ميزة إعداد التقارير في "منصّة خرائط Google" مجموعة من التقارير المرئية المُحدّدة مسبقًا عن معلومات الاستخدام الأساسية لواجهة برمجة التطبيقات والحصة والفوترة في Google Cloud Console. استخدِم هذه التقارير لتحديد عدد طلبات برمجة التطبيقات التي أجريتها، ومدى قربك من بلوغ حصص استخدام واجهة برمجة التطبيقات، ومراقبة استخدام الفوترة بمرور الوقت.

تشمل أنواع التقارير ما يلي:

• تقارير الاستخدام: تُسجِّل عدد الطلبات التي يقدّمها مشروعك إلى واجهات برمجة تطبيقات "منصّة خرائط Google" باستخدام بيانات الاعتماد المرتبطة بمشروعك.
• تقارير الحصص: تُستخدَم لإعداد تقارير عن استخدام الحصة في الرسوم البيانية التي يمكن تجميعها في طلبات في الدقيقة. يتم عرض حدود الحصة الحالية لواجهات برمجة التطبيقات المحدّدة في الجداول أسفل الرسوم البيانية لاستخدام الحصة.
• تقارير الفوترة: تُستخدَم لإعداد تقارير عن التكاليف بمرور الوقت في رسم بياني خطي مجمع. يمكنك الاطّلاع على استخدام الحصة للشهر الحالي، بما في ذلك أي أرصدة خاصة بالاستخدام تم تطبيقها، بالإضافة إلى إجمالي التكلفة المتوقّعة للشهر الحالي بأكمله.
• scienceتقارير التفاعل: تقدّم إحصاءات عن النشاط التجاري حول كيفية تفاعل المستخدمين مع تطبيقات الخرائط.

للحصول على قائمة كاملة بحالات الاستجابة ورموزها التي تحدّد ما إذا كان الطلب يظهر في تقارير الاستخدام والحصة و/أو الفوترة، يُرجى الاطّلاع على حالة الاستجابة والتقارير.

يمكنك الاطّلاع على تقارير استخدام "منصة خرائط Google" وحصصها وفوترتها باستخدام وحدة تحكّم Cloud.

تقارير الاستخدام

يستند الاستخدام إلى عدد الطلبات التي يقدّمها مشروعك إلى واجهتَي برمجة التطبيقات Google Maps Platform API باستخدام بيانات الاعتماد المرتبطة بمشروعك. تشمل الطلبات الطلبات الناجحة والطلبات التي تؤدي إلى أخطاء في الخادم والطلبات التي تؤدي إلى أخطاء في العميل. تشمل بيانات الاعتماد مفاتيح واجهة برمجة التطبيقات ومعرّفات العملاء (لمشاريع "الخطة المميّزة" ومشاريع "الخطة المميّزة" التي تم نقلها). لمعرفة التفاصيل، يُرجى الاطّلاع على نظرة عامة على الخطة المدفوعة واطلاعك على معلومات عن استخدام معرّف العميل.

يتم عرض مقاييس الاستخدام في الجداول (الطلبات والأخطاء ووقت الاستجابة) والرسوم البيانية (عدد الزيارات والأخطاء ووقت الاستجابة). لأغراض التتبّع:

• جميع واجهات برمجة التطبيقات: يمكنك فلترة مقاييس الاستخدام لجميع واجهات برمجة التطبيقات وتجميعها بالطُرق التالية:

  • الفلترة حسب الفترة الزمنية وواجهة برمجة التطبيقات
  • الاطّلاع على عدد الزيارات والأخطاء ووقت الاستجابة المجمّعة حسب رمز الاستجابة وواجهة برمجة التطبيقات ومقاييس الأمان

• واجهة برمجة تطبيقات معيّنة: يمكنك فلترة مقاييس الاستخدام وتجميعها لواجهة برمجة تطبيقات معيّنة بهذه الطرق:

  • يمكنك الفلترة حسب الفترة الزمنية وإصدارات واجهات برمجة التطبيقات وبيانات الاعتماد والطُرق.
  • يمكنك الاطّلاع على عدد الزيارات والأخطاء ووقت الاستجابة المجمّعة حسب رمز الاستجابة وطريقة واجهة برمجة التطبيقات وإصدارها والمستندات المُعتمَدة.

صفحة لوحة بيانات "واجهات برمجة التطبيقات والخدمات"

تقدّم لوحة بيانات "واجهات برمجة التطبيقات والخدمات" نظرة عامة على مقاييس الاستخدام لجميع واجهات برمجة التطبيقات التي تم تفعيلها لمشروعك: واجهات برمجة تطبيقات "منصة خرائط Google" بالإضافة إلى خدمات وواجهات برمجة تطبيقات أخرى.

1. افتح صفحة "أداة اختيار المشاريع" في Cloud Console:

   صفحة أداة اختيار المشاريع

2. اختَر مشروعك. تظهر صفحة "لوحة بيانات واجهات برمجة التطبيقات والخدمات".
   
   إذا لم تظهر الصفحة، انقر على زر القائمة ثم على واجهات برمجة التطبيقات والخدمات.

لمزيد من المعلومات، يُرجى الاطّلاع على مراقبة استخدام واجهة برمجة التطبيقات.

صفحة النظرة العامة على "خرائط Google"

تتضمّن صفحة نظرة عامة في "خرائط Google" جدولاً يسرد واجهات برمجة التطبيقات المفعّلة وطلبات الاستخدام خلال آخر 30 يومًا. يتم أيضًا عرض الطلبات حسب واجهة برمجة التطبيقات في شكل رسم بياني. يعرض الرسم البياني للفوترة فاتورتك الحالية وإجمالي الاستخدام خلال آخر 3 أشهر.

للوصول إلى صفحة "نظرة عامة على "منصة خرائط Google":

1. افتح صفحة "منصة خرائط Google" في Cloud Console:

   الانتقال إلى صفحة "منصة خرائط Google"

2. في القائمة اليمنى، انقر على نظرة عامة.

صفحة "واجهات برمجة التطبيقات والخدمات في Google Maps Platform"

تحتوي صفحة واجهات برمجة التطبيقات والخدمات في "خرائط Google" على شبكة من المربّعات التي تمثّل واجهات برمجة التطبيقات وحِزم تطوير البرامج (SDK) والخدمات الأخرى المتوفّرة لمشروعك. ضمن كل مربّع، يمكنك تفعيل هذه الخدمة أو إيقافها من خلال النقر على تفعيل أو إيقاف، ويمكنك الوصول إلى معلومات بيانات الاعتماد والمقاييس وأدلة المستخدمين ل واجهات برمجة التطبيقات المفعَّلة. يمكنك أيضًا استخدام فلاتر الصفحة لعرض الخدمات المفعَّلة أو المتوقفة والفئات الأخرى للخدمات.

للوصول إلى صفحة "واجهات برمجة التطبيقات والخدمات في "منصة خرائط Google":

1. افتح صفحة "منصة خرائط Google" في Cloud Console:

   الانتقال إلى صفحة "منصة خرائط Google"

2. في القائمة اليمنى، انقر على واجهات برمجة التطبيقات والخدمات.

صفحة "مقاييس خرائط Google"

تعرض صفحة المقاييس في "خرائط Google" ثلاثة رسوم بيانية: عدد الزيارات والأخطاء ومتوسط وقت الاستجابة. يمكن تجميع بيانات الاستخدام في الرسوم البيانية حسب فئة رمز الاستجابة وواجهة برمجة التطبيقات وطريقة واجهة برمجة التطبيقات والمستندات المُعتمَدة والمنصّة والنطاق.

أسفل الرسومات البيانية، تتضمّن صفحة المقاييس جدولاً لواجهات برمجة التطبيقات يعرض الطلبات والأخطاء ووقت الاستجابة لواجهات برمجة التطبيقات التي اخترتها.

باستخدام القائمة المنسدلة لواجهة برمجة التطبيقات في أعلى الصفحة وخيارات التجميع والفلترة في اللوحة اليمنى، يمكنك تجميع مقاييس الاستخدام المعروضة وفلترتها من خلال اختيار واجهات برمجة تطبيقات محدّدة أو متعددة، وبيانات الاعتماد، وفئات رموز الاستجابة، ونوع المنصة و/أو النطاق. يمكنك أيضًا اختيار فترة زمنية (من ساعة واحدة إلى آخر 30 يومًا) ودرجة الدقة (في الثانية أو اليوم) لمقاييس الاستخدام المعروضة.

تعرض الصور التالية فلاتر النظام الأساسي والنطاق لواجهة برمجة تطبيقات واحدة عند التجميع حسب النظام الأساسي والنطاق في القائمة المنسدلة التجميع حسب:

للوصول إلى صفحة "مقاييس Google Maps Platform API":

1. افتح صفحة "منصة خرائط Google" في Cloud Console:

   الانتقال إلى صفحة "منصة خرائط Google"

2. في القائمة اليمنى، انقر على المقاييس.

إعداد تقارير بيانات الاعتماد

يمكنك فلترة المقاييس وتجميعها حسب بيانات الاعتماد التي تم استخدامها لتحميل واجهة برمجة التطبيقات.

الرسوم البيانية لرموز الاستجابة

يقسّم الرسمان البيانيان عدد الزيارات حسب رمز الاستجابة وعدد الأخطاء حسب رمز الاستجابة استخدام الموقع الإلكتروني حسب فئة رمز استجابة HTTP. يعرض هذا الجدول التعيين بين حالة استجابة واجهة برمجة التطبيقات في "منصّة خرائط Google" وفئة رمز استجابة HTTP:

لمزيد من المعلومات حول رموز الحالة ورسائل الخطأ، اطّلِع على مستندات ردّ واجهة برمجة التطبيقات التي تهمّك (على سبيل المثال، ردود الترميز الجغرافي أو ردود التوجيهات).

مَعلمة حلول "منصة خرائط Google"

توفّر "منصّة خرائط Google" العديد من أنواع الرموز البرمجية النموذجية لمساعدتك في بدء استخدامها بسرعة. على سبيل المثال، يمكنك استخدام أداة الإنشاء السريع في Cloud Console، واتّباع أدلة التنفيذ الخاصة بحلول المجال، والاستفادة من codelabs.

لفهم الاستخدام وطُرق تحسين حلولنا، تُدرِج Google solution_channelمَعلمة طلب البحث في طلبات بيانات واجهة برمجة التطبيقات لجمع معلومات عن استخدام نموذج الرمز البرمجي:

• يتم تضمين مَعلمة طلب البحث solution_channel تلقائيًا في رمز نموذج الحلّ.
• تعرض مَعلمة طلب البحث إحصاءات عن اعتماد الحلّ إلى Google لتحسين جودة الحلّ في الإصدارات المستقبلية.
• يمكنك إيقاف هذه الميزة من خلال حذف مَعلمة طلب البحث solution_channel وقيمتها من رمز النموذج.
• ولا يُشترط الاحتفاظ بالمَعلمة. ولا تؤثّر إزالة مَعلمة طلب البحث في الأداء.
• لا تُستخدَم مَعلمة طلب البحث إلا لإعداد تقارير عن استخدام نماذج الرموز البرمجية.
• تكون مَعلمة الطلب منفصلة عن أيّ إحصاءات و تقارير خاصة بواجهة برمجة التطبيقات. وهذا يعني أنّ إزالة المَعلمة من رمز نموذج الحلّ لا يؤدي إلى إيقاف إعداد تقارير واجهة برمجة التطبيقات JavaScript لخرائط Google الداخلية.

تقارير الحصص

تضع الحصص حدودًا لعدد الطلبات التي يمكن لمشروعك إرسالها إلى واجهتَي برمجة التطبيقات Google Maps Platform API. يمكن الحد من الطلبات بثلاث طرق: في اليوم، وفي الدقيقة، وفي الدقيقة لكل مستخدم. لا يتم احتساب سوى الطلبات الناجحة والطلبات التي تؤدي إلى أخطاء في الخادم ضمن الحصة. لا يتم احتساب الطلبات التي تتعذّر فيها المصادقة ضمن الحصة.

يتم عرض استخدام الحصة في الرسوم البيانية في صفحة الحصص في Cloud Console، ويمكن تجميعها في طلبات في الدقيقة. يتم عرض حدود الحصة الحالية لواجهات برمجة التطبيقات المحدّدة في الجداول أسفل الرسوم البيانية لاستخدام الحصة.

للحصول على قيمة الحصة لكل دقيقة لأي منتج من منتجات واجهة برمجة التطبيقات في "منصّة Google للتسويق"، استخدِم الحاسبة هذه.

صفحة "الحصص" في "خرائط Google"

تعرِض صفحة الحصص في "خرائط Google" حدود الحصة واستهلاك الحصة لواجهة برمجة التطبيقات المحدّدة التي اخترتها.

يعرض الرسم البياني لاستخدام الحصة في Google Cloud Console إجمالي عدد الزيارات لمفاتيح واجهة برمجة التطبيقات ومعرّفات العملاء. تتوفّر أيضًا زيارات معرّف العميل في رسوم بيانية المقاييس على Cloud Console.

لا تعرض الصفحة سوى الطلبات التي تستهلك الحصة: الطلبات الناجحة (OK ZERO_RESULTS، DATA_NOT_AVAILABLE) والطلبات التي تتسبب في أخطاء الخادم (NOT_FOUND، INVALID_REQUEST/INVALID_VALUE (قيمة المَعلمة غير صالحة)، UNKNOWN_ERROR).

إنّ الطلبات التي تؤدي إلى أخطاء في العميل، مثل أخطاء المصادقة والتفويض وأخطاء الوسيطة غير الصالحة (REQUEST_DENIED وOVER_QUERY_LIMIT وINVALID_REQUEST (مَعلمة غير صالحة، خطأ في تحليل الطلب)) ، لا تستهلك الحصة ولا يتم عرضها.

وحدة الحصة هي طلب لمعظم واجهات برمجة تطبيقات "منصّة خرائط Google" (Maps Static API وStreet View Static API وGeocoding API وDirections API وPlaces API وTime Zone API وGeolocation API وElevation API)، ولكن هناك بعض الاستثناءات:

• بالنسبة إلى Distance Matrix API، تكون وحدة الحصة عنصرًا يمثّل زوجًا من نقطة الانطلاق والوجهة.
• بالنسبة إلى واجهة برمجة التطبيقات Maps JavaScript API، تكون وحدة الحصة هي تحميل خريطة.
• بالنسبة إلى حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل Android وحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل iOS، تكون وحدة الحصة هي طلب "التجوّل الافتراضي" أو تحميل panorama. تتوفّر عمليات تحميل الخرائط بدون أي رسوم ولا تستهلك الحصة.

للوصول إلى صفحة "حصص "منصة خرائط Google":

1. افتح صفحة "منصة خرائط Google" في Cloud Console:

   الانتقال إلى صفحة "منصة خرائط Google"

2. في القائمة اليمنى، انقر على الحصص.
3. اختَر واجهة برمجة تطبيقات من القائمة المنسدلة لواجهات برمجة التطبيقات.

وحدات الحصة

يعرض هذا الجدول وحدة الحصة لواجهات برمجة تطبيقات Google Maps Platform.

تقارير الفوترة

عرض تقرير الفوترة

تتوفّر تقارير الفوترة لاستخدامك لمنتجات "منصّة خرائط Google" في Google Cloud Console. لمزيد من المعلومات، يُرجى الاطّلاع على الفوترة.

للوصول إلى تقارير الفوترة:

1. افتح صفحة "أداة اختيار المشاريع" في Cloud Console:

   صفحة أداة اختيار المشاريع

2. اختَر مشروعًا.
3. انقر على زر القائمة ثم اختَر الفوترة.
4. إذا كان لديك حسابات فوترة متعددة، اختَر الانتقال إلى حساب الفوترة المرتبط لفتح صفحة نظرة عامة لحساب الفوترة المرتبط.
5. في القائمة اليمنى، انقر على التقارير لفتح صفحة تقارير الفوترة لحساب الفوترة المرتبط.

كيفية قراءة الرسم البياني لتقرير الفوترة

ترسم تقارير الفوترة التكلفة بمرور الوقت كرسم بياني خطي مجمّع. تعرِض طريقة الاطّلاع التلقائية التكاليف اليومية المتعلّقة بالاستخدام في الشهر الحالي مجمّعة حسب المشروع (لجميع المنتجات)، بما في ذلك أي أرصدة مرتبطة بالاستخدام تم تطبيقها، بالإضافة إلى التكلفة الإجمالية المتوقّعة للشهر الحالي بأكمله. يتطابق كل خط في الرسم البياني (والصف في الجدول التلخيصي) مع المشروع، ويُرتَّب من الأكبر إلى الأصغر حسب التكلفة. مزيد من المعلومات حول تفسير الرسم البياني لتقرير الفوترة

نصيحة: تحليل الاستخدام والتكلفة لكل رمز تخزين تعريفي

لفهم تفاصيل نموذج الدفع حسب الاستخدام ومعرفة أثره في عملية التنفيذ بدقة أكبر، اطّلِع على معدّل الاستخدام والتكلفة حسب رمز التخزين التعريفي.

لتغيير طريقة عرض التقرير لعرض عناصر السلع حسب رمز التخزين التعريفي:

1. في اللوحة على يسار الرسم البياني، وسِّع فلتر التجميع حسب.
2. اختَر رمز التخزين التعريفي.

تشمل فلاتر تقارير الفوترة الأخرى المتاحة النطاق الزمني والمشاريع والمنتجات ورموز التخزين التعريفية والمواقع الجغرافية التي تتيح لك الفلترة حسب مكان عرض طلبات البيانات من واجهة برمجة التطبيقات.

لتصنيف مصدر استخدامك بالإضافة إلى المنتج، يمكنك تجميع تقارير الفوترة حسب إحدى القيم المدرَجة. المفاتيح الثلاثة المرتبطة بواجهات برمجة تطبيقات Google Maps Platform هي goog-maps-api-key-suffix (الأحرف الأربعة الأخيرة من مفتاح واجهة برمجة التطبيقات) وgoog-maps-platform-type (النظام الأساسي: Android أو iOS أو JavaScript أو خدمة ويب) وgoog-maps-channel (قيمة قناة برمجية محددة من طلب بحث واجهة برمجة التطبيقات). مزيد من المعلومات حول الفلترة والتجميع

يمكنك تغيير طريقة عرض الرسم البياني لاستبعاد الأرصدة الخاصة بالاستخدام من خلال محو علامة المربّع بجانب تضمين الأرصدة في التكلفة في اللوحة اليمنى.

مراقبة الاستهلاك والحد منه

لمساعدتك في تخطيط ميزانيتك والتحكّم في التكاليف، يمكنك إجراء ما يلي:

• ضبط تنبيه بشأن الميزانية، لتتبُّع معدّل زيادة إنفاقك باتجاه مبلغ معيّن لا يؤدي ضبط ميزانية إلى وضع حد أقصى لاستخدام واجهة برمجة التطبيقات، بل يُرسِل إليك تنبيهًا فقط عندما يقترب مبلغ إنفاقك من المبلغ المحدّد.

• حدِّد الحد الأقصى لاستخدامك اليومي لواجهات برمجة التطبيقات، لإدارة تكلفة استخدام واجهات برمجة التطبيقات القابلة للفوترة. من خلال ضبط حدود الطلبات في اليوم، يمكنك الحدّ من إنفاقك. استخدِم معادلة بسيطة لتحديد الحدّ الأقصى اليومي استنادًا إلى المبلغ الذي تريد إنفاقه. على سبيل المثال: (الإنفاق الشهري /السعر لكل رمز تخزين تعريفي)/30 = الحد الأقصى للطلبات في اليوم (لواجهة برمجة تطبيقات واحدة).

تتبُّع الاستخدام لكل قناة

لتتبُّع استخدامك من خلال القنوات الرقمية، يجب إضافة المَعلمة "channel" إلى طلبات واجهة برمجة التطبيقات. القيم الوحيدة المقبولة للقناة هي الأرقام من 0 إلى 999. وفي ما يلي بعض الأمثلة على ذلك:

• واجهة برمجة التطبيقات لخدمة الويب "ترميز المواقع الجغرافية"

  https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY&channel=1

• Maps JavaScript API

  <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap"
  async defer></script>

يمكنك مراقبة استخدام قناتك مباشرةً في "تقرير الفوترة". ستظهر القنوات ضمن التصنيفات كمفتاح goog-maps-channel.

فلترة تقرير الفوترة حسب رمز التخزين التعريفي والقناة

1. استخدِم فلتر التجميع حسب رمز التخزين التعريفي.
2. انقر على علامة التصنيفات.
3. اختَر القائمة المنسدلة المفتاح، ثمّ اختَر goog-maps-channel.
4. اختَر القائمة المنسدلة القيمة واختَر القنوات الرقمية التي تريد فلترتها.

يمكنك التجميع حسب مفتاح التصنيف goog-maps-channel للاطّلاع على التكلفة التي تمّ إنشاؤها من خلال كلّ قناة.

بعد تنفيذ بيانات استخدام القناة في طلباتك، قد يكون هناك تأخير قصير (يصل إلى 24 ساعة) قبل أن تظهر البيانات في تقرير الفوترة.

تصدير بيانات الفوترة باستخدام BigQuery

يمكنك أيضًا تصدير بيانات الفوترة إلى BigQuery.

من خلال أداة BigQuery Export، يمكنك تصدير بيانات تفصيلية لفواتير Cloud (مثل بيانات الاستخدام والتكاليف المقدّرة) تلقائيًا على مدار اليوم إلى مجموعة بيانات BigQuery التي تحدِّدها. بعد ذلك، يمكنك الوصول إلى بيانات الفوترة من BigQuery لإجراء تحليل تفصيلي. ويمنحك ذلك مستوى إضافيًا من الدقة في فهم مصدر استخدامك لخدمة "منصة خرائط Google".

إذا كنت تريد البدء في عمليات تصدير BigQuery وطلبات البحث عن البيانات، يمكنك تجربة نموذج طلب البحث أدناه. قبل تنفيذ هذا الطلب، عليك إجراء ما يلي:

• فعِّل الفوترة و تصدير الفوترة في BigQuery في حسابك.
• تنسيق الجدول هو PROJECT_ID.DATASET_NAME.gcp_billing_exportv1BILLING_ACCOUNT_ID حيث:
• PROJECT_ID هو معرّف مشروعك الفعلي (مثلاً "my-project-123456").
• DATASET_NAME هو اسم مجموعة البيانات التي أنشأتها (مثل "SampleDataSet").
• BILLING_ACCOUNT_ID هو مرجع لـ "معرّف حساب الفوترة"، مع البادئة "gcp_billing_exportv1"، وتغيير الشُرطات (-) إلى الخطوط السفلية (_). على سبيل المثال، سيُصبح معرّف حساب الفوترة 123456-7890AB-CDEF01 هو gcp_billing_export_v1_123456_789AB_CDEF01.

  #standardSQL
  SELECT   Date(usage_start_time, "America/Los_Angeles") AS billing_day,
           invoice.month                                 AS invoice_month,
           service.description                           AS service,
           sku.description                               AS sku,
           (
                  SELECT l.value
                  FROM   Unnest(labels) AS l
                  WHERE  l.KEY = 'goog-maps-channel' ) AS goog_maps_channel,
           Round(Sum(usage.amount), 2)                 AS usage_amount,
           usage.unit                                  AS usage_unit,
           Round(Sum(cost), 2)                         AS cost,
           cost_type,
           currency
  FROM     PROJECT_ID.DATASET_NAME.gcp_billing_export_v1_BILLING_ACCOUNT_ID
  WHERE    invoice.month = '202002' -- Change the invoice month with the same format as the example.
  GROUP BY billing_day,
           invoice_month,
           service,
           sku,
           goog_maps_channel,
           usage_unit,
           cost_type,
           currency
  ORDER BY billing_day,
           service,
           sku
  

مراجع ذات صلة

الفوترة في السحابة الإلكترونية:

• إنشاء حساب على Cloud Billing أو تعديله أو إغلاقه
• تعديل إعدادات الفوترة لمشروع
• الاطّلاع على تقارير الفوترة ومؤشرات التكاليف
• ضبط الميزانيات وتنبيهات الميزانية
• وضع حدود لاستخدام واجهة برمجة التطبيقات

• الفوترة في "منصة خرائط Google"
• دليل التحسين
• أفضل الممارسات المتعلّقة بمفتاح واجهة برمجة التطبيقات

حالة الردّ والتقارير

يعرض الجدول التالي التعيين بين حالة واجهة برمجة التطبيقات لخرائط Google ورمز استجابة HTTP المعروض في استجابات واجهة برمجة التطبيقات لخرائط Google وفئة رمز استجابة HTTP في تقرير "الاستخدام"، ويشير إلى ما إذا كان الطلب المقابل يظهر في تقارير "الاستخدام" و"الحصة" و"الفوترة".

يقدّم تقرير "الاستخدام" في مقاييس "منصّة خرائط Google" HTTP response code class مستوى دقة. إذا كنت بحاجة إلى مستوى أعلى من الدقّة، اطّلِع على رموز حالة الاستجابة المتوفّرة في مراقبة استخدام "منصة خرائط Google".

تقارير التفاعل

إحصاءات النشاط التجاري

تقدّم لك "منصّة خرائط Google" إحصاءات عن كيفية تفاعل المستخدمين مع خرائطك. وتشمل هذه الإحصاءات مقاييس التفاعل الرئيسية، مثل عدد المشاهدات على الخريطة أو التفاعلات مع نقطة الاهتمام. يمكنك تحليل هذه الإحصاءات للتعرّف على المواقع الجغرافية الرائجة للإعلان والتسويق أو لتحسين تجربة المستخدِم.

تشمل إمكانات إعداد تقارير "معلومات مفيدة للنشاط التجاري" ما يلي:

• عرض نبذة عن إحصاءات النشاط التجاري على مستوى عالٍ للاطّلاع على المؤشرات الرئيسية في إحصاءات النشاط التجاري بنظرة سريعة
• التوغّل في التفاصيل لتحليل مقياس معيّن ضمن وحدة التحكّم للتعمّق في فهم المقاييس بمزيد من التفاصيل
• تصدير المقاييس إلى ملف CSV حتى تتمكّن من تحليل بيانات إحصاءات النشاط التجاري في أداة تحليل النشاط التجاري المفضّلة لديك

تشمل مقاييس التفاعل المتاحة ما يلي:

• مرّات المشاهدة على الخريطة: يمكنك تتبُّع المشاهدات على الخريطة الناتجة عن عمليات التدوير أو التكبير أو التصغير. يتم احتساب عدد مشاهدات الخريطة حسب الرمز البريدي أسبوعيًا (من الأحد إلى السبت بتوقيت المحيط الهادئ). يتم إصدار البيانات الجديدة أسبوعيًا في أول يوم أربعاء بعد فترة المراقبة.

يمكن لمالكي المشاريع والمستخدمين الذين لديهم دور مُشاهد إحصاءات "خرائط Google" الاطّلاع على إحصاءات النشاط التجاري في صفحة المقاييس في Cloud Console. يجب أن يكون Maps JavaScript API مفعّلاً في المشروع.

يمكنك تحليل مقاييس التفاعل مباشرةً في وحدة التحكّم باستخدام ميزتَي "الفلترة" و"التجميع حسب" للتوغّل في المقاييس بمزيد من التفاصيل. على سبيل المثال، يمكنك اختيار الفلترة حسب منطقة معيّنة لمعرفة مدى رواج مشاهدات الخريطة للرموز البريدية في تلك المنطقة فقط. من ناحية أخرى، قد تريد التجميع حسب منطقة معيّنة لتجميع التفاعلات داخل تلك المنطقة.

يمكن للمستخدمين تصدير مجموعة البيانات بالكامل أو عرض مفلتَر إلى ملف CSV لإجراء تحليل إضافي في أداة تحليل النشاط التجاري المفضّلة لديك. يمكنك تنزيل بيانات تصل إلى 90 يومًا في المرة الواحدة، وسيتم اقتطاع عمليات التنزيل التي تزيد عن 60 ألف خلية. قد يستغرق تصدير بيانات مشاهدات الخريطة إلى ملف CSV بضع دقائق استنادًا إلى النطاق الزمني المحدّد.

يتم إخفاء هوية مستخدمي مقاييس إحصاءات الأنشطة التجارية، وبالتالي لا تعكس هذه المقاييس سوى المؤشرات العامة للتفاعل مع خرائطك. قد يتم تقريب الأعداد المنخفضة إلى الصفر، وقد يتم تقليل المساهمات من القيم الشاذة.

يمكنك التحكّم في الوصول إلى إحصاءات النشاط التجاري لمشروعك على Cloud في Google Cloud Console باستخدام إذن "إحصاءات خرائط Google". يحصل مالكو المشاريع على هذا الإذن تلقائيًا ويمكنهم منح إذن الوصول إلى المستخدمين الآخرين حسب الحاجة.

يجب عدم استخدام إحصاءات النشاط التجاري لتقدير تكاليف الاستخدام. يُرجى الرجوع إلى تقارير الاستخدام للحصول على مزيد من المعلومات عن الاستخدام.