الإصدار 3 (الإصدار القديم) من مكوّن "إحصاءات Google" الإضافي لنظام التشغيل Unity - دليل المطوِّر

يشرح هذا المستند مفاهيم مهمة حول استخدام المكوّن الإضافي لـ Google Analytics لـ Unity.

قبل البدء

قبل البدء، يُرجى التأكّد من إكمال الخطوات التالية:

عملية الإعداد والضبط

اختَر نظامًا أساسيًا لتفاصيل الضبط:

نظام التشغيل Android
  1. إذا لم يكن مشروعك يحتوي على ملف باسم AndroidManifest.xml في دليل <YOUR PROJECT ROOT>/Assets/Plugins/Android/، أنشئ المشروع لنظام التشغيل Android ثم انسخ الملف AndroidManifest.xml من الدليل Temp/StagingArea/ (سيكون ضمن الدليل الذي اخترت إنشاءه). الصقه في <YOUR PROJECT ROOT>/Assets/Plugins/Android/.
  2. أضِف الأذونات التالية إلى ملف 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"/>
  3. إذا كنت تريد تفعيل تتبُّع الحملات، أضِف الخدمة على النحو التالي: 
    <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>
نظام التشغيل iOS
  1. أضِف المكتبات التالية إلى مشروع Xcode:
    • AdSupport.framework
    • CoreData.framework
    • SystemConfiguration.framework
    • libz.dylib
    • libsqlite3.dylib
  2. إذا كنت تفضّل إضافة المكتبات تلقائيًا عند إنشائها لنظام التشغيل iOS، انسخ الملف PostProcessBuildPlayer_GA من دليل iOS Extras ووضعه في دليل <YOUR PROJECT ROOT>/Assets/Editor.
  3. نزِّل mod_pbxproj.py النص البرمجي وانسخه إلى دليل Editor. ستتم الآن إضافة المكتبات تلقائيًا أثناء الإصدار.

ضبط الإعدادات المسبقة في "إحصاءات Google 3"

الخطوات التالية مطلوبة لضبط الإعدادات المسبقة في "إحصاءات Google 3":

  1. انقر على العنصر المُسبَق "GAv3.prefab"، والذي يمكن العثور عليه في Assets/Plugins/GoogleAnalyticsV3 في عرض المشروع.
  2. ستعرض طريقة عرض 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
  3. اسحب "إحصاءات Google 3" (GAv3) التي تمت تعبئتها من عرض المشروع للأعلى إلى التدرّج الهرمي للعنصر.

تتبُّع أحد العناصر

بعد ضبط الإعدادات المسبقة GAv3، تصبح مستعدًا لبدء تتبُّع أحد العناصر باستخدام "إحصاءات Google" باتّباع الخطوات التالية:

  1. حدِّد GameObject الذي تريد تتبُّعه (على سبيل المثال، كائن المشغّل) وانقر عليه في عرض Object Heerrcy (عرض هرمي للكائنات). إذا لم يكن لديك نص برمجي مرفق بالكائن الذي تريد تتبّعه، يمكنك إنشاء نص برمجي جديد باستخدام الزر إضافة مكوّن في طريقة عرض Inspector.
  2. أنشئ متغيّرًا عامًا في الفئة للاحتفاظ بكائن GoogleAnalyticsV3. مثلاً: 
    public GoogleAnalyticsV3 googleAnalytics;
  3. احفظ النص البرمجي وارجع إلى نافذة Unity.
  4. في طريقة عرض أداة الفحص في GameObject الذي تريد تتبُّعه، سترى النص البرمجي الذي أنشأته وحقلًا تتم تعبئته باسم "إحصاءات Google" (أو اسم المتغيّر الذي اختَرته). اسحب الكائن GAv3 من العرض Object Herrcy إلى الحقل.
  5. أصبحت جاهزًا الآن لبدء تتبّع GameObject. كرر العملية للكائنات الأخرى التي تريد تتبعها باستخدام نفس الإعدادات المسبقة.

الخطوات التالية

المراجِع