Summary (clickable):

STEP 2C: Unity SDK Integration

In this step, you will use the Unity editor to import the necessary SDKs and to link the GameAnalytics and Facebook IDs that were created in the previous steps to your game.

• Download and unzip the Unity SDK containing the GameAnalytics and Facebook SDKs.
• Import the SDK into your Unity project: Assets ➜ Import Assets ➜ Custom Package... Locate the .unitypackage file you just downloaded. Make sure all files are selected and click Import.

Note: This will import both the GameAnalytics and Facebook SDKs. The versions included in the package are not necessarily the latest but they have been tested and are stable.  If you prefer (or if you have already implemented one of them), you can download the latest SDKs separately from GameAnalytics and Facebook. For implementation, refer to the relevant documentation on their websites.

Note: We currently only provide instructions and support for SDK Integration into Unity. If you are using another platform to create your game it is up to you to integrate the SDKs and ensure that the relevant events are being tracked on GA and FB.

• Add the GameAnalytics prefab object to your first scene. You can do this by clicking on Window ➜ GameAnalytics ➜ Create GameAnalytics Object.
• Add the GameAnalytics Settings:

• Click on Window ➜ GameAnalytics ➜ Select Settings and then sign into your GameAnalytics account.

• Select iPhonePlayer from the dropdown and then click the Add platform button.

• Select Voodoo from the Studio dropdown list and then your game from the Game dropdown list.

Note: if these options are not available, make sure you have correctly completed STEP 2A: GameAnalytics Setup. When logging into your GameAnalytics account, you should be able to see Voodoo as a studio and your game listed underneath.  

• Initialize the SDK by calling GameAnalytics.Initialize() from one of your own GameObjects.
• Add the progression events to your game code.

• Add the using statement to the script where you will call the progression events:

using GameAnalyticsSDK;

If your game has levels: 

• Add this line when a player starts a level: GameAnalytics.NewProgressionEvent(GAProgressionStatus.Start, Application.version, levelNumber.ToString(“00000”));
• Add this line when a player completes a level: GameAnalytics.NewProgressionEvent(GAProgressionStatus.Complete,  Application.version, levelNumber.ToString(“00000”), score);

If your game has no levels:

• Add this line when a player starts a game/round:

GameAnalytics.NewProgressionEvent(GAProgressionStatus.Start, Application.version, “game”);

• Add this line when a player finishes a game/round:

GameAnalytics.NewProgressionEvent(GAProgressionStatus.Complete, Application.version, “game”, score);

Important: Change score and levelNumber to the variable names you are using in your code. The score variable is optional if your game does not keep score.

Note: these are the only two events that are required during the testing phase, but you can find more information about progression tracking and other events on the GameAnalytics Unity SDK documentation page.

• Add the Facebook App Id to the Facebook settings.

• Click on Facebook ➜ Edit Settings
• Add the App Id from STEP 2B: Facebook App Setup

Note: If this value is left at 0, your game will crash at startup on an iOS device connected to the internet.

• You can test the integration of the SDK by building and running your game on a mobile device.

• Login to your GameAnalytics account and verify that the app is receiving event data.
• Login to your Facebook developer account and verify that the app is receiving event data.

Note: It may take between several minutes and several hours for the events to be registered. You can proceed to the next step while waiting.