Project settings

From the Monetization dashboard, select CURRENT PROJECT > Settings in the secondary navigation menu to view and configure monetization settings for your project.

Project info

Find the following properties for your project here:

Setting

Description

Project name

The name of your project. This setting is read-only, but Organization Owners can change project names (see documentation on creating and editing projects).

Project ID

The unique Unity identifier for your project.

Mediation partner

Selecting your mediation partner allows Unity to improve its tools and experiences for you and your project. For more information, see documentation on Unity mediation and implementing Unity Ads in third-party mediation.

Privacy Settings

Privacy controls allow you to manage contextual ad settings for your project in a single place. The Children’s Online Privacy Protection Act (COPPA) imposes restrictions on how data can be collected and used from children under the age of 13. Unity Ads provides tools to help publishers provide a safe and positive user experience. Accordingly, each Unity Ads-enabled project must specify whether their game targets users under the age of 13. This article will guide you through configuring the right setting for your game based on your target audience.

For more information, see documentation on COPPA compliance and contextual ads.

To view and edit your project’s privacy settings on the Monetization dashboard, select CURRENT PROJECT > Settings from the secondary navigation menu, then scroll to the Privacy Settings section.

Important: Only the project's Organization Owner can edit its privacy control settings.

Game-level COPPA designation

This setting applies a single game-wide designation for each platform. There are three options:

  • This app is directed to children under the age of 13 means the game falls under COPPA restrictions, and can therefore only serve contextual (non-targeted) ads to all users. Note that this designation permits you to enable user-specific COPPA designations solely for applications you also designate as mixed audience applications.
  • This app is NOT directed to children under the age of 13 means the game does not fall under COPPA restrictions, and can therefore serve behavioral (targeted) ads to all users. Note that this designation still allows you to disable targeted ads entirely for adult audiences via the Contextual ads control feature if that is your preference.

Note for mediated customers: If you set a app-level age designation in the Monetization dashboard, make sure to map it to the COPPA status in your mediation provider’s settings. If you select a mixed audience setting for an unsupported mediation platform, Unity Ads will revert to the default behavior.

Important: Opting in to the Apple Kids Category or Google Designed for Family program will automatically configure the game-level COPPA designation setting to This app is directed to children under the age of 13. For more information, see the section on app store compliance below.

Mixed audience games

If your app is directed to children under the age of 13, you will see a conditional field to designate your app as directed to mixed audiences (that is, it is targeted to both children and to adults). Setting Is this a Mixed Audience Game? to Yes allows you to pass individualized designations for each user to determine whether they fall under COPPA restrictions.

User-level COPPA statuses

A game-level designation should be sufficient for most games, however, games with mixed audiences (that is, it is targeted to both children and to adults) have one additional configuration choice.

To enable user-specific COPPA designations:

  1. Set Game-level COPPA designation to This game is directed at children under the age of 13.
  2. Set Is this a Mixed Audience Game? to Yes.
  3. Implement user-specific COPPA designations.

The User-level COPPA Status field will indicate whether Unity Ads is receiving user-specific COPPA statuses from your code implementation for the indicated platform. The status will appear Active if Unity has received user-specific COPPA signals within the last 36 hours.

Important: This setting is only available for projects using Unity Ads exclusively, or supported mediation platforms. If this setting does not appear, check that your Mediation partner setting is set to Unity (not mediated), Self Mediated (under Third Party Mediation), or one of the approved integrated partners.

Mixed audience games are still eligible for Google’s Designed for Families program or Apple’s Kids Category. For more information, see the section on app store compliance below.

Code implementation

You must pass Unity Ads user-level age designations programmatically using the nonbehavioral API. For complete instructions on how to implement this MetaData class in your code, see documentation on COPPA compliance.

The User Level Age Designation setting will appear Active if Unity has received user-level designation data from your game within the last 24 hours on the specified platform.

Note: Depending on your configuration, it is possible for this setting to be active without impacting behavior. See the quick reference table below for examples.

Supported platforms

The following integrations currently support user-level age designation in Unity Ads:

Please see the corresponding links for instructions on how to implement user-specific COPPA designations in your game code.

Default behavior for unknown users

Default behavior refers to the baseline behavior of ads served in your game. Unity Ads will default to this behavior when a user-specific COPPA designation is absent. The default behavior is dictated by your game-level age designation, and cannot be independently altered.

Contextual ads control

If your game does not target users under the age of 13, but you still want to restrict it to contextual ads, set this field to Show contextual ads only. Games targeting users under the age of 13 must use this setting and cannot edit this field.

Quick reference

