سجلّ التغييرات الخاص بحزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل Android

توثّق هذه الصفحة أي تغييرات يتمّ إجراؤها على حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل Android. ننصحك بمراجعة هذه القائمة بشكل دوري للاطّلاع على أي إشعارات جديدة. يمكنك أيضًا الاشتراك في التغييرات من خلال الخلاصات المدرَجة ضمن القسم الاشتراك أدناه.

الاشتراك في سجلات التغييرات ذات الصلة

يتضمّن كل واجهات برمجة التطبيقات للجمع والضبط وإعداد التقارير.

يتضمن تتبع الويب (ga.js وanalytics.js)، وحزمة تطوير البرامج (SDK) لنظام التشغيل Android، وحزمة تطوير البرامج (SDK) لنظام التشغيل iOS، وMeasurement Protocol.

يحتوي هذا الإصدار على:

إحصاءات Google

  • تمت إضافة إمكانية الإرسال في الخلفية على الأجهزة غير التابعة لـ Google Play.
  • مُسجِّل/LogLevel في "إحصاءات Google" تم إيقافه نهائيًا وتستخدم "إحصاءات Google" الآن ميزة تسجيل الدخول إلى Android بدلاً من ذلك. لتفعيل تسجيل تصحيح الأخطاء، شغِّل adb shell setprop log.tag.GAv4 DEBUG.
  • إعادة البناء لتحسين تسليم البيانات وتحديد مصدر حملات التثبيت.
  • تم إصلاح خطأ تحليل الحملة. المشكلة 596:
  • ويتم الإبلاغ بشكل صحيح عن استثناءات التطبيقات غير المعالجة خلال الثواني الأولى من إعداد "إحصاءات Google". المشكلة 443.

إدارة العلامات من Google

  • لا توجد تغييرات.

يحتوي هذا الإصدار على:

إحصاءات Google

  • تمّت إضافة إمكانية استخدام التجارة الإلكترونية المحسَّنة. راجع دليل مطوّر برامج التجارة الإلكترونية المحسَّنة لمزيد من التفاصيل.
  • ستتم الآن إعادة ضبط معرِّف العميل في كل مرة يتم فيها تغيير المعرِّف الإعلاني.
  • تكون ميزة جمع المعرِّفات الإعلانية غير مفعَّلة تلقائيًا.
  • تمت إضافة واجهات برمجة التطبيقات الآلية لإعداد تقارير الاستثناءات.
  • تم إصلاح الأخطاء في المستندات.
  • إصلاح أخطاء بسيطة.

إدارة العلامات من Google

  • لا تغييرات في أداة "إدارة العلامات من Google".

"إحصاءات Google" و"إدارة العلامات من Google"

يحتوي هذا الإصدار على:

إحصاءات Google

  • لا تغييرات في "إحصاءات Google".

إدارة العلامات من Google

  • تم توفير دعم لماكرو تجارب المحتوى في "إحصاءات Google".

يحتوي هذا الإصدار على: * الإصدار التجريبي السادس. * يجب إجراء تغيير لتجنُّب أي استثناءات في وقت التشغيل عندما يستخدم تطبيق يستهدف الإصدار KitKat (المستوى 19 من واجهة برمجة التطبيقات) حزمة تطوير البرامج (SDK).

يحتوي هذا الإصدار على: * الإصدار الثاني من الإصدار 3.0. * يجب إجراء تغيير لتجنُّب أي استثناءات في وقت التشغيل عندما يستخدم تطبيق يستهدف الإصدار KitKat (المستوى 19 من واجهة برمجة التطبيقات) حزمة تطوير البرامج (SDK).

