@musashishao/agent-kit 1.9.0 → 1.9.1

package/.agent/skills/game-development/game-analytics-integrator/SKILL.md

@@ -0,0 +1,410 @@
+---
+name: game-analytics-integrator
+description: Analytics integration for mobile games. Firebase, GameAnalytics, Unity Analytics, custom events, funnels, cohorts, and A/B testing setup.
+allowed-tools: Read, Write, Edit, Bash, Grep, WebSearch
+---
+
+# Game Analytics Integrator Skill
+
+> Turn player behavior into actionable insights.
+
+---
+
+## When to Use
+
+- Setting up analytics in mobile games
+- Designing event tracking schemas
+- Implementing funnel analysis
+- Creating player cohorts
+- Setting up A/B testing infrastructure
+
+---
+
+## Analytics Tool Comparison
+
+| Tool | Best For | Free Tier | Pros | Cons |
+|------|----------|-----------|------|------|
+| **Firebase** | All-purpose | Very generous | Google ecosystem | Complex setup |
+| **GameAnalytics** | Game-specific | 100K MAU | Game metrics | Less flexible |
+| **Unity Analytics** | Unity games | Built-in | Zero setup | Limited features |
+| **Amplitude** | Deep analysis | 10M events | Powerful UI | Expensive at scale |
+| **Mixpanel** | Product analytics | 100K users | Great funnels | Not game-focused |
+
+---
+
+## Firebase Analytics Setup
+
+### Installation (Unity)
+
+```bash
+# Download Firebase Unity SDK
+# Add to Assets/Firebase/
+
+# Enable in Firebase Console:
+# - Analytics
+# - Crashlytics
+# - Remote Config
+```
+
+### C# Implementation
+
+```csharp
+using Firebase.Analytics;
+
+public static class GameAnalytics
+{
+    public static void Initialize()
+    {
+        Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(task =>
+        {
+            if (task.Result == Firebase.DependencyStatus.Available)
+            {
+                FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);
+                Debug.Log("Firebase Analytics ready");
+            }
+        });
+    }
+    
+    // Track level completion
+    public static void LogLevelComplete(int levelNum, int score, float duration)
+    {
+        FirebaseAnalytics.LogEvent(FirebaseAnalytics.EventLevelEnd, new Parameter[]
+        {
+            new Parameter(FirebaseAnalytics.ParameterLevel, levelNum),
+            new Parameter(FirebaseAnalytics.ParameterScore, score),
+            new Parameter("duration_seconds", duration)
+        });
+    }
+    
+    // Track purchase
+    public static void LogPurchase(string itemId, float value, string currency)
+    {
+        FirebaseAnalytics.LogEvent(FirebaseAnalytics.EventPurchase, new Parameter[]
+        {
+            new Parameter(FirebaseAnalytics.ParameterItemId, itemId),
+            new Parameter(FirebaseAnalytics.ParameterValue, value),
+            new Parameter(FirebaseAnalytics.ParameterCurrency, currency)
+        });
+    }
+    
+    // Track tutorial progress
+    public static void LogTutorialStep(string stepName, int stepIndex)
+    {
+        FirebaseAnalytics.LogEvent("tutorial_step", new Parameter[]
+        {
+            new Parameter("step_name", stepName),
+            new Parameter("step_index", stepIndex)
+        });
+    }
+    
+    // Set user properties
+    public static void SetUserProperties(int playerLevel, bool isPayer)
+    {
+        FirebaseAnalytics.SetUserProperty("player_level", playerLevel.ToString());
+        FirebaseAnalytics.SetUserProperty("is_payer", isPayer ? "true" : "false");
+    }
+}
+```
+
+---
+
+## Custom Event Design
+
+### Event Naming Convention
+
+```
+[noun]_[past_tense_verb]
+
+Examples:
+- level_completed
+- item_purchased
+- ad_watched
+- tutorial_finished
+- session_started
+- character_unlocked
+```
+
+### Core Events Schema
+
+```csharp
+public static class EventSchema
+{
+    // Session events
+    public const string SESSION_START = "session_start";
+    public const string SESSION_END = "session_end";
+    
+    // Progression events
+    public const string LEVEL_START = "level_start";
+    public const string LEVEL_COMPLETE = "level_complete";
+    public const string LEVEL_FAIL = "level_fail";
+    
+    // Economy events
+    public const string CURRENCY_EARNED = "currency_earned";
+    public const string CURRENCY_SPENT = "currency_spent";
+    public const string ITEM_PURCHASED = "item_purchased";
+    
+    // Monetization events
+    public const string IAP_INITIATED = "iap_initiated";
+    public const string IAP_COMPLETED = "iap_completed";
+    public const string IAP_FAILED = "iap_failed";
+    public const string AD_REQUESTED = "ad_requested";
+    public const string AD_WATCHED = "ad_watched";
+    public const string AD_CLICKED = "ad_clicked";
+    
+    // Engagement events
+    public const string FEATURE_USED = "feature_used";
+    public const string TUTORIAL_STEP = "tutorial_step";
+    public const string ACHIEVEMENT_UNLOCKED = "achievement_unlocked";
+}
+
+// Event with full parameters
+public static void LogCurrencySpent(string currency, int amount, string itemType, string itemId)
+{
+    FirebaseAnalytics.LogEvent(EventSchema.CURRENCY_SPENT, new Parameter[]
+    {
+        new Parameter("currency_type", currency),    // "coins", "gems"
+        new Parameter("amount", amount),
+        new Parameter("item_type", itemType),        // "upgrade", "consumable"
+        new Parameter("item_id", itemId),
+        new Parameter("player_level", PlayerState.Level),
+        new Parameter("balance_after", PlayerState.GetBalance(currency))
+    });
+}
+```
+
+---
+
+## Funnel Analysis
+
+### Key Funnels to Track
+
+#### Tutorial Funnel
+```
+Step 1: first_open
+Step 2: tutorial_start
+Step 3: tutorial_step_1
+Step 4: tutorial_step_2
+Step 5: tutorial_step_3
+Step 6: tutorial_complete
+Step 7: first_game
+```
+
+#### Purchase Funnel
+```
+Step 1: shop_opened
+Step 2: product_viewed
+Step 3: purchase_initiated
+Step 4: payment_info_entered
+Step 5: purchase_completed
+```
+
+#### Daily Engagement Funnel
+```
+Step 1: app_open
+Step 2: main_menu_viewed
+Step 3: game_started
+Step 4: game_completed
+Step 5: reward_claimed
+```
+
+### Implementation
+
+```csharp
+public class FunnelTracker
+{
+    private readonly string _funnelName;
+    private int _currentStep = 0;
+    
+    public FunnelTracker(string funnelName)
+    {
+        _funnelName = funnelName;
+    }
+    
+    public void TrackStep(string stepName)
+    {
+        _currentStep++;
+        
+        FirebaseAnalytics.LogEvent($"{_funnelName}_funnel", new Parameter[]
+        {
+            new Parameter("step_name", stepName),
+            new Parameter("step_number", _currentStep),
+            new Parameter("funnel_id", _funnelName + "_" + SessionId)
+        });
+    }
+}
+
+// Usage
+var tutorialFunnel = new FunnelTracker("tutorial");
+tutorialFunnel.TrackStep("start");
+tutorialFunnel.TrackStep("move_learned");
+tutorialFunnel.TrackStep("attack_learned");
+tutorialFunnel.TrackStep("complete");
+```
+
+---
+
+## Cohort Analysis
+
+### Cohort Definition
+
+```csharp
+public enum PlayerCohort
+{
+    // By acquisition
+    Organic,
+    PaidAd_Facebook,
+    PaidAd_Google,
+    CrossPromo,
+    
+    // By behavior
+    NonPayer,
+    Minnow,      // <$10
+    Dolphin,     // $10-100
+    Whale,       // >$100
+    
+    // By engagement
+    Churned,     // No activity >7 days
+    AtRisk,      // No activity 3-7 days
+    Active,      // Active this week
+    PowerUser    // Daily active
+}
+
+public static void AssignCohorts(PlayerData player)
+{
+    // Spending cohort
+    var spendCohort = player.TotalSpend switch
+    {
+        0 => "non_payer",
+        < 10 => "minnow",
+        < 100 => "dolphin",
+        _ => "whale"
+    };
+    FirebaseAnalytics.SetUserProperty("spend_cohort", spendCohort);
+    
+    // Engagement cohort
+    var daysSincePlay = (DateTime.Now - player.LastPlayDate).Days;
+    var engageCohort = daysSincePlay switch
+    {
+        > 7 => "churned",
+        > 3 => "at_risk",
+        _ => player.DaysPlayed > 10 ? "power_user" : "active"
+    };
+    FirebaseAnalytics.SetUserProperty("engage_cohort", engageCohort);
+}
+```
+
+---
+
+## A/B Testing with Firebase Remote Config
+
+### Setup
+
+```csharp
+public class ABTestManager : MonoBehaviour
+{
+    private FirebaseRemoteConfig _remoteConfig;
+    
+    async void Start()
+    {
+        _remoteConfig = FirebaseRemoteConfig.DefaultInstance;
+        
+        // Set defaults
+        var defaults = new Dictionary<string, object>
+        {
+            {"starter_pack_price", 4.99},
+            {"ad_frequency", 3},
+            {"tutorial_version", "control"}
+        };
+        await _remoteConfig.SetDefaultsAsync(defaults);
+        
+        // Fetch latest
+        await _remoteConfig.FetchAndActivateAsync();
+    }
+    
+    public float GetStarterPackPrice()
+    {
+        return (float)_remoteConfig.GetValue("starter_pack_price").DoubleValue;
+    }
+    
+    public string GetTutorialVersion()
+    {
+        return _remoteConfig.GetValue("tutorial_version").StringValue;
+    }
+}
+```
+
+### Setting Up A/B Test in Firebase Console
+
+1. Go to Remote Config
+2. Add parameter (e.g., `starter_pack_price`)
+3. Add condition for % of users:
+   - Condition A: 50% gets 3.99
+   - Condition B: 50% gets 4.99
+4. Publish changes
+
+### Tracking Test Results
+
+```csharp
+public void OnStarterPackPurchased()
+{
+    var price = ABTestManager.Instance.GetStarterPackPrice();
+    
+    FirebaseAnalytics.LogEvent("ab_test_conversion", new Parameter[]
+    {
+        new Parameter("test_name", "starter_pack_price"),
+        new Parameter("variant", price.ToString()),
+        new Parameter("converted", true)
+    });
+}
+```
+
+---
+
+## Dashboard Essentials
+
+### Daily Metrics to Check
+
+| Metric | What It Tells You |
+|--------|-------------------|
+| **DAU** | Daily health |
+| **D1/D7/D30** | Long-term retention |
+| **ARPDAU** | Revenue per player |
+| **Session Length** | Engagement depth |
+| **Crash Rate** | Technical health |
+
+### Weekly Metrics
+
+| Metric | What It Tells You |
+|--------|-------------------|
+| **WAU/MAU** | User base trend |
+| **Conversion Rate** | Monetization efficiency |
+| **LTV by Cohort** | ROI by acquisition source |
+| **Funnel Drop-offs** | UX problems |
+
+---
+
+## Quick Reference
+
+| Action | Event Name | Key Parameters |
+|--------|------------|----------------|
+| Start game | `level_start` | level_num |
+| Complete level | `level_complete` | level_num, score, time |
+| Purchase item | `purchase` | item_id, value, currency |
+| Watch ad | `ad_impression` | ad_type, placement |
+| Unlock character | `unlock` | item_id, method |
+
+---
+
+## Anti-Patterns
+
+| ❌ Don't | ✅ Do |
+|----------|-------|
+| Track everything | Track what you'll act on |
+| PII in events | Anonymous identifiers |
+| Inconsistent naming | Use event schema |
+| Skip user properties | Set cohort data |
+| Ignore GDPR | Consent before tracking |
+
+---
+
+> **Remember:** Data without action is just noise. Track what matters.