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

يُنشئ الإصدار 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 للطلب يدويًا. توفّر معظم برامج API معلَمة property تتوقّع سلسلة بالتنسيق properties/GA_PROPERTY_ID. راجِع دليل البدء السريع للاطّلاع على أمثلة على استخدام مكتبات البرامج.

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

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

إحصاءات Google

تتضمّن "إحصاءات Google" أنواعًا متعدّدة من المواقع. لاستخدام Data API، يجب أن يكون الموقع موقعًا على "إحصاءات Google"، وليس موقعًا على Universal Analytics. ‫Universal Analytics هي إصدار قديم من "إحصاءات Google" ولا تتوافق مع Data API.

لتحديد رقم تعريف موقع على "إحصاءات 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 للاطّلاع على رقم تعريف الموقع.