Knowledge base

Creative packs

Creative packs are the content of your ad campaigns. This article covers the following:

Creative asset specs

Important: Please review Unity's advertising content policy. Due to the sensitive nature of gambling ads across many of our publishers, Unity requires gambling advertisers to be managed accounts. Gambling creatives from unmanaged partners will be rejected in moderation. To become a managed partner or learn more about Unity's gambling ad policies, please contact us.

Videos

Video ad assets marketing your app. While only one video is required, uploading a video for each orientation yields better optimization. When a creative contains both, Unity’s valuation algorithm selects the best orientation to display.

  • 30 seconds or less.
  • H.264-encoded MP4 format.
  • 16:9 pixel ratio for landscape videos, or 9:16 pixel ratio for portrait videos.
  • Recommended file size is 10MB. Maximum file size is 100MB. Videos are re-encoded to be suitable for various bitrates. The final video shown will be optimized for the user's available network speed and cache settings.
  • (Apple only) Due to Apple requirements, Unity recommends only depicting the Apple app store logo. See Apple marketing guidelines for more information.

End cards

End cards are creative assets displayed at the end of an ad with a call to action for users to download the advertised product.

  • Use JPG, PNG, or GIF format.
  • Use one of the following dimension formats:
    • For square end cards, use 800 x 800 (1:1) pixel resolution.
    • Otherwise, use 800 x 600 (4:3) pixel resolution for landscape images and 600 x 800 (3:4) pixel resolution for portrait images.
  • (Apple only) Due to Apple requirements, Unity recommends only depicting the Apple app store logo on end cards for iOS videos. See Apple marketing guidelines for more information.

Note: Dynamic cropping may occur when using landscape and portrait images, to account for different device sizes. To avoid losing critical information, allow a 100-pixel buffer from the top and bottom edges of portrait images, or left and right edges for landscape images.

Managing creative packs

From the Acquire dashboard Campaigns page, click Manage creative packs to create, assign, unassign, and delete creative packs across your campaigns.

Creative packs page.

This Creative packs page displays a summary of all your creative packs, including their type, moderation status, and number of campaigns they’re assigned to. You can use the search bar to filter creatives, click any column heading to sort by attribute, or click the chevron to expand a creative’s details.

Adding new creative packs

From the Creative packs page:

  1. Click the Create button.
  2. Enter a creative pack name.
  3. Upload end card and video assets. Be sure to specify each asset's orientation (for more information, see section on creative asset specs, below).
  4. Click the Create button to progress.

    Adding a new creative pack.
  5. Select the end card and video languages, then click the Create button again to save.

    Selecting video and end card language.

Your new creative pack now appears in the campaign’s creative packs list with moderation Pending (see section on Moderation below).

Note: You can also add new creative packs from the campaign configuration page.

Moderation

All new creative packs undergo a human moderation process when their associated campaigns go live for the first time. Moderators ensure that creatives adhere to Unity's advertising content policies. They also age rate creatives according to app store publisher guidelines based on scary, violent, or otherwise inappropriate content for an age category. Publishers can filter the ads that show in their apps based on these ratings.

Rejections

If Unity rejects your creative pack, the status in the Moderation column will be Rejected.

For information on why Unity rejected a creative pack, hover over its name. Some examples include:

  • The creative content does not adhere to Unity’s advertising content policies (for example, it depicts adult content or drug use).
  • Scaling or UI elements break due to orientation change.
  • The ad doesn’t function or look okay when switching between portrait and landscape orientation.
  • The ad does not respect device lock actions. When a user locks a screen the sound should stop, then restart when the user unlocks the screen.
  • The creative does not respond to the physical mute button on iOS. Flipping this switch should activate and deactivate the sound.

If Unity rejects your creative, fix the issue, then submit it again. For detailed requirements, see section on creative asset specs, below.

Important: Due to the sensitive nature of gambling ads across many of our publishers, Unity requires gambling advertisers to be managed accounts. Gambling creatives from unmanaged partners will be rejected in moderation. To become a managed partner or learn more about Unity's gambling ad policies, please contact us.

Note: Campaigns must contain at least one approved creative pack to go live. If your live campaign includes a mix of approved and pending creative packs, the pending ones will automatically run once approved.

Creative pack details

From the Creative packs page, click any creative pack’s name, or its chevron icon, to expand its details. Click the overflow icon to rename or delete the pack.

Important: Before deleting a creative pack, please read the section on deleting creative packs below.

You can also click Show QR code to test how the ad appears on a mobile device.

