במסמך הזה נסביר מושגים חשובים לגבי השימוש בפלאגין של Google Analytics ל-Unity.
לפני שמתחילים
לפני שתתחילו, ודאו שהשלמתם את הפריטים הבאים:
- צריכים להיות לכם נכס אחד לפחות ב-Google Analytics ותצוגה מפורטת (פרופיל) שאליה יישלחו נתונים מהמשחק.
- מורידים את חבילת Unity המתאימה מהפלאגין של Google Analytics למאגר Unity ומייבאים אותה לפרויקט Unity (אפשר לעשות זאת על ידי לחיצה כפולה על הקובץ).
- עם תמיכה ב-bitcode:
GoogleAnalyticsV4_bitcode.unitypackage
- אין תמיכה ב-bitcode:
GoogleAnalyticsV4.unitypackage
- עם תמיכה ב-bitcode:
הגדרה והגדרה
יש לבחור פלטפורמה כדי לקבל את פרטי ההגדרות:
- אם בפרויקט אין עדיין קובץ בשם AndroidManifest.xml בספרייה <YOUR PROJECT ROOT>/Assets/Plugins/Android/, צריך ליצור את הפרויקט ל-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.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>
-
מוסיפים את הספריות הבאות לפרויקט Xcode:
- AdSupport.framework
- CoreData.framework
- SystemConfiguration.framework
- libz.dylib
- libsqlite3.dylib
- אם אתם מעדיפים שהספריות יתווספו אוטומטית במהלך הפיתוח ל-iOS, מעתיקים את הקובץ PostProcessBuildPlayer_GA מהספרייה iOS Extras ומציבים אותו בספרייה <YOUR PROJECT ROOT>/Assets/Editor.
- מורידים את הסקריפט mod_pbxproj.py ומעתיקים אותו לספרייה Editor. הספריות יתווספו עכשיו באופן אוטומטי במהלך ה-build.
הגדרת העדפה ל-GAv4
כדי להגדיר העדפה ל-GAv4:
- לוחצים על האובייקט המוגדר מראש
GAv4.prefab
, שניתן למצוא בקטע Assets/Plugins/GoogleAnalyticsV4 בProject View. גוררים את הפריט הזה להיררכיה של המשחק. - בתצוגת המפקח יוצג רכיב
סקריפט המצורף ל-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:
- מאתרים GameObject שרוצים לעקוב אחריו (למשל, אובייקט של נגן) ולוחצים עליו בתצוגה Object Hierarchy. אם עדיין לא צירפת סקריפט לאובייקט שאחריו רוצים לעקוב, אפשר ליצור סקריפט חדש באמצעות הלחצן הוספת רכיב בתצוגה 'מפקח'.
- יוצרים משתנה ציבורי במחלקה כדי להכיל את האובייקט GoogleAnalyticsV4. לדוגמה:
public GoogleAnalyticsV4 googleAnalytics;
- שמור את הסקריפט וחזור לחלון Unity.
- בתצוגת המפקח של GameObject שרוצים לעקוב אחריה, יופיעו הסקריפט שיצרתם ושדה לאכלוס שנקרא Google Analytics (או שם המשתנה שבחרתם). גוררים את האובייקט GAv4 מהתצוגה המפורטת היררכיית אובייקטים לשדה.
- עכשיו אתם מוכנים להתחיל לעקוב אחר ה-GameObject הזה. חזור על התהליך עבור אובייקטים אחרים שברצונך לעקוב אחריהם באמצעות אותה טעם.
השלבים הבאים
- בחומר העזר בנושא API מוסבר אילו סוגי היטים אפשר לשלוח ל-Google Analytics.
- במדריך להטמעת אפליקציות לנייד מוסבר איך להשתמש ב-Google Analytics כדי למדוד אינטראקציות של משתמשים ולענות על שאלות לגבי שימוש במשחקים.