Game Overrides integration with CCD

Use Remote Config and badges to integrate Game Overrides with Cloud Content Delivery so you can target content to specific audiences.

Read time 4 minutes

Last updated 2 months ago

Game Overrides allow you to target content to specific audiences, for example, by running A/B tests, and customizing content to geographical location and specific periods of time. Badges identify the intended content, and Remote Config tests that content without affecting live players, while also distributing badged content to specific players. To integrate Game Overrides, complete the following steps:

Install the Remote Config package
Link your Project ID
Create an Override to target content by using your CCD badges
Integrate Remote Config into your game code
Retrieve the appropriate assets from CCD

Install the Remote Config package

For information about installing packages, see Package Manager.

Note

These steps may vary depending on which version of the Unity Editor you’re using.

In the Unity Editor, select Window > Package Manager.
In the Packages List View, select Remote Config.
In the Package Specific Detail View, select and install the version you need to import Remote Config into your project.

Link your Project ID

If you haven’t done so already, you must link your Unity project to a Project ID. To link your project from the Unity Editor:

Open the Services window (Window > General > Services).
Select General settings.
In the Services section of the Project settings menu, select your Organization from the dropdown. You must be signed in to Unity Hub to view a list of associated Organizations.
Select Use an existing Unity project ID to link a project to an ID that you previously created on the developer dashboard, or Create project ID to link your project to a new ID.

Create an Override

You can create an Override on the Unity Dashboard either from the Game Overrides service or from the Cloud Content Delivery service. For more information, refer to the Game Overrides Get started page.

In the Unity Dashboard, go to Development > Products.
Select Game Overrides.
You can alternatively navigate to the Overview page by selecting Create Override in the Targeting tab of your bucket in the Cloud Content Delivery service itself.
Select Create Game Override.
Give your Override a name and select Next.
Choose which players to target by specifying a JEXL condition, and then specify what percentage of these players to target. Select Next.
Select + Choose content type, and then select Cloud Content Delivery > Badge. Select Done.
Note
To create an Override by using a regular Remote Config configuration instead of targeting a CCD badge, select Config Overrides. See Remote Config.
Select Choose a bucket, and then pick the bucket you want to use.
Select Choose your badge, and then pick the badge you want to use. Select Choose, then select Next.
Choose the Start and End Date to run your Override. Select Finish.
Select Enable to activate your Override.

Integrate Remote Config into your game code

The

RemoteConfig

API is included in the

Unity.Services

namespace, which you must include in your game script. For more information on its classes and methods, see the Remote Config Scripting API documentation. The Remote Config service has an accessible

RemoteConfigService

instance to handle fetching and applying your configuration at runtime. In this example, you use it to fetch the key-value pair for your CCD configuration defined by your Override. The key for this pair is the static string

CCD_CONFIG_KEY

. You then invoke your

ApplyCcdConfig

function when the retrieval succeeds.

ApplyCcdConfig

takes a

ConfigResponse

struct, which represents the response to a fetch request. C#


