פלאגין Google Analytics ל-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. הספריות יתווספו עכשיו באופן אוטומטי במהלך ה-build.

הגדרת העדפה ל-GAv4

כדי להגדיר העדפה ל-GAv4:

  1. לוחצים על האובייקט המוגדר מראש GAv4.prefab, שניתן למצוא בקטע Assets/Plugins/GoogleAnalyticsV4 בProject View. גוררים את הפריט הזה להיררכיה של המשחק.
  2. בתצוגת המפקח יוצג רכיב סקריפט המצורף ל-API, עם מספר מאפיינים רשומים. מאכלסים את המאפיינים האלה בערכים הנכונים לפרויקט שלכם. הפעולה הזו תאכלס את האובייקט כדי שאפשר יהיה להשתמש בו בכל מקום בפרויקט. לדוגמה:
    • 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 שרוצים לעקוב אחריו (למשל, אובייקט של נגן) ולוחצים עליו בתצוגה Object Hierarchy. אם עדיין לא צירפת סקריפט לאובייקט שאחריו רוצים לעקוב, אפשר ליצור סקריפט חדש באמצעות הלחצן הוספת רכיב בתצוגה 'מפקח'.
  2. יוצרים משתנה ציבורי במחלקה כדי להכיל את האובייקט GoogleAnalyticsV4. לדוגמה: 
    public GoogleAnalyticsV4 googleAnalytics;
  3. שמור את הסקריפט וחזור לחלון Unity.
  4. בתצוגת המפקח של GameObject שרוצים לעקוב אחריה, יופיעו הסקריפט שיצרתם ושדה לאכלוס שנקרא Google Analytics (או שם המשתנה שבחרתם). גוררים את האובייקט GAv4 מהתצוגה המפורטת היררכיית אובייקטים לשדה.
  5. עכשיו אתם מוכנים להתחיל לעקוב אחר ה-GameObject הזה. חזור על התהליך עבור אובייקטים אחרים שברצונך לעקוב אחריהם באמצעות אותה טעם.

השלבים הבאים

משאבים