פלאגין Google Analytics ל-Unity v3 (מדור קודם) - מדריך למפתחים

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

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

כדי להגדיר את ההעדפה של GAv3, צריך לפעול לפי השלבים הבאים:

  1. לוחצים על האובייקט המוגדר מראש GAv3.prefab, שניתן למצוא בקטע Assets/Plugins/GoogleAnalyticsV3 בתצוגת פרויקט.
  2. בתצוגת המפקח יוצג רכיב סקריפט המצורף ל-API, עם מספר מאפיינים רשומים. מאכלסים את המאפיינים האלה בערכים הנכונים לפרויקט שלכם. הפעולה הזו תאכלס את האובייקט כדי שאפשר יהיה להשתמש בו בכל מקום בפרויקט. לדוגמה:
    • 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. גוררים את ה-GAv3 המאוכלס מתצוגת הפרויקט למעלה אל היררכיית אובייקטים.

מעקב אחר אובייקט

אחרי שתגדירו את ההצעה מראש ל-GAv3, תוכלו להתחיל לעקוב אחר אובייקט באמצעות Google Analytics, על ידי ביצוע השלבים הבאים:

  1. מאתרים GameObject שרוצים לעקוב אחריו (למשל, אובייקט של נגן) ולוחצים עליו בתצוגה Object Hierarchy. אם עדיין לא צירפת סקריפט לאובייקט שאחריו רוצים לעקוב, אפשר ליצור סקריפט חדש באמצעות הלחצן הוספת רכיב בתצוגה 'מפקח'.
  2. יוצרים משתנה ציבורי במחלקה כדי להכיל את האובייקט GoogleAnalyticsV3. לדוגמה: 
    public GoogleAnalyticsV3 googleAnalytics;
  3. שמור את הסקריפט וחזור לחלון Unity.
  4. בתצוגת המפקח של GameObject שרוצים לעקוב אחריה, יופיעו הסקריפט שיצרתם ושדה לאכלוס שנקרא Google Analytics (או שם המשתנה שבחרתם). גוררים את האובייקט GAv3 מהתצוגה המפורטת היררכיית אובייקטים לשדה.
  5. עכשיו אתם מוכנים להתחיל לעקוב אחר ה-GameObject הזה. חזור על התהליך עבור אובייקטים אחרים שברצונך לעקוב אחריהם באמצעות אותה טעם.

השלבים הבאים

משאבים