Refer to this chart to determine the behavior results of your Privacy Settings configuration:

Game-level COPPA designation Mixed Audience Game? Contextual ads control End-user behavior
Directed to children under the age of 13 No Not Available Unity treats all users as under the age of 13 and only serves contextual ads.
Directed to children under the age of 13 Yes Not Available

Unity receives user-level designations. Users designated as 13 and older receive personalized ads, but all other users (including those with unknown designations) are treated as children and only receive contextual ads.

Note: Mixed audience games are still eligible for Google’s Designed for Families program or Apple’s Kids Category. For more information, see the section on app store compliance below.

NOT directed to children under the age of 13 Not available Show contextual ads only Even though the game is not directed at users under the age of 13, all users only receive contextual ads.
NOT directed to children under the age of 13 Not available Allow personalized ads All users are treated as 13 or older, and may receive personalized ads.

Missing SDKAdNetwork Ids from Info.plist

This field provides a list of recommended ad network IDs that are missing from your iOS game's Info.plist file. For more information, see documentation on configuring network IDs for iOS 14.

Store IDs

Optionally link your project to live Store IDs for the game’s Apple or Google Play app page.

Important: Skipping this step does not prevent you from showing ads, however, some of Unity's advertising partners require this information. In order to maximize revenue opportunities, please make sure you include it when your game is live.

Extract the Apple App Store ID from your game’s URL, as shown in the highlighted section of the following URL:

Extract the Google Play Store ID from your game’s URL, as shown in the highlighted section of the following URL:

Note: If you recently published your app, Unity may be unable to look up its ID. Should you encounter this error, please try again 5-7 days after the publish date.

Game IDs

You need the Game ID for each platform to initialize the Unity Ads and Unity IAP SDKs in your code. You cannot edit these IDs.

App store compliance

Both Google and Apple introduced requirements to ensure that apps that are directed at children and serve ads are safe to use. If you serve ads in your app and wish to participate in Google’s Designed for Families program or the Apple Kids Category, you must set your age limits filter to Do not show ads rated 13+ or stricter. Selecting one of these programs in your project settings will automatically configure the age designation setting to This app is directed to children under the age of 13, and set your age limits filter to Do not show ads rated 13+ or stricter. For more information on age rated content, see documentation on moderation.

Important: Apple requests documentation links demonstrating that the ad network (Unity) complies with the requirements outlined. You may provide a link to this section in the review notes of your submission. Unity does not provide legal advice. Therefore, the information on this page is not a substitute for reading the Apple App Store or Google Play guidelines, applicable publisher terms, or seeking your own legal counsel to determine the legal requirements of your business and processes, and how to address them.

Skipping rewarded ads

Compliance with kid-friendly programs requires that all monetized (rewarded) ads can be dismissed after 5 seconds. Please note that Rewarded Ad Units are not skippable by default. For information on changing this setting, see documentation on Ad Unit settings.

Acquire optimization

For publishers that also advertise with Unity, allowing Unity to collect revenue-optimizing data can increase Unified Auction campaign performance. Enabling this setting allows Unity to collect session data that enhances your Acquire campaigns, to better define the value of new users in your game and similar users from other games in Unity’s network.

To do so, ensure that your project has the Ads SDK installed, and an active Acquire campaign. Select CURRENT PROJECT > Settings from the secondary navigation menu, then scroll to Acquire Optimization and enable the setting for each platform.

Note: Unity recommends including an app-specific shared secret key for games on the Apple app store, so that Unity can verify subscription purchases. To locate your secret key:

  1. Sign in to your Apple developer account and select App Store Connect from the left navigation menu.
  2. Click Go to App Store Connect.
  3. On the App Store Connect page, click My Apps. If you don't have an app, click the + button to create a new app.
  4. Select In-App Purchases > Manage from the left navigation menu.
  5. Click App-Specific Shared Secret to display the key.
  6. Copy the key and paste it into your Acquire Optimization setting in the Monetization dashboard, in the App-Specific Shared Secret field for the Apple App Store.

Important: Acquire optimization is automatically disabled if your game-level COPPA designation is set to This app targets users under 13 years of age, or if you enable one or more selections from the app store compliance section.

For more information, reach out to your Unity representative.

Ad delivery status

The Enable ad delivery toggle allows you to temporarily stop serving ads to your application.

Test mode

Test mode allows you to test your integration without serving live ads. Use this setting to override programmatic settings on a device, by toggling Override client test mode, then checking Force test mode ON (i.e. use test ads) for all devices. It is important to enable test mode before testing integration to avoid getting flagged for fraud.