يوضِّح دليل نقل البيانات هذا الميزات الجديدة في الإصدار 2 من حزمة تطوير البرامج (SDK) ويقدِّم للمطوّرين نصائح حول نقل البيانات من الإصدار 1.x. يمكن للمطوّرين الذين لا يحتاجون إلى نقل البيانات من تنفيذ الإصدار 1.x بدء استخدام الإصدار 2 الآن.
مقدمة
طرحت خدمة "إحصاءات Google" مؤخرًا حزمة تطوير البرامج (SDK) المُحدّثة لخدمة "إحصاءات Google" لنظام التشغيل Android. يحتوي الإصدار 2 من حزمة SDK على دعم لميزات جديدة وواجهة إعداد تقارير جديدة مصمَّمة خصيصًا لمطوّري التطبيقات.
ننصح جميع المطوّرين الحاليين في "إحصاءات Google" بنقل بياناتهم إلى الإصدار الثاني من حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل Android للاستفادة من الميزات والتقارير الجديدة.
الميزات الجديدة في الإصدار 2
يقدّم الإصدار الثاني من حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل Android تجربة إعداد تقارير جديدة مصمّمة لمطوّري التطبيقات، بالإضافة إلى سمات ومقاييس جديدة وفعّالة، وغير ذلك الكثير. في ما يلي نظرة على الميزات التي سيحصل عليها المطوّرون عند استخدام الإصدار 2:
- تقارير أكثر فعالية لمطوّري التطبيقات
- تمت إعادة تصميم التقارير العادية لمطوّري التطبيقات، مع إضافة تقارير جديدة مثل تدفق التفاعل ومصادر Google Play لمساعدة المطوّرين في الحصول على إحصاءات جديدة حول اكتساب المستخدمين وتجربتهم. اطّلِع على أفضل ممارسات إعداد الحساب لمعرفة المزيد من المعلومات عن أفضل السبل لإعداد موقعك للإصدار 2.
- السمات والمقاييس الجديدة للتطبيق
- تم طرح سمات ومقاييس جديدة خاصة بالتطبيقات مع الإصدار 2 من حزمة تطوير البرامج (SDK)، بما في ذلك "اسم الشاشة" و"مرّات مشاهدة الصفحة في التطبيق" واسم التطبيق وإصدار التطبيق وغيرها.
- قياس الأعطال والاستثناءات
- تقدّم حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل Android قياس الاستثناءات ونوع نتيجة الاستثناء. باستخدام قياس الاستثناءات، يمكنك قياس عدد الأعطال والاستثناءات غير الفادحة ونوعها. للتعرّف على كيفية تنفيذ قياس الاستثناءات، راجِع دليل المطوّر حول الاستثناءات.
- السمات والمقاييس المخصّصة
- أنشئ سمات مخصّصة لتقسيم بياناتك بطرق جديدة. مزيد من المعلومات عن المقاييس والسمات المخصّصة
- قياس التفاعلات الاجتماعية
- احصل على إحصاءات جديدة حول قيمة الشبكات الاجتماعية في تطبيقك من خلال قياس تفاعلات المستخدمين باستخدام المكوّنات الإضافية والتطبيقات المصغّرة المضمّنة الاجتماعية. اطّلِع على مزيد من المعلومات عن قياس التفاعلات الاجتماعية.
قبل البدء
سيرغب جميع المطورين في اتخاذ هاتين الخطوتين قبل بدء عملية النقل:
- تنزيل حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل Android، الإصدار 2
- أنشئ ملفًّا شخصيًا للتطبيق ستستخدمه للوصول إلى بيانات وتقارير تطبيقك الجديدة.
بعد إكمال الخطوات أعلاه، اتّبِع الخطوات أدناه لمسار نقل بياناتك.
نقل البيانات من EasyTracker
هناك ثلاث خطوات ستحتاج إلى اتخاذها لنقل تطبيقك من الإصدار 1 إلى الإصدار 2 من مكتبة EasyTracker:
- تعديل المَعلمات في ملف موارد GoogleAnalytics.xml
- تعديل أسماء الطرق
- تعديل مستقبِل البث (تتبُّع "حملة Google Play")
1- تعديل المَعلمات في GoogleAnalytics.xml
عند الانتقال إلى الإصدار 2، حدِّث المعلمات في ملف موارد GoogleAnalytics.xml، نظرًا لأن بعضها قد تغير منذ أن تمت إضافة معلمات جديدة في الإصدار 2.
يعرض الجدول أدناه المعلّمات التي تم تعديلها في الإصدار 2:
| اسم المَعلمة v1.x | اسم المَعلمة v2.x |
|---|---|
| ga_api_key | ga_trackingId |
| ga_auto_activity_tracking | ga_autoActivityTracking |
| ga_dryRun | متوقفة نهائيًا |
لمعرفة المزيد، راجع معلمات EasyTracker الجديدة.
2. تعديل أسماء الطرق
على الرغم من أن الكثير من بناء الجملة يظل كما هو في الإصدار 2 من EasyTracker، إلا أن هناك بعض الاختلافات الملحوظة في أسماء الطرق وبناء الجملة والتي ستتطلب منك تحديث عملية التنفيذ:
- قيمة العمود "
trackPageView()" هيsendView()في الإصدار 2. لمزيد من المعلومات، يُرجى الاطّلاع على دليل المطوّر حول تتبُّع الشاشة. - تم تبسيط تنفيذ التجارة الإلكترونية. الاطّلاع على كيفية تنفيذ قياس التجارة الإلكترونية في الإصدار 2
- تم استبدال المتغيرات المخصّصة بالسمات والمقاييس المخصّصة. يجب تعديل أي مكالمات يتم إجراؤها إلى
setCustomVar()للاستفادة من الميزة الجديدة. تعرَّف على كيفية تنفيذ المقاييس والسمات المخصَّصة.
3- تعديل جهاز استقبال البث (تتبُّع حملة Google Play)
تجدر الإشارة إلى أنّ المطوّرين الذين نفّذوا تتبُّع حملات Google Play باستخدام الإصدار 1.x يجب أن يلاحظوا أنّ مسار الفئة للمستلِم قد تم تغييره. اطّلع على دليل تتبُّع حملات Google Play للحصول على مزيد من المعلومات.
نقل البيانات من تنفيذ مخصَّص
إذا لم تكن تستخدم مكتبة EasyTracker في الإصدار 1.x من حزمة SDK لخدمة "إحصاءات Google" لنظام التشغيل Android، نقترح عليك البدء في استخدام EasyTracker في الإصدار 2.
أصبحت مكتبة EasyTracker الآن مضمّنة في حزمة تطوير البرامج (SDK)، وينصح بها جميع المطورين. بدء استخدام EasyTracker في الإصدار الثاني من حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google".
إذا كانت لديك احتياجات متقدمة لجمع البيانات، مثل استخدام أرقام تعريف متعددة للمواقع في عملية تنفيذ واحدة، اطّلِع على دليل الإعداد المتقدّم لمعرفة المزيد من المعلومات عن استخدام الميزات المتقدّمة للإصدار 2.x من حزمة تطوير البرامج (SDK).