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

تُنشئ Google Analytics Data API الإصدار 1 تقارير لمواقع إحصاءات Google الخاصة. يجب أن تحدّد طلبات البيانات من واجهة برمجة التطبيقات معرّفًا رقميًا لموقع على "إحصاءات Google". تشير مستندات Data API ورمزها النموذجي إلى هذا المعرّف باسم GA_PROPERTY_ID.

الاستخدام

تتطلّب جميع طرق Data API تحديد معرّف موقع على "إحصاءات Google" ضِمن مسار طلب عنوان URL على شكل properties/GA_PROPERTY_ID، مثل:

  POST https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID:runReport

إذا كنت تستخدم إحدى مكتبات عملاء Data API، لن تحتاج إلى تعديل مسار عنوان URL للطلب يدويًا. توفّر معظم عملاء واجهة برمجة التطبيقات مَعلمة property تتوقّع سلسلة بالصيغة properties/GA_PROPERTY_ID. يمكنك الاطّلاع على دليل البدء السريع للحصول على أمثلة عن استخدام مكتبات العملاء.

ما هو رقم تعريف موقعي؟

يمكنك استخدام Data API إذا كنت قد أعددت تقارير الإحصاءات في أيّ من المنتَجين التاليَين:

إحصاءات Google

لتحديد معرّف موقع على "إحصاءات Google"، اتّبِع الخطوات التالية:

  1. انتقِل إلى "إحصاءات Google" على https://analytics.google.com/.
  2. انقر على "المشرف".
  3. انقر على الموقع.
  4. انقر على "إعدادات الموقع".

إذا كانت "إعدادات الموقع" تعرض "رقم تعريف الموقع" رقميًا، مثل "123..."، فهذا هو المعرّف الرقمي لموقعك على "إحصاءات Google".

Firebase

إذا ربطت "إحصاءات Google" بمنصّة Firebase، ستظهر لك بيانات الإحصاءات لمشروعك في Firebase. لمزيد من المعلومات عن الربط، يُرجى الاطّلاع على مقالة ربط "إحصاءات Google" بمنصّة Firebase.

لتحديد موقع "إحصاءات Google" لمشروع على Firebase، اتّبِع الخطوات التالية:

  1. انتقِل إلى وحدة تحكُّم Firebase على https://console.firebase.google.com/.
  2. اختَر مشروعك.
  3. انقر على "إعدادات المشروع".
  4. انقر على "عمليات الدمج".
  5. انقر على عملية دمج "إحصاءات Google".

ستعرض صفحة عملية دمج "إحصاءات Google" "رقم تعريف الموقع" رقميًا، مثل "123...". هذا هو المعرّف الرقمي لموقعك على "إحصاءات Google".

AdMob

إذا كنت تستخدم AdMob، يجب ربط تطبيقك بمنصّة Firebase لاستخدام "إحصاءات Google". للوصول إلى مقاييس سلوك المستخدمين ضِمن AdMob واستخدام Google Analytics Data API، يجب أن يتوفّر لديك ما يلي:

  1. ربط تطبيق يستخدم AdMob بمشروع Firebase.
  2. دمج حزمة تطوير البرامج (SDK) الخاصة بخدمة "إحصاءات Google لبرنامج Firebase" في تطبيقك
  3. تم تفعيل مقاييس سلوك المستخدمين لتطبيقك في AdMob.

هذه الخطوات مطلوبة لجمع مقاييس سلوك المستخدمين في AdMob و استكشاف هذه البيانات والعمل عليها باستخدام "إحصاءات Google" وData API.

للعثور على رقم تعريف موقع على "إحصاءات Google" المرتبط بتطبيق يستخدم AdMob:

  1. سجِّل الدخول إلى AdMob.
  2. اختَر تطبيقك من قائمة التطبيقات.
  3. في الشريط الجانبي، انقر على إعدادات التطبيق.
  4. في قسم Firebase ، من المفترض أن تظهر لك تفاصيل عن مشروع Firebase المرتبط. انقر على الرابط أو الزرّ المناسبَين للانتقال إلى وحدة تحكُّم Firebase.
    • مسار بديل: في بعض الأحيان، قد يتوفّر رابط يؤدي إلى لوحة بيانات Firebase على صفحة نظرة عامة على التطبيق.
  5. في وحدة تحكُّم Firebase، أنت تعرض المشروع المرتبط بتطبيق يستخدم AdMob. اتّبِع التعليمات الموضّحة في قسم Firebase للعثور على رقم تعريف الموقع:
    • انقر على إعدادات المشروع (رمز الترس بجانب "نظرة عامة على المشروع").
    • انتقِل إلى علامة التبويب عمليات الدمج.
    • انقر على عملية دمج إحصاءات Google لعرض رقم تعريف الموقع.