يشرح دليل نقل البيانات هذا الميزات الجديدة في الإصدار 2 من حزمة تطوير البرامج (SDK) ويوفّر لمطوّري البرامج نصائح لنقل البيانات من عملية تنفيذ الإصدار 1.x. يمكن لمطوّري البرامج الذين لا يحتاجون إلى نقل البيانات من إصدار v1.x بدء استخدام الإصدار 2 الآن.
المقدمة
أصدرت "إحصاءات Google" مؤخرًا الإصدار الجديد من حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل Android. يتضمّن الإصدار 2 من حزمة تطوير البرامج (SDK) ميزات جديدة وواجهة جديدة لإعداد التقارير مصمّمة خصيصًا لمطوّري التطبيقات.
نقترح على جميع مطوّري برامج "إحصاءات Google" الحاليين نقل البيانات إلى الإصدار 2 من حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل Android للاستفادة من الميزات والتقارير الجديدة.
الميزات الجديدة في الإصدار 2
يقدّم الإصدار 2 من حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل Android تجربة إعداد تقارير جديدة مصمّمة لمطوّري التطبيقات، بالإضافة إلى مكوّنات ومقاييس جديدة وفعّالة وغيرها الكثير. في ما يلي نظرة عامة على الميزات التي يحصل عليها مطوّرو البرامج باستخدام الإصدار 2:
- تقارير أكثر فعالية لمطوّري التطبيقات
- تمت إعادة تصميم التقارير العادية لمطوّري التطبيقات، وإضافة تقارير جديدة، مثل "تدفق التفاعل" و"مصادر Google Play" لمساعدة مطوّري البرامج على الحصول على إحصاءات جديدة حول اكتساب المستخدمين وخبراتهم. ويمكنك الاطّلاع على أفضل الممارسات لضبط الحساب لمعرفة المزيد من المعلومات حول أفضل طريقة لضبط موقعك الإلكتروني للإصدار 2.
- سمات ومقاييس جديدة للتطبيقات
- تم تقديم مقاييس وسمات جديدة خاصة بالتطبيق مع الإصدار 2 من حزمة تطوير البرامج (SDK)، بما في ذلك اسم الصفحة ومرات مشاهدة الشاشة واسم التطبيق وإصدار التطبيق وغيرها الكثير.
- قياس الأعطال والاستثناءات
- توفّر حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل Android إمكانية قياس الاستثناءات ونوع نتيجة الاستثناء. باستخدام قياس الاستثناءات، يمكنك قياس عدد الأعطال والاستثناءات غير الفادحة ونوعها. للاطّلاع على كيفية تنفيذ قياس الاستثناءات، يمكنك مراجعة دليل مطوّري الاستثناءات.
- المكوّنات والمقاييس المخصصة
- أنشِئ سمات مخصّصة لتقسيم بياناتك بطرق جديدة. مزيد من المعلومات عن المقاييس والمكوّنات المخصّصة.
- قياس التفاعلات الاجتماعية
- يمكنك الحصول على إحصاءات جديدة حول قيمة الإجراءات الاجتماعية في تطبيقك من خلال قياس تفاعلات المستخدمين مع المكوّنات الإضافية والأدوات الاجتماعية المضمّنة. مزيد من المعلومات حول قياس التفاعلات الاجتماعية.
قبل البدء
على جميع مطوّري البرامج اتخاذ هاتين الخطوتين قبل بدء نقل البيانات:
- تنزيل حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google"، الإصدار 2 من Android
- أنشِئ ملفًا شخصيًا للتطبيق ستستخدمه للوصول إلى تقارير وبيانات التطبيق الجديدة.
بعد إكمال الخطوات المذكورة أعلاه، اتّبع الخطوات التالية لمسار النقل.
نقل البيانات من EasyTracker
هناك ثلاث خطوات تريد تنفيذها لنقل تطبيقك من الإصدار 1 إلى الإصدار 2 من مكتبة EasyTracker:
- تعديل المعلّمات في ملف مورد "إحصاءات Google".xml
- تعديل أسماء الطرق
- تعديل مستقبِل البث (تتبُّع حملات Google Play)
1- تعديل المعلّمات في "إحصاءات Google ".xml
وعند نقل البيانات إلى الإصدار 2، يمكنك تعديل المعلّمات في ملف مورد GoogleAnalytics.xml، حيث تم تغيير بعضها منذ إضافة الإصدار v1.x وإضافة المعلمات الجديدة في الإصدار 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 على الإصدار 2 من حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google".
إذا كانت لديك احتياجات مجموعات بيانات متقدمة، مثل استخدام معرّفات مواقع متعددة في عملية تنفيذ واحدة، اقرأ دليل الضبط المتقدم للحصول على مزيد من المعلومات عن استخدام الميزات المتقدمة للإصدار 2.x من حزمة تطوير البرامج (SDK).