Orders Tab: Manage Creatives

A creative, sometimes referred to as a tag, is the actual ad that the user sees—the combination of code and assets that constitutes a single ad experience. The creative used for an ad is either provided by a third party (via MoPub Marketplace or an Ad Network), or directly set up by the publisher. This article discusses the Direct-Serve creative set up directly by the publisher within the MoPub UI. The creative code is sent to the SDK to be rendered for the ad. The types of uploads we support depend on the format of the ad.

Creatives exist within the context of a line item, and apply only for line item types where you act as both the publisher and the advertiser (Guaranteed, Non-Guaranteed, Promotional, and Backfill Promotional). To work with creative, you must first have created an order and a line item. You can then manage creatives from the Line Items page of the Orders tab as follows:

Add a Creative

  1. Navigate to the New Creative page in one of two ways:

    • Create a new line item of the type ‘Guaranteed’, ‘Non-Guaranteed’, ‘Promotional’, or ‘Backfill Promotional’. Once you’ve specified all the settings for your new line item and click Save, the New Creative page displays.

    • Navigate to the Line Item Details page in the Orders tab by clicking on an existing order to view its details, and clicking on a line item (again, only of the type ‘Guaranteed’, ‘Non-Guaranteed’, ‘Promotional’, or ‘Backfill Promotional’) to view its details. In the Line Item Details page, click on the Creatives tab, and click New Creative.

      Line Item Details Page: Creatives Tab Creatives in the Line Item Details Page

  2. In the New Creative page, enter a name for your creative, and then specify the ad format.

    New Creative Ad Format

  3. Provide the creative type (Image, VAST Video, or HTML) as described in each corresponding section.

    The ad format you specified in the previous step determines which creative types you can upload.

    Ad Format Creative Types Supported
    320 x 50 (Banner) Image, HTML
    300 x 250 (MRect) Image, HTML
    728 x 90 (Tablet Leaderboard) Image, HTML
    160 x 600 (Tablet Skyscraper) Image, HTML
    Custom Image, HTML
    Phone Full Screen Image, VAST Video, HTML
    Tablet Full Screen Image, VAST Video, HTML
    Native Image, VAST Video
    Rewarded Video VAST Video
  4. Provide additional information based on the ad format and creative type.

    • Some creative types (image and HTML) have dedicated fields for Click URL and Impression Tracking URL, whereas for VAST creatives, you enter that information in your XML. In either case, refer to the list of supported macros below for the macros we support in your URLs.

    • For your Click URL, MoPub provides a default MoPub in-app browser, but we also provide a native browser click scheme to force the click destination of ads to occur within the device’s native browser if you prefer. Refer to the Native Browser Click Support section below.

    • If you are adding a creative for a Native ad format, we provide two interfaces for setup. One is the Easy Format interface, shown below, for less technical users who prefer a UI experience; the other way to set up your creative is the Manual JSON format, which enables developers to enter raw JSON.

      Easy Form
      New Creative: Native Ad Format, Easy Form
      Manual JSON
      New Creative: Native Ad Format, Manual JSON Entry

      In either case, optionally provide Title, Text, and call-to-action (CTA) Text, plus any custom fields you want to add. Provide a still Icon Image and Main Image, plus any custom images you want to add. Then refer to our documentation for Android Native ads, Android Native Video ads, iOS Native Ads, and iOS Native Video Ads to learn how to integrate custom fields on the backend, on the SDK side.

  5. Click Save.

Image Creatives

Image creatives accept a still image file. This is the most common creative format.

Image Creative Type

HTML Creatives

HTML creatives accept HTML/JavaScript.

HTML Creative Type

The two flavors of HTML creatives are:

  • Plain HTML: These are HTML/JavaScript ads that do not leverage the MRAID API.

  • MRAID: These ads leverage the Mobile Rich Media Ad Interface Definitions (MRAID) API. This is a standardized set of commands, designed to work with HTML5 and JavaScript, that developers use to communicate how rich media ads render. Select the MRAID option if your creative was built using MRAID.

VAST Video Creatives

The Video Ad Serving Template (VAST) specification is a universal XML schema for serving ads that communicates specifics about their rendering. Refer to our Video ad format documentation for VAST format specifications.

