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.

Playables

Playable ads allow users to play a quick interactive demo of your game. See below for the playable requirements.

Managing creative packs

Creative packs are the set of files (creatives) that you use to create your ad campaign. This section describes how to work with creative packs and how to manage creatives.

  1. From the Apps page of the Acquire Dashboard, select or search to find the app that you want to manage. Apps page.

  2. The Campaigns page appears and displays all campaigns from this app. Apps2 page.

From the Campaigns page, click Creative packs from the left menu 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. (You can also manage creative files individually rather than as part of a creative pack.)

Adding new creative packs

When you click Create, you will be able to choose between Video & End card, and Playable.

Note: You can preload Creatives prior to creating creative packs, or you can add creatives as you create the creative pack.

Adding a new video or end card

From the Creative packs page:

  1. Click the Create button. Choose Video & End card.
  2. Enter a creative pack name.
  3. Upload end card or video assets or select Choose existing if this applies. Be sure to provide the information requested (to learn more, see creative asset specs.
  4. Click the Create button to progress.

    Adding a new end card or video.
  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)[#moderation] below). Also, the creatives used in this campaign will be available to easily be added to other creative packs.

Adding a new playable

From the Creative packs page:

  1. Click the Create button. Choose Playable. Note: If you don't see the control for adding playable ads, contact support.
  2. Enter a creative pack name.
  3. Upload playable assets. Be sure to provide the information requested (to learn more, see section on playable specs, below).
  4. Click the Create button to progress.

    Adding a new playable ad.

  5. Click upload to upload a file, or Add by URL to add a URL. Click the down arrow to toggle between Responsive and Portrait & landscape to indicate URL's based on the shape of the playable ad. (For example, for a square ad, choose responsive.)

    Adding a new playable ad via URLS.

  6. Select the playable language(s), then click the Create button again to save.

    Selecting playable 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.

Note: Playable ads are limited to 15 per month. If you need to upload more than 15 playable ads in a month, contact us.

Managing creatives

To easily keep track of multiple creatives, you can now upload them in bulk, simultaneously tracking many files, creative packs, and campaigns. You can preload files, easily fine tuning creative packs by mixing and matching files more dynamically.

Uploading multiple creatives at once

To upload multiple video and end card images, so that they are ready to assign to a future creative pack or campaign:

  1. From the Acquire dashboard, select the app that you want to associate with the creatives you are uploading.
  2. Click Creatives from the left menu.
  3. From the Creatives page, click Upload.
  4. Drag your creative files or browse your computer to upload the required creatives.

Note: If you are uploading end cards, both portrait and landscape end card types are required. Ensure that both a portrait version and landscape version are uploaded together. If only one end card type is uploaded by mistake, delete it, and re-upload it again with the missing end card type.

  1. Click Assign language to set a language for all creatives, or set a language for each creative individually if the language differs by creative.
  2. Click the Upload button to upload your creatives. Uploading.
  3. Click Back to Creatives to return to the Creatives page. Uploading Back

Note: If you see an error, check the following:

  • The end card must have the correct dimensions for portrait or landscape
  • End cards must be provided for both portrait or landscape version (e.g. if only a portrait end card was uploaded and not the respective landscape end card, an error occurs)

Managing uploaded creatives

Use the Creatives page to track of your creatives and their moderation status. Use the eye icon to preview creatives.

Creatives Page

Refer to the “Used in” column to learn:

  • Where creatives are used
  • Which creatives are the most commonly shared resource for campaigns
  • Which creatives may or may not be easily deleted because of their use in other creative packs

You can’t delete a creative from this page because a creative might be tied to multiple creative packs or several apps. See Deleting creatives.

Deleting creatives

If a creative is already used in one or more campaigns, you must delete the campaigns that use the creative before deleting the creative itself.

Follow these steps to delete a creative for an app:

  1. Find the creative you want to delete, then note where it is used.
  2. Follow these steps to delete the creative pack(s) that contain the creative.
  3. Once the creative packs associated with the creative have been deleted, click Creatives from the left navigation menu.
  4. From the Creatives page, select the creative you want to remove, and click Delete. If you are still not able to delete a creative, that means you have not yet removed all the creative packs that use this creative.

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.

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. To delete the creative, see the section above.

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 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.

See Playable Ads on Unity for best practices, technical basics, and requirements.

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.

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.
  • For more information and FAQs about playable ads, see Playable Ads on Unity .
Still need help? Get in touch!
Last updated on 29th Sep 2020