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

يُنشئ الإصدار 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":

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

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

ملاحظة: إذا كانت إعدادات الموقع تعرض "رقم تعريف التتبّع" مثل "UA-123...-1"، يعني ذلك أنّ هذا الموقع هو موقع على Universal Analytics، ولا يمكن إعداد تقارير عن بيانات "إحصاءات Google" لهذا الموقع في Data API. بالنسبة إلى هذا الموقع، يمكنك استخدام الإصدار 4 من Google Analytics Reporting API لإنشاء تقارير بيانات الإحصاءات.

Firebase

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

لتحديد موقع "إحصاءات Google" لمشروع Firebase:

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

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

AdMob

إذا فعّلت مقاييس سلوك المستخدِمين و ربطت تطبيقاتك بمنصّة Firebase في AdMob، ستظهر لك مقاييس سلوك المستخدِمين في AdMob لتطبيقك.

ملاحظة: في الوقت الحالي، يُعدّ ربط تطبيقك على AdMob بمنصّة Firebase وإضافة حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google لبرنامج Firebase" إلى تطبيقك إجراءً اختياريًا. ومع ذلك، مع التغييرات القادمة في جمع مقاييس سلوك المستخدِمين في أواخر عام 2023، سيكون من الضروري الربط بمنصّة Firebase وإضافة حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لجمع مقاييس سلوك المستخدِمين في AdMob واستكشاف هذه البيانات والعمل بها.

لتحديد موقع "إحصاءات Google" لتطبيق AdMob:

1. انتقِل إلى AdMob على https://apps.admob.com/.
2. اختيار تطبيقك
3. اختَر "نظرة عامة على التطبيق".
4. اختَر "لوحة بيانات FIREBASE".
5. اتّبِع تعليمات Firebase أعلاه بدءًا من "اختيار إعدادات المشروع".