افزونه Google Analytics for Unity - راهنمای توسعه دهنده

این سند مفاهیم مهمی را در مورد استفاده از افزونه Google Analytics for Unity توضیح می دهد.

قبل از اینکه شروع کنی

قبل از شروع مطمئن شوید که موارد زیر را تکمیل کرده اید:

راه اندازی و پیکربندی

یک پلتفرم برای جزئیات پیکربندی انتخاب کنید:

اندروید
  1. اگر پروژه شما از قبل فایلی به نام AndroidManifest.xml در فهرست <YOUR PROJECT ROOT>/Assets/Plugins/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 کپی کنید و آن را در فهرست <YOUR PROJECT ROOT>/Assets/Editor قرار دهید.
  3. اسکریپت mod_pbxproj.py را دانلود کرده و در فهرست ویرایشگر کپی کنید. اکنون کتابخانه ها به طور خودکار در طول ساخت اضافه می شوند.

پیش ساخته GAv4 را پیکربندی کنید

برای پیکربندی پیش ساخته GAv4:

  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 Analytics:

  1. یک GameObject را که می خواهید ردیابی کنید (به عنوان مثال، یک شی Player) شناسایی کنید و در نمای Object Hierarchy روی آن کلیک کنید. اگر قبلاً یک اسکریپت به شیئی که می‌خواهید ردیابی کنید متصل نکرده‌اید، با استفاده از دکمه Add Component در نمای بازرس ، یک اسکریپت جدید ایجاد کنید.
  2. یک متغیر عمومی در کلاس ایجاد کنید تا شی GoogleAnalyticsV4 را نگه دارد. به عنوان مثال: 
    public GoogleAnalyticsV4 googleAnalytics;
  3. اسکریپت را ذخیره کرده و به پنجره Unity برگردید.
  4. در نمای Inspector برای GameObject ی که می‌خواهید ردیابی کنید، اسکریپتی را که ایجاد کرده‌اید و فیلدی به نام Google Analytics (یا نام متغیری که انتخاب کرده‌اید) برای پر کردن آن مشاهده خواهید کرد. شی GAv4 را از نمای Object Hierarchy روی فیلد بکشید.
  5. اکنون برای شروع ردیابی GameObject آماده هستید. این فرآیند را برای سایر اشیایی که می خواهید با استفاده از همان پیش ساخته ردیابی کنید، تکرار کنید.

مراحل بعدی

  • مرجع API را مرور کنید تا بدانید چه نوع بازدیدهایی را می توانید به Google Analytics ارسال کنید.
  • راهنمای پیاده‌سازی اپلیکیشن موبایل را بخوانید تا نحوه استفاده از Google Analytics برای اندازه‌گیری تعاملات کاربر و پاسخ به سؤالات مربوط به استفاده از بازی را بیاموزید.

منابع