این سند مفاهیم مهمی را در مورد استفاده از افزونه Google Analytics for Unity توضیح می دهد.
قبل از اینکه شروع کنی
قبل از شروع مطمئن شوید که موارد زیر را تکمیل کرده اید:
- شما باید حداقل یک ویژگی Google Analytics و یک نمای (نمایه) داشته باشید که بتوانید دادههای بازی خود را به آن ارسال کنید.
- اگر قصد ردیابی تراکنش های تجارت الکترونیک را دارید، تجارت الکترونیک را در گزارش های خود فعال کنید .
- googleanalyticsv3.unitypackage را از افزونه Google Analytics برای مخزن Unity دانلود کنید و آن را به پروژه Unity خود وارد کنید (با دوبار کلیک کردن روی فایل بتوانید این کار را انجام دهید).
راه اندازی و پیکربندی
یک پلتفرم برای جزئیات پیکربندی انتخاب کنید:
- اگر پروژه شما از قبل فایلی به نام AndroidManifest.xml در فهرست <YOUR PROJECT ROOT>/Assets/Plugins/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 کپی کنید و آن را در فهرست <YOUR PROJECT ROOT>/Assets/Editor قرار دهید.
- اسکریپت mod_pbxproj.py را دانلود کرده و در فهرست ویرایشگر کپی کنید. اکنون کتابخانه ها به طور خودکار در طول ساخت اضافه می شوند.
پیش ساخته GAv3 را پیکربندی کنید
مراحل زیر برای پیکربندی پیش ساخته GAv3 مورد نیاز است:
- روی شیء پیش ساخته
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
-
- GAv3 پر شده را از نمای پروژه به سمت بالا به سلسله مراتب شیء بکشید.
ردیابی یک شی
پس از پیکربندی پیش ساخته GAv3 ، با دنبال کردن این مراحل، آماده ردیابی یک شی با استفاده از Google Analytics هستید:
- یک GameObject را که می خواهید ردیابی کنید (به عنوان مثال، یک شی Player) شناسایی کنید و در نمای Object Hierarchy روی آن کلیک کنید. اگر قبلاً یک اسکریپت به شیئی که میخواهید ردیابی کنید متصل نکردهاید، با استفاده از دکمه Add Component در نمای بازرس ، یک اسکریپت جدید ایجاد کنید.
- یک متغیر عمومی در کلاس ایجاد کنید تا شی GoogleAnalyticsV3 را نگه دارد. به عنوان مثال:
public GoogleAnalyticsV3 googleAnalytics;
- اسکریپت را ذخیره کرده و به پنجره Unity برگردید.
- در نمای Inspector برای GameObject ی که میخواهید ردیابی کنید، اسکریپتی را که ایجاد کردهاید و فیلدی به نام Google Analytics (یا نام متغیری که انتخاب کردهاید) برای پر کردن آن مشاهده خواهید کرد. شی GAv3 را از نمای Object Hierarchy روی فیلد بکشید.
- اکنون برای شروع ردیابی GameObject آماده هستید. این فرآیند را برای سایر اشیایی که می خواهید با استفاده از همان پیش ساخته ردیابی کنید، تکرار کنید.
مراحل بعدی
- مرجع API را مرور کنید تا بدانید چه نوع بازدیدهایی را می توانید به Google Analytics ارسال کنید.
- راهنمای پیادهسازی اپلیکیشن موبایل را بخوانید تا نحوه استفاده از Google Analytics برای اندازهگیری تعاملات کاربر و پاسخ به سؤالات مربوط به استفاده از بازی را بیاموزید.