If you have selected the Interstitial or Rewarded Video ad format, indicate whether the VAST creative is to run in Portrait or Landscape mode.

Provide your creative by pasting valid VAST XML into the VAST XML input field. You can provide either inline XML or an XML wrapper. To do so, select the VAST XML option and paste in the XML.

VAST Creative Type: XML

If your VAST creative consists only of a URL instead of VAST XML, select the VAST Tag URL option, paste in the URL, and we will convert it to an XML wrapper for you.

VAST Creative Type: URL

Supported Macros for Tracking URLs

MoPub supports the following macros:

Type Macro
Ad Group ID %eaid!
Ad Unit ID %%ADUNITID%%
Bundle ID %%BUNDLE%%
Cache Buster %%CACHEBUSTER%%
Click URL (escaped) %%CLICK_URL_ESC%%
Click URL (unescaped) %%CLICK_URL_UNESC%%
Creative ID %ecid!
Destination URL (double-escaped) %%DEST_URL_ESC_ESC%%
Destination URL (escaped) %%DEST_URL_ESC%%
Destination URL (unescaped) %%DEST_URL%%
Device ID %eudid!
Do Not Track %%DNT%%
IP Address %%IPADDRESS%%
Keywords %%KEYWORDS%%
Keywords (specific key) %%KEYWORD:[key]%%
Latitude %%LATITUDE%%
Longitude %%LONGITUDE%%
Placement ID (App ID) %%PLACEMENTID%%
Request ID %%REQUESTID%%
User Agent %%USERAGENT%%

Some notes about macros:

  • If you’re passing over key-value pairs, you can set a macro to return the value for a particular key using the %%KEYWORD:[key]%% macro. For example, if you’re passing over “gender:male,age:24” as your keywords, you can use the %%KEYWORD:age%% macro to pass the age into your ad. %%KEYWORD:age%% will be replaced with ‘24’.

  • Cachebusters are noted by &ord= parameters. The %%CACHEBUSTER%% macro returns UNIX timestamp in milliseconds.

  • If your HTML ad is using an anchor tag (<a href>) or window.location redirect, our SDK automatically tracks clicks.

  • Device IDs can be one of the following: IDFA, Android Advertising ID (if Google Play Services is integrated), or SHA1 Hashed Android ID.

  • The %%DNT%% macro returns ‘0’ for no opt out or ‘1’ for opt out (do not track).

  • The Request ID is a unique ID assigned to each ad request.

Native Browser Click Support

The default click-through behavior is to open the landing page in the MoPub in-app browser; however, you can configure the click-through URL to use the click-destination scheme to open in the device’s native browser. To do this, prepend the click-destination scheme before the destination URL. Make sure the URL you enter after the click-destination scheme is URL-encoded.

For example:

mopubnativebrowser://navigate?url=http%3A%2F%2Fwww.mopub.com

Analyze, Edit, and Delete Creatives

Referring to the image of the Line Item Details page: Creatives tab, you can analyze and manipulate your creatives much like you can with your orders or line items:

  • Disable or enable the creative item by togging the Enabled switch in its row.

  • Preview the creative’s assets by hovering over the Preview link in its row.

  • Filter the creatives list by specifying a creative by name (start typing the creative name in the Find creatives box).

  • Filter the creatives by Status, by selecting ‘All Statuses’, ‘Enabled’, or ‘Disabled’ from the drop list.

  • Specify the desired time period in the calendar window.

  • Sort the creatives in ascending or descending order of any of the metrics as well. The metrics shown for your creatives are updated based on your filter criteria. These metrics include Impressions, Clicks, and CTR.

  • Edit an existing creative by clicking on its name. The same page you filled out when you first added the creative appears. There, you cannot alter the creative’s Format and Creative Type fields, but you can edit its particulars, such as its Name, Click URL, Impression Tracking URL. You can also replace its assets (such as its Image File).

  • You can delete the creative from the edit screen by clicking Delete Creative in the lower left corner.

Last updated September 12, 2019

TWITTER, MOPUB, and the Bird logo are trademarks of Twitter, Inc. or its affiliates. All third party logos and trademarks included are the property of their respective owners.

© 2019 MoPub (a division of Twitter, Inc.)