مكوّن "إحصاءات 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.android.gms.analytics.CampaignTrackingService" />
<receiver android:name="com.google.android.gms.analytics.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 4"

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

  1. انقر على العنصر المُسبَق "GAv4.prefab"، والذي يمكن العثور عليه في Assets/Plugins/GoogleAnalyticsV4 في عرض المشروع. اسحب هذه اللعبة إلى التسلسل الهرمي للألعاب.
  2. ستعرض طريقة عرض Inspector (طريقة عرض أداة الفحص) مكوِّن نص برمجي مرفقًا بالنموذج السابق مع عدة خصائص مدرَجة. عليك تعبئة هذه الخصائص بالقيم الصحيحة لمشروعك. سيؤدي ذلك إلى تعبئة العنصر بحيث يمكن استخدامه في كل مكان في مشروعك. على سبيل المثال:
    • Android Tracking Code: UA-XXXXXXX-1
    • iOS Tracking Code: UA-XXXXXXX-2
    • Other Tracking Code: UA-XXXXXXX-3
    • Product Name: MyGame
    • Bundle Identifier: com.example.games
    • Bundle Version: 1.0
    • Dispatch Period: 5
    • Sample Frequency: 100
    • Log Level: VERBOSE
    • Anonymize IP: false
    • Uncaught Exception Reporting: false
    • Send Launch Event: false
    • Session Timeout: 1800
    • Dry Run: false
    • Advertiser Id Support - Send IDFA/AdID: false

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

بعد ضبط الإعدادات المسبقة في GAv4، يمكنك تتبُّع عنصر باستخدام "إحصاءات Google":

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

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

المراجِع