يشرح هذا المستند مفاهيم مهمة حول استخدام المكوّن الإضافي لـ Google Analytics لـ Unity.
قبل البدء
قبل البدء، يُرجى التأكّد من إكمال الخطوات التالية:
- يجب أن يكون لديك موقع واحد على الأقل في "إحصاءات Google" وملف شخصي لإرسال البيانات من لعبتك إليهما.
- إذا كنت تريد تتبُّع معاملات التجارة الإلكترونية، عليك تفعيل التجارة الإلكترونية في تقاريرك.
- نزِّل googleanalyticsv3.unitypackage من المكوّن الإضافي "إحصاءات Google" لمستودع Unity واستورِده إلى مشروع Unity (من المفترض أن تتمكّن من إجراء ذلك من خلال النقر مرّتين على الملف).
عملية الإعداد والضبط
اختَر نظامًا أساسيًا لتفاصيل الضبط:
- إذا لم يكن مشروعك يحتوي على ملف باسم AndroidManifest.xml في دليل <YOUR PROJECT ROOT>/Assets/Plugins/Android/، أنشئ المشروع لنظام التشغيل Android ثم انسخ الملف AndroidManifest.xml من الدليل Temp/StagingArea/ (سيكون ضمن الدليل الذي اخترت إنشاءه). الصقه في <YOUR PROJECT ROOT>/Assets/Plugins/Android/.
- أضِف الأذونات التالية إلى ملف AndroidManifest.xml في <YOUR PROJECT ROOT>
/Assets/Plugins/Android/ أعلى علامة
<application>
:<uses-permission android:name="android.permission.INTERNET"/> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
- إذا كنت تريد تفعيل تتبُّع
الحملات، أضِف الخدمة على النحو التالي:
<service android:name="com.google.analytics.tracking.android.CampaignTrackingService" /> <receiver android:name="com.google.analytics.tracking.android.CampaignTrackingReceiver" android:exported="true" > <intent-filter> <action android:name="com.android.vending.INSTALL_REFERRER" /> </intent-filter> </receiver>
-
أضِف المكتبات التالية إلى مشروع Xcode:
- AdSupport.framework
- CoreData.framework
- SystemConfiguration.framework
- libz.dylib
- libsqlite3.dylib
- إذا كنت تفضّل إضافة المكتبات تلقائيًا عند إنشائها لنظام التشغيل iOS، انسخ الملف PostProcessBuildPlayer_GA من دليل iOS Extras ووضعه في دليل <YOUR PROJECT ROOT>/Assets/Editor.
- نزِّل mod_pbxproj.py النص البرمجي وانسخه إلى دليل Editor. ستتم الآن إضافة المكتبات تلقائيًا أثناء الإصدار.
ضبط الإعدادات المسبقة في "إحصاءات Google 3"
الخطوات التالية مطلوبة لضبط الإعدادات المسبقة في "إحصاءات Google 3":
- انقر على العنصر المُسبَق "
GAv3.prefab
"، والذي يمكن العثور عليه في Assets/Plugins/GoogleAnalyticsV3 في عرض المشروع. - ستعرض طريقة عرض Inspector (طريقة عرض أداة الفحص) مكوِّن نص برمجي مرفقًا بالنموذج السابق مع عدة خصائص مدرَجة.
عليك تعبئة هذه الخصائص بالقيم الصحيحة لمشروعك. سيؤدي ذلك إلى تعبئة العنصر بحيث يمكن استخدامه في كل مكان في مشروعك. على سبيل
المثال:
Android Property ID: UA-XXXXXXX-1
iOS Property ID: UA-XXXXXXX-2
Other Property ID: UA-XXXXXXX-3
App Name: MyGame
Bundle ID: com.example.games
App Version: 1.0
Dispatch Period: 5
Sample Frequency: 100
Debug Mode: VERBOSE
Anonymize IP: false
Dry Run: false
- اسحب "إحصاءات Google 3" (GAv3) التي تمت تعبئتها من عرض المشروع للأعلى إلى التدرّج الهرمي للعنصر.
تتبُّع أحد العناصر
بعد ضبط الإعدادات المسبقة GAv3، تصبح مستعدًا لبدء تتبُّع أحد العناصر باستخدام "إحصاءات Google" باتّباع الخطوات التالية:
- حدِّد GameObject الذي تريد تتبُّعه (على سبيل المثال، كائن المشغّل) وانقر عليه في عرض Object Heerrcy (عرض هرمي للكائنات). إذا لم يكن لديك نص برمجي مرفق بالكائن الذي تريد تتبّعه، يمكنك إنشاء نص برمجي جديد باستخدام الزر إضافة مكوّن في طريقة عرض Inspector.
- أنشئ متغيّرًا عامًا في الفئة للاحتفاظ بكائن GoogleAnalyticsV3. مثلاً:
public GoogleAnalyticsV3 googleAnalytics;
- احفظ النص البرمجي وارجع إلى نافذة Unity.
- في طريقة عرض أداة الفحص في GameObject الذي تريد تتبُّعه، سترى النص البرمجي الذي أنشأته وحقلًا تتم تعبئته باسم "إحصاءات Google" (أو اسم المتغيّر الذي اختَرته). اسحب الكائن GAv3 من العرض Object Herrcy إلى الحقل.
- أصبحت جاهزًا الآن لبدء تتبّع GameObject. كرر العملية للكائنات الأخرى التي تريد تتبعها باستخدام نفس الإعدادات المسبقة.
الخطوات التالية
- راجِع مرجع واجهة برمجة التطبيقات لمعرفة نوع النتائج التي يمكنك إرسالها إلى "إحصاءات Google".
- اقرأ دليل تنفيذ التطبيقات المتوافقة مع الأجهزة الجوّالة لمعرفة كيفية استخدام "إحصاءات Google" لقياس تفاعلات المستخدمين والإجابة عن الأسئلة المتعلقة باستخدام الألعاب.