public struct userAttributes {}public struct appAttributes {}async Task InitializeRemoteConfigAsync(){  // initialize handlers for unity game services  await UnityServices.InitializeAsync();  // remote config requires authentication for managing environment information  if (!AuthenticationService.Instance.IsSignedIn)  {    await AuthenticationService.Instance.SignInAnonymouslyAsync();  }}async void Start(){    if (Utilities.CheckForInternetConnection())    {        await InitializeRemoteConfigAsync();    }    RemoteConfigService.Instance.appConfig = RemoteConfigService.Instance.GetConfig("ccd");    RemoteConfigService.Instance.FetchCompleted += ApplyCcdConfig;    RemoteConfigService.Instance.FetchConfigs("ccd", new userAttributes(), new appAttributes());}void ApplyCcdConfig(ConfigResponse configResponse){    switch (configResponse.requestOrigin)    {        case ConfigOrigin.Default:            Debug.Log("Default values will be returned");            break;        case ConfigOrigin.Cached:            Debug.Log("Cached values loaded");            break;        case ConfigOrigin.Remote:            Debug.Log("Remote Values changed");            if (RemoteConfigService.Instance.appConfig.HasKey("CCD_CONFIG_KEY"))            {                // get the correct key-value pair for CCD (the key will always be "CCD_CONFIG_KEY")                string jsonValue = RemoteConfigService.Instance.appConfig.GetJson("CCD_CONFIG_KEY");                // you will use jsonValue in the next step            }            break;    }}

Retrieve the appropriate assets from CCD

After you have successfully fetched the CCD configuration, you can then extract your bucket information and badge name to retrieve the appropriate assets from CCD. Start by defining a

CcdConfig

class. C#


public class CcdConfig{   public string bucketId;   public string bucketName;   public string badgeName;}

In your

ApplyCcdConfig

function, you can then extract these values from the fetched CCD configuration and use them to retrieve the appropriate assets from CCD. C#


// extract the config values that you have defined when creating your OverrideCcdConfig ccdConfig = JsonUtility.FromJson<CcdConfig>(jsonValue);// the bucketId and badgeName are required to fetch the appropriate assetsvar bucketId = ccdConfig.bucketId;var badgeName = ccdConfig.badgeName;// fetch the entry from CCD// Note that for a dynamic file path, a config override can be used in order to fetch// the correct file path for your assetJObject entry = CcdManager.Instance.GetEntry(bucketId, badgeName, "ENTRY_PATH");// fetch the entry's content from CCDvar content = CcdManager.Instance.GetContent(bucketId, entry["entryid"].ToString());// use your asset(s) as needed// YOUR CODE HERE

The

CCDManager

class uses CCD’s client API to fetch the asset. You must attach the

CCDManager

to a game object in each scene.

Note

If your assets are large, consider fetching them asynchronously.

Your

CCDManager

class might look something like the following code sample: C#


using System.Collections;using System.Collections.Generic;using UnityEngine;using System.Threading.Tasks;using Unity.RemoteConfig;using System.Net;using System;using System.IO;public class CcdManager : MonoBehaviour{   private static string projectId = "YOUR_PROJECT_ID_HERE";   private static string ccdBaseUrl = $"https://{projectId}.client-api.unity3dusercontent.com/client_api/v1/";   private static CcdManager m_Instance;   public static CcdManager Instance { get { return m_Instance; } }   private void Awake()   {     if (m_Instance != null && m_Instance != this)       {           Destroy(this.gameObject);           return;       }       m_Instance = this;       DontDestroyOnLoad(this.gameObject);   }   public JObject GetEntry(string bucketId, string badgename, string entrypath) {     var entryUrl = $"{ccdBaseUrl}/buckets/{bucketId}/release_by_badge/{badgename}/entry_by_path/?path={entrypath}";     HttpWebRequest request = (HttpWebRequest)WebRequest.Create(entryUrl);     HttpWebResponse response = (HttpWebResponse)request.GetResponse();     StreamReader reader = new StreamReader(response.GetResponseStream());     string jsonResponse = reader.ReadToEnd();     JObject ccdEntry =  JObject.Parse(jsonResponse);     return ccdEntry;   }   public string GetContent(string bucketId, string entryid) {     var contentUrl = $"{ccdBaseUrl}/buckets/{bucketId}/entries/{entryid}/content/";     HttpWebRequest request = (HttpWebRequest)WebRequest.Create(String.Format(contentUrl));     HttpWebResponse response = (HttpWebResponse)request.GetResponse();     StreamReader reader = new StreamReader(response.GetResponseStream());     string contentValue = reader.ReadToEnd();     return contentValue;   }}

You have now successfully retrieved the assets defined by your Override.

Documentation

Development

User Acquisition

Monetization

Industry