يحتوي هذا الإصدار على: * الإصدار الأول من الإصدار 3.0 * تمت إعادة صياغة واجهة برمجة التطبيقات لحزمة تطوير البرامج (SDK) للتوافق بشكلٍ أوثق مع analytics.js. لمزيد من التفاصيل، يمكنك الاطلاع على javadoc و /analytics/devguides/collection/android/v3/. * تمت إزالة جميع طرق track وsend. بدلاً من ذلك، يمكنك استخدام طريقة الإرسال وطرق الإنشاء المقابلة في الفئة MapBuilder لإرسال النتائج. اطّلِع على الفئة Fields للحصول على قائمة بالثوابت التي يمكنك استخدامها لإنشاء نتائج باستخدام set وsend. * تمت أيضًا إزالة العديد من الخصائص المتنوعة، بما في ذلك useHttps وanonymizeIp وما إلى ذلك. يمكنك ضبط هذه السمات أو إعادة ضبطها باستخدام الأمر set. * تم تمديد نطاق EasyTracker الآن إلى Tracker. ما مِن حاجة إلى الاتصال برقم EasyTracker.getTracker لإجراء مكالمات تتبُّع مباشرةً. * لم تعد حزمة SDK تضبط علامة التحكم في الجلسة للبدء عند بدء التشغيل. أصبح المطوّرون الآن مسؤولين عن تحديد ما إذا كانت هناك حاجة إلى جلسة جديدة. تجدر الإشارة إلى أنّ خدمة EasyTracker لا تزال تتعامل مع إدارة الجلسات على النحو المعتاد. * تتوافق حزمة تطوير البرامج (SDK) الآن مع فئة التسجيل المخصّصة. يمكنك الاطّلاع على Logger في javadoc للحصول على التفاصيل. * تمت إضافة وضع dryRun. * يمكن الآن قراءة clientId. ما عليك سوى الاتصال بالرقم tracker.get(Fields.CLIENT_ID). سيتم حظر هذه المكالمة إلى أن يتم تحميل "clientId" من المتجر الدائم. * ستتوقف حزمة تطوير البرامج (SDK) عن إعادة محاولة النتائج استنادًا إلى رمز استجابة HTTP.

يحتوي هذا الإصدار على: * الإصدار التجريبي الخامس. * إصلاح خطأ تحليل استثناء EasyTracker. عند ضبط علامة ga_reportUncaughtExceptions، لم نبدأ في إعداد محلّل الاستثناء، ونتيجةً لذلك لم يتم تحليل موقع استثناء غير مرصود. من خلال هذا الإصلاح، ستُبلِغ تقارير الأعطال والاستثناءات عن موقع الاستثناءات غير المرصودة عند ضبط ga_reportUncaughtExceptions على "صحيح".

يحتوي هذا الإصدار على: * الإصدار التجريبي الرابع. * ستلتزم حزمة تطوير البرامج (SDK) الآن بإعداد معدّل العينة. إذا سبق لك ضبط معدّل العيّنة على أكثر من 100%، ستلاحظ الآن انخفاضًا في بعض مقاييس "إحصاءات Google" مقارنةً بالإصدار التجريبي 3. * تم تغيير طرق الإرسال في المسار (على سبيل المثال، trackView يُطلق عليه الآن اسم sendView). * تمت إضافة إتاحة استخدام العملة المحلية عبر Transaction.setCurrencyCode * استخدام HTTPS بشكل تلقائي بدلاً من HTTP. * لن تحاول حزمة تطوير البرامج (SDK) إرسال النتائج إذا لم يكن هناك اتصال بالشبكة. * تجنَّب أخطاء ANR أثناء محاولة معالجة بيانات حملة عمليات التثبيت. * تمت إزالة صفَين (TrackedActivity) من حزمة تطوير البرامج (SDK). * نقل إعداد حزمة تطوير البرامج (SDK) إلى خارج سلسلة محادثات واجهة المستخدم الرئيسية * تحسين قدرة SDK على الاسترداد من قاعدة بيانات SQLite التالفة. * تم إصلاح العديد من الأعطال والأخطاء الأخرى.

يحتوي هذا الإصدار على:

  • إصلاحات الأخطاء:
    • إصلاح عملية نقل البيانات من السير الذاتية للإصدار 1.5 من حزمة SDK إلى 1.5 متغيّر مخصَّص لحزمة تطوير البرامج (SDK)
    • الالتزام بإعداد قيود بيانات الخلفية للمستخدم

يحتوي هذا الإصدار على:

  • إصلاحات الأخطاء:

    • إصلاح تسرُّب الذاكرة
    • تشمل الأحداث الآن آخر مشاهدة للصفحة على الويب يتم تتبّعها (utmp).
  • ميزات جديدة:

    • دعم 50 متغيرًا مخصّصًا (ملاحظة: تتوفّر هذه الميزة لمستخدمي "إحصاءات Google" Premium فقط).

يحتوي هذا الإصدار على:

  • تمت إضافة إتاحة السمات والمقاييس المخصّصة.
  • تمت إضافة دعم لتتبُّع التفاعل الاجتماعي.
  • تم جعل صف واحد (StandardExceptionParser) علنيًا
  • تم إصلاح الأعطال من حين لآخر أثناء إعداد حزمة تطوير البرامج (SDK).
  • تم إصلاح INSTALL_REFERRER عمليات بث يتم تجاهلها على بعض الأجهزة.
  • تم إصلاح ConcurrentModificationExceptions في صف واحد (GoogleTracker).
  • إصلاحات أخطاء وتحسينات أخرى