Assigning creative packs

To assign creative packs to a campaign from the Creative packs page, select the creative pack(s) you want to assign, then click the Assign button.

Assigning creative packs to campaigns.

A list of available campaigns appears. You can assign more than one creative pack to a single campaign. When a campaign contains multiple creative packs, an algorithm determines the optimal one to show for each user. This means you don’t need to create multiple campaigns in order to run additional creative packs for the same campaign set-up. Multiple campaigns can share the same creative packs, as long as they’re for the same app. Check the campaign(s) you want to use with the selected creatives, then click Assign.

Selecting campaigns to link with creative packs.

On the Creative packs page, the Assigned to column reflects each creative pack’s number of associated campaigns. You can click this field to view the associated campaigns.

Unassigning creative packs

To unassign creative packs, follow the same steps for assignment, but click the Unassign button instead.

Important: If you attempt to unassign the only creative pack assigned to a campaign, you will receive a validation message, because deleting the creative pack will stop that campaign.

Deleting creative packs

To delete creative packs, select the pack(s) you want to delete, then click the Delete button.

Note: Deleting a creative pack does not delete the assets that comprise it. Any other creative packs that share the same assets will not be affected.

Upon deletion, the selected creative packs will no longer appear on the Creative packs page.

Important: If you attempt to delete the only creative pack assigned to a campaign, you will receive a validation message, because deleting the creative pack will stop that campaign.

Playable ads

Playable ads allow users to play a quick interactive demo of the game.

Requirements

Playable ads have the following required specifications:

  • Use a single HTML.index file.
  • The index.html file must be inlined, with no links to other files or folders.
  • The file must be minified (optimized for machine-reading by removing empty spaces).
  • The file must be under 5MB.
  • The ad must comply with Mobile Rich Media Ad Interface Definitions (MRAID) 2.0 guidelines.

In addition, Unity requires the following specifications outside of MRAID:

  • Android games must use Android version 4.4 or higher.
  • iOS games must use iOS version 8.0 or higher.
  • Ads should support both portrait and landscape orientations.
  • Ads should not need any network requests (XHR).
  • Ads should link directly to the app store using mraid.open.
  • Wait for the MRAID viewableChange event before starting the playable content.

Additional notes

  • The Unity Ads SDK controls the skippability of the ad.
  • Any start/view/click attribution is handled server-side.
  • A Unity Ads loading screen overlay will appear when the ad starts, and display for a minimum of 2 seconds. This allows for SDK initialization and prepares the player for the playable ad.

MRAID methods

MRAID is the common API for mobile rich media ads running in mobile apps. MRAID is injected by the Unity Ads webview, so you can use MRAID methods detailed in the guidelines.

The following methods are particularly useful for working with playable ads.

Linking to app store pages

Use the mraid.open method to link to the game's app store page.

case "Android":mraid.open("https://play.google.com/store/apps/details?id=yourgame"); break;

case "iOS":mraid.open("https://itunes.apple.com/us/yourgame?mt=8");

Bootstrapping

Use this method to wait for the SDK to become ready:

// Wait for the SDK to become ready: 
if (mraid.getState() === 'loading') {
    // If the SDK is still loading, add a listener for the 'ready' event:
    mraid.addEventListener('ready', onSdkReady); 
} else {
    // Otherwise, if the SDK is ready, execute your function:
    onSdkReady(); 
}

// Implement a function that shows the ad when it first renders:
function onSdkReady() {
    // The viewableChange event fires if the ad container's viewability status changes.
    // Add a listener for the viewabilityChange event, to handle pausing and resuming: 
    mraid.addEventListener('viewableChange', viewableChangeHandler);
    // The isViewable method returns whether the ad container is viewable on the screen.
    if (mraid.isViewable()) {
        // If the ad container is visible, play the ad:
        showMyAd(); 
    }
}

// Implement a function for executing the ad:
function showMyAd() {
    // Insert code for showing your playable ad. 
}

// Implement a function that handles pausing and resuming the ad based on visibility:
function viewableChangeHandler(viewable) {
    if(viewable) {
        // If the ad is viewable, show the ad:
        showMyAd(); 
    } else {
        // If not, pause the ad.
    }
}

Testing playable ad implementation

Unity provides an app for testing and debugging playables in a real ad unit, instead of a desktop browser or simulator.

To get started, download the test app for the appropriate platform, then follow the provided instructions.

Still need help? Get in touch!
Last updated on 2nd Jul 2020