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

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

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