يُنشئ الإصدار 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" أنواعًا متعدّدة من المواقع. لاستخدام Data API، يجب أن يكون الموقع موقعًا على "إحصاءات Google"، وليس على Universal Analytics. Universal Analytics هو إصدار قديم من "إحصاءات Google" ولا يتوافق مع Data API.
لتحديد معرّف موقع على "إحصاءات Google":
- انتقِل إلى "إحصاءات Google" على الرابط https://analytics.google.com/.
- اختَر "المشرف".
- اختَر الموقع.
- اختَر "إعدادات الموقع".
إذا كانت إعدادات الموقع تعرض "رقم تعريف الموقع" مثل "123..."، هذا هو رقم التعريف الرقمي لموقعك على "إحصاءات Google".
Firebase
إذا ربطت "إحصاءات Google" بمنصّة Firebase، ستظهر لك بيانات الإحصاءات لمشروعك في Firebase. لمزيد من المعلومات عن الربط، اطّلِع على مقالة ربط "إحصاءات Google" بمنصّة Firebase.
لتحديد موقع "إحصاءات Google" لمشروع Firebase:
- انتقِل إلى وحدة تحكُّم Firebase على الرابط https://console.firebase.google.com/.
- اختَر مشروعك.
- اختَر "إعدادات المشروع".
- اختَر Integrations (عمليات الدمج).
- اختَر عملية دمج "إحصاءات Google".
ستعرض صفحة "دمج إحصاءات Google" "رقم تعريف الموقع"، مثل "123...". هذا هو المعرّف الرقمي لموقعك على "إحصاءات Google".
AdMob
إذا فعّلت مقاييس سلوك المستخدِمين و ربطت تطبيقاتك بمنصّة Firebase في AdMob، ستظهر لك مقاييس سلوك المستخدِمين في AdMob لتطبيقك.
لتحديد موقع "إحصاءات Google" لتطبيق AdMob:
- انتقِل إلى AdMob على https://apps.admob.com/.
- اختيار تطبيقك
- اختَر "نظرة عامة على التطبيق".
- اختَر "لوحة بيانات FIREBASE".
- اتّبِع تعليمات Firebase أعلاه بدءًا من "اختيار إعدادات المشروع".