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

يُنشئ الإصدار 1 من Google Analytics Data API تقارير لمواقع إحصاءات 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 لعرض رقم تعريف الموقع.