يحتوي هذا الإصدار على:

  • واجهة مبسطة EasyTracker
  • تم نقل التحكّم في الإرسال إلى صف جديد، وهو GAServiceManager.
  • تم تعديل الأسلاك إلى أحدث تنسيق.
  • تم تغيير دور "sampleRate" إلى مزدوج.
  • يتم تقييد التتبُّع المفرط.
  • ويتم حذف معلومات التتبُّع غير المُرسَلة عند تفعيل عملية الإيقاف.
  • وسيتم حذف معلومات التتبُّع غير المُرسَلة التي مرّ عليها أكثر من 30 يومًا.
  • إصلاح أخطاء وتحسينات أخرى

يحتوي هذا الإصدار على:

  • تمت إزالة طريقة startSession. يمكنك استخدام setStartSession كبديل.
  • تمت إضافة مَعلمة ga_sessionTimeout إلى EasyTracker.
  • تم تنفيذ وضع توفير الطاقة.
  • تمت إضافة الطريقة trackView إلى GAITracker والتي لا تحتوي على وسيطة.
  • تم إصلاح خطأ كان يمنع إرسال مَعلمات الاستثناء على النتائج.
  • ويتم تجاهل النتائج التي لا يمكن قراءتها من قاعدة البيانات بدلاً من حظر إرسال جميع النتائج نهائيًا.
  • تم تعديل الأسلاك إلى أحدث تنسيق.
  • نوع نتيجة التوقيت الذي تم تنفيذه.
  • أنواع نتائج التجارة الإلكترونية التي تم تنفيذها (المعاملات والعنصر).

يحتوي هذا الإصدار على:

  • التوثيق:

    • تم تعديل ملف ReadMe.txt للإشارة إلى الموقع الإلكتروني للاطّلاع على المستندات.

يحتوي هذا الإصدار على:

  • إصلاحات الأخطاء:
    • إصلاح معالجة التتبع التلقائي لعنوان URL المقصود من Google Play.
    • اسمح بترميز عنوان URL لمَعلمة المُحيل إلى setReferrer.

يحتوي هذا الإصدار على:

  • إصلاحات الأخطاء:
    • تم احتجاز عدة "SQLiteExceptions" والتعامل معها.
    • تم إصلاح NullPointerException في stopSession في حال الاتصال قبل الاتصال بـ startNewSession.
    • تم إصلاح أخطاء "نفاد الذاكرة" على أجهزة HTC Thunderbolt وMotoroid Bionic.
    • تم التخلص من الوصول غير الضروري إلى قاعدة البيانات في طريقة الإرسال.

يحتوي هذا الإصدار على:

  • إصلاحات الأخطاء:
    • تم إصلاح الخطأ في تتبُّع الإحالات العامة للحملة.
    • علامة anonymizeIp ثابتة تتداخل مع تتبع الحملة.

يحتوي هذا الإصدار على:

  • إصلاحات الأخطاء:
    • تم إصلاح العديد من المشكلات في معالجة قاعدة البيانات.
    • تم إصلاح الاستثناءات أثناء استخدام المتغيّرات المخصّصة.
    • الاحتفاظ بسياق التطبيق بدلاً من السياق الذي تم تمريره إليه.
    • تمت إزالة إمكانية إنشاء جلسات صور وهمية عن طريق الخطأ.
  • الميزات الجديدة:
    • تمت إضافة إمكانية تحديد إحالات الحملات في أي وقت
    • تمت إضافة علامة sampleRate.
    • تمت إضافة علامة anonymizeIp.

يحتوي هذا الإصدار على:

  • إصلاحات الأخطاء:

    • تم إصلاح سلسلة userAgent تم تنسيقها بشكل سيئ.
  • ميزات جديدة:

    • توفير إمكانية تتبُّع التجارة الإلكترونية
    • تمت إضافة علامة debug.
    • تمت إضافة علامة dryRun.

يحتوي هذا الإصدار على:

  • إصلاحات الأخطاء:

    • تم إصلاح الترميز غير الصحيح للمساحات.
    • لم يعد SQLiteExceptions يتسبب في تعطُّل التطبيقات.
  • ميزات جديدة:

    • تمت إضافة إمكانية استخدام المتغيّرات المخصّصة.