Standard Integration

1. Configure MAS

You need to add your Appkey manually in your project if you haven’t added your game’s store link in MAS dashboard yet. You can find your Appkey in MAS dashboard.

Go to Assets -> Yodo1 -> MAS Settings.

You will need to copy the AppKey from the dashboard and add it into the configuration fields. The Admob ID should be fetched automatically, but if it’s not the case you can add it manually.

1.1 For Android

1.2 For iOS

2. Add the privacy dialog

Important

It’s mandatory to use a privacy dialog if your target audience includes children, otherwise you need to set the legal frameworks manually in order to comply with the app stores policies and also avoid any revenue loss.
If you use MAS built-in privacy dialog, the legal frameworks will be configured automatically.

Custom privacy dialog

When you use your own privacy dialog :

If the user’s age >= 13, then set COPPA to false, otherwise set it to true.
If the user’s age >= 16 and consents to having his data collected, then set GDPR to true, otherwise set it to false.
If the user consents to having his data collected, then set CCPA to false, otherwise set it to true.

You’ll find the details about how to set the legal frameworks through these links:

MAS privacy dialog

You can enable the built-in privacy compliance dialog to collect the users’ age and consent. Here is a picture of the pop up:

You can add this to your game with the code below, and you can also customize it. Follow the next steps:

Enable (Before the SDK initialization)

				
					Yodo1AdBuildConfig config =
new Yodo1AdBuildConfig().enableUserPrivacyDialog(true);  
Yodo1U3dMas.SetAdBuildConfig(config);

Custom user agreement (optional)

				
					Yodo1AdBuildConfig config = 
new Yodo1AdBuildConfig().enableUserPrivacyDialog(true).userAgreementUrl
("Your user agreement url");  
Yodo1U3dMas.SetAdBuildConfig(config);

Custom privacy policy (optional)

				
					Yodo1AdBuildConfig config = 
new Yodo1AdBuildConfig().enableUserPrivacyDialog(true).privacyPolicyUrl
("Your privacy policy url");  
Yodo1U3dMas.SetAdBuildConfig(config);

Customize the appearance of the pop up (optional)

The pop up is divided into 3 sections:

You can customize the background color of the 3 highlighted areas.

				
					Yodo1MasUserPrivacyConfig userPrivacyConfig = new Yodo1MasUserPrivacyConfig()
    .titleBackgroundColor(Color.green)
    .titleTextColor(Color.blue)
    .contentBackgroundColor(Color.black)
    .contentTextColor(Color.white)
    .buttonBackgroundColor(Color.red)
    .buttonTextColor(Color.green);

Yodo1AdBuildConfig config = new Yodo1AdBuildConfig()
    .enableUserPrivacyDialog(true)
    .userPrivacyConfig(userPrivacyConfig);

Yodo1U3dMas.SetAdBuildConfig(config);

5. Get user age and ATT status (optional)

				
					int age = Yodo1U3dMas.GetUserAge();

int attStatus = Yodo1U3dMas.GetAttrackingStatus();
switch(attStatus) {
    case Yodo1U3dAttrackingStatus.NotDetermined: break;
    case Yodo1U3dAttrackingStatus.Restricted: break;
    case Yodo1U3dAttrackingStatus.Denied: break;
    case Yodo1U3dAttrackingStatus.Authorized: break;
    case Yodo1U3dAttrackingStatus.SystemLow: break;  // iOS version below 14
}

3. Initialize the SDK

1. Include the following line at the top of the file where you initialize the MAS SDK:

				
					using Yodo1.MAS;

2. Initialize the SDK in the Start() method.

				
					Yodo1U3dMas.InitializeMasSdk();

3. You can check the initialization status.

				
					Yodo1U3dMasCallback.OnSdkInitializedEvent += (success, error) =>
        {
            Debug.Log("[Yodo1 Mas] OnSdkInitializedEvent, success:" + success + ", error: " + error.ToString());
            if (success)
            {
                Debug.Log("[Yodo1 Mas] The initialization has succeeded");
            }
            else
            {
                Debug.Log("[Yodo1 Mas] The initialization has failed");
            }
        };

4. Video tutorial

5. Implement the ad formats

Banners are rectangular images or text ads that occupy a spot within an app’s layout. They stay on screen while users are interacting with the app.

Implement a Banner

Interstitial

Interstitials are full-screen ads that cover the interface of an app until closed by the user. They’re best used at natural pauses in the flow of an app’s execution, such as in between levels of a game or after completing a task.

Implement an Interstitial Ad

Rewarded Video

Rewarded video ads are full-screen video ads that users have the option of watching in full in exchange for in-app rewards.

Implement a Rewarded Video

Native Ads

Native ads are ad formats that are presented to users via UI components that are native to the platform. Native ads match both the form and function of the user experience in which they’re placed. They also match the visual design of the app they live within.

Implement Native Ads

6. Set up the app-ads.txt

Click here for details!