يقدّم هذا المستند نظرة عامة عالية المستوى على الإصدار 3.0 من Core Reporting API في "إحصاءات Google". للحصول على مرجع مفصّل لواجهة برمجة التطبيقات، يمكنك الاطّلاع على الدليل المرجعي.
مقدمة
تمنحك واجهة برمجة التطبيقات لإعداد التقارير الأساسية في "إحصاءات Google" إمكانية الوصول إلى معظم بيانات التقارير في "إحصاءات Google". من خلال واجهة برمجة التطبيقات الأساسية لإعداد التقارير، يمكنك إجراء ما يلي:
- إنشاء لوحات بيانات مخصّصة لعرض بيانات "إحصاءات Google"
- وفِّر الوقت من خلال التشغيل الآلي لمهام إعداد التقارير المعقدة.
- دمج بياناتك في "إحصاءات Google" مع تطبيقات أنشطة تجارية أخرى
اختيار إصدار
أطلقنا مؤخرًا إصدارًا جديدًا من Core Reporting API.
- هل تقوم بإنشاء تطبيق جديد؟ – ننصحك باستخدام أحدث إصدار من 3.0.
- هل تستخدم الإصدار 2.3 القديم؟ – اقرأ دليل نقل البيانات للاطّلاع على التفاصيل حول كيفية تحديث تطبيقك لاستخدام الإصدار الجديد.
البدء
هل تريد أن تبدأ على الفور؟ يمكنك قراءة الدليل التعليمي لواجهة برمجة تطبيقات Hello Analytics.
يجب أن يمرّ كل تطبيق يستخدم واجهة برمجة التطبيقات ببضع خطوات للتسجيل وتفويض المستخدم والعمل باستخدام واجهة برمجة التطبيقات. سيرشدك هذا الدليل التعليمي في كل خطوة، وفي النهاية ستحصل على تطبيق يعمل يمكنك تخصيصه.
نظرة عامة على المفاهيم
تعرض واجهة برمجة التطبيقات الأساسية لإعداد التقارير بيانات التقارير التي تتكون من إحصاءات مستمدة من البيانات التي يجمعها رمز تتبُّع "إحصاءات Google". يتم تنظيم كل تقرير كسمات ومقاييس. يمكنك استخدام Core Reporting API لطلب البحث عن السمات والمقاييس لإنشاء تقارير مخصّصة.
هناك 3 مفاهيم أساسية تستند إليها Core Reporting API:
- طريقة ارتباط التقارير بالمستخدمين والمشاهدات (الملفات الشخصية).
- بنية التقرير وكيفية إنشاء الاستعلامات
- التعامل مع استجابة واجهة برمجة التطبيقات
التقارير والمستخدمون والمشاهدات (الملفات الشخصية)
لطلب بيانات التقارير لأحد المستخدمين، يجب أن يحدّد تطبيقك المستخدم وتحديد ملف شخصي (ملف شخصي) يمكن استرداد البيانات له. يتم تحديد هوية المستخدم من خلال الحصول على بيانات اعتماد التفويض وتمريرها في كل طلب من طلبات البيانات من واجهة برمجة التطبيقات. الملف الشخصي (الملف الشخصي) هو جزء من المخطط الهرمي للإعدادات في "إحصاءات Google" ويتم تحديده من خلال رقم تعريف الملف الشخصي.
هناك طريقتان للعثور على رقم تعريف ملفك الشخصي.
- يمكن أن يستخدم تطبيقك واجهة برمجة تطبيقات الإدارة لاجتياز التدرّج الهرمي للإعدادات للإدارة من أجل الحصول على رقم تعريف ملف شخصي.
- عنوان URL لكل تقرير في "إحصاءات Google"
لقطة شاشة
- في إحصاءات Google، انقر على
المشرف في شريط القوائم. اختر الحساب والموقع الذي
ينتمي إليه الملف الشخصي. في عمود الملف الشخصي، انقر على إعدادات الملف الشخصي
للحصول على رقم تعريف الملف الشخصي.
لقطة شاشة
طلب البحث عن السمات والمقاييس
يمكنك إجراء طلب بحث في واجهة برمجة التطبيقات لبيانات تقارير "إحصاءات Google"، والتي تتكوّن من سمات ومقاييس. المقاييس هي المقاييس الفردية لنشاط المستخدم على موقعك، مثل الجلسات ومرات مشاهدة الصفحة. وتُفصّل السمات المقاييس حسب بعض المعايير الشائعة، مثل البلد أو المتصفح. عند إنشاء طلب بحث، يمكنك تحديد السمات والمقاييس التي تريدها في بيانات تقريرك.
يمكنك استخدام الدليل المرجعي للمقاييس والسمات التفاعلي لاستكشاف جميع السمات والمقاييس المعروضة من خلال واجهة برمجة التطبيقات. يمكنك أيضًا الاطّلاع على الدليل المرجعي لواجهة برمجة التطبيقات الأساسية لمعرفة كيفية تحديد السمات والمقاييس في طلب بحث متعلق بواجهة برمجة التطبيقات.
العمل مع التقارير
البيانات التي يتم عرضها من خلال واجهة برمجة التطبيقات يمكن اعتبارها جدولًا يحتوي على عنوان وقائمة من الصفوف. وتتألف كل استجابة من واجهة برمجة التطبيقات من عنوان يصف اسم كل عمود ونوع بياناته. تحتوي الاستجابة أيضًا على قائمة بالصفوف، حيث يكون كل صف هو قائمة بالخلايا التي تحتوي على بيانات بالترتيب نفسه الذي يتضمّن العناوين. ويمكنك استخدام المعلومات الواردة في العنوان لتحديد نوع البيانات في كل خلية.
للحصول على مزيد من المعلومات حول ردّ واجهة برمجة التطبيقات، يمكنك الاطّلاع على الدليل المرجعي لواجهة برمجة التطبيقات الأساسية.
سياسات الحصص والإيقاف
تعالج واجهة برمجة تطبيقات Google Analytics ملايين العمليات. لحماية النظام من تلقي عمليات أكثر مما يمكنه التعامل معه، ولضمان التوزيع العادل لموارد النظام، من الضروري استخدام نظام حصص. يمكنك قراءة دليل الحدود القصوى والحصص لمعرفة حدود معيّنة.
لمعرفة تفاصيل عن كيفية التعامل مع التغييرات في أعمدة Core Reporting API (أي السمات والمقاييس)، يُرجى الاطّلاع على سياسة إيقاف البيانات نهائيًا. لمعرفة كيفية استخدام Metadata API للتحقق من الأعمدة التي تم إيقافها نهائيًا، يُرجى الاطّلاع على دليل Dev API للبيانات الوصفية.
الخطوات التالية
الآن، بعد أن فهمت طريقة عمل واجهة برمجة التطبيقات، سنقدّم لك مجموعة من المراجع لمساعدتك في البدء:
- يمكنك قراءة دليل المطوّر للتعرّف على كيفية استخدام واجهة برمجة التطبيقات.
- استخدِم أداة مستكشف طلبات البحث التفاعلية لإنشاء طلبات بحث بشكل مرئي وعرض الرد من خلال واجهة برمجة التطبيقات.
- اطّلِع على مقالة طلبات البحث الشائعة التي تتضمّن العديد من طلبات البحث الأكثر شيوعًا حول واجهة برمجة التطبيقات الأساسية لإعداد التقارير.
- يمكنك الرجوع إلى مرجع السمات والمقاييس للاطّلاع على قائمة بجميع البيانات المتاحة من خلال واجهة برمجة التطبيقات.
- يمكنك مراجعة صفحة المكتبات والنماذج للاطّلاع على قائمة بجميع مكتبات العملاء المتاحة التي يمكن استخدامها مع واجهة برمجة التطبيقات هذه.