How to make custom events?

So the code sample relies on you understanding a tiny bit of C#. But fear not, we're here to help!

All C# code lives in classes. Each class represents some functionality of your game. For example, things you probably know — BoxCollider, Renderer and Transform — are classes that enable collision detection, rendering and position/rotation respectively. Now you don't need to write those classes since Unity's done it for you. But custom events — since they're custom — have to be written by you. Here's one way the code snippet might be written as a C# class.

Code (CSharp):

1. using System.Collections.Generic;
2. using UnityEngine;
3. using UnityEngine.Analytics;
4.  
5. public class GameOverTracker : MonoBehaviour {
6.  
7.     public bool someConditionHasBeenMet = false;
8.  
9.     public void Update() {
10.         if (someConditionHasBeenMet) {    //See below
11.             SendEventOnGameOver ();
12.         }
13.     }
14.  
15.     void SendEventOnGameOver() {
16.         int totalPotions = 5;
17.         int totalCoins = 100;
18.         string weaponID = "Weapon_102";
19.         Analytics.CustomEvent ("gameOver", new Dictionary<string, object> {
20.             { "potions", totalPotions },
21.             { "coins", totalCoins },
22.             { "activeWeapon", weaponID }
23.         });
24.         someConditionHasBeenMet = false;
25.     }
26. }

So this class is called GameOverTracker. It extends MonoBehaviour, which means that it can be attached to a GameObject. This class has two methods: Update and SendEventOnGameOver. Methods are things that a class can do. In any MonoBehaviour, the Update method gets called (executed) once per frame of your game. SendEventOnGameOver will only be called if someConditionHasBeenMet is equal to true. As long as someConditionHasBeenMet equals false, SendEventOnGameOver will never be called.

Now, what would it take for someConditionHasBeenMet to be true? I can't answer that. Only you know that, because it's different for every game. Maybe it's crossing a finish line, or killing all the bad guys, or solving a puzzle, or dying. Whenever the game is over, set someConditionHasBeenMet to true, and that will send your custom event.

Here's a pretty nice blog post on writing your own MonoBehaviours, to help you with these fundamentals: http://www.dannygoodayle.com/2013/06/11/unity-monobehaviours-c/

Hope that helps!