MRAID Creatives Submission Guidelines for DSPs

Vungle Agent

September 09, 2022 23:25

Use the guidelines in this article to serve MRAID playables for full screen impression on Liftoff Monetize.

As a bidder, you can target Liftoff Monetize full screen video inventory, which includes full screen interstitial videos and fullscreen rewarded videos, by using MRAID playables.

Supported Formats and Features of MRAID Ads

For full screen MRAID ads, the Liftoff Monetize SDK supports the following:

We DO support We do NOT Support

✓ Static ads in the MRAID 2.0 standard

✓ Playable ads without video in the MRAID 2.0 standard

✓ VAST videos

🚫 MRAID video (use VAST video)

🚫 Custom close buttons; calling useCustomClose() or setting useCustomClose to 'true' in the expandProperties object are both ignored

🚫 Custom privacy icon images and URLs

🚫 MRAID ads containing iFrames are likely to cause technical issues

Requirements to Submit an MRAID Creative

Bidders must be OpenRTB Version 2.5-compliant to access the Liftoff Monetize full screen inventory.

To serve an MRAID creative, add the following field:value pairing to the seatbid.bid.ext object of your bid response: "crtype": "MRAID 2.0".
To serve an MRAID playable ad, in addition to passing "crtype": "MRAID 2.0", you must also include "attr": [13] in the seatbid.bid.attr, as per the IAB OpenRTB API Specification Version 2.5.

Identify Impressions That Allow Playables

For bid requests containing both a banner object and a video object, a DSP can return:

A VAST video with an endcard (static resource / HTML resource), or

An MRAID playable, provided that '13' is not passed in the BidRequest.banner.battr. If battr = 13 is passed in the BidRequest.banner.battr, it means that this rewarded or interstitial placement blocks playable ads.

If the impression opportunity is	And if the Bid Request contains	Then the Bid Response Accepts
Full screen rewarded	Video + banner objects AND `battr` is not '13'	VAST video Full screen MRAID
Full screen interstitial	Video + banner objects AND `battr` is not '13'	VAST video Full screen MRAID
Full screen rewarded	Video object only	VAST video only
Full screen interstitial	Video object only	VAST video only

Identify Impressions That Allow Rewarded Video

Vungle Exchange currently uses the following field in the Bid Request to indicate whether an ad opportunity is rewarded.

"ext": {
          "skip": 0,
          "videotype": "rewarded",
          "rewarded": 1
}

Refer to Vungle Exchange OpenRTB 2.5 Integration Guide for more details.

Bid Request Example

{
  "id": "6142f149d8a5c775b2c9c146",
  "imp": [
    {
      "id": "1",
      "banner": {
        "format": [
          {
            "w": 828,
            "h": 1792
          }
        ],
        "pos": 7,
        "api": [
          5
        ],
        "vcm": 1
      },
      "video": {
        "mimes": [
          "video/mp4"
        ],
        "minduration": 0,
        "maxduration": 46,
        "protocols": [
          2,
          5
        ],
        "w": 828,
        "h": 1792,
        "placement": 5,
        "linearity": 1,
        "minbitrate": 250,
        "maxbitrate": 15000,
        "boxingallowed": 1,
        "playbackmethod": [
          1,
          2,
          3,
          4
        ],
        "delivery": [
          2,
          1
        ],
        "pos": 7,
        "api": [
          7
        ],
        "companiontype": [
          1,
          2
        ],
        "ext": {
          "skip": 0,
          "videotype": "rewarded",
          "rewarded": 1
        }
      },
      "displaymanager": "Vungle",
      "displaymanagerver": "6.11.0",
      "instl": 1,
      "tagid": "THIRD_PARTY_PLAYABLE_REWARDED_ATTR_13",
      "bidfloor": 1,
      "bidfloorcur": "USD",
      "secure": 1,
      "ext": {
        "openrtb25x": {
          "skip": 0
        },
        "metric": [
          {
            "type": "viewability",
            "vendor": "moat"
          }
        ],
        "skadn": {
          "version": "2.2",
          "versions": [
            "2.0",
            "2.2"
          ],
          "sourceapp": "1131184101",
          "skadnetids": []
        },
        "deeplink": 1
      }
    }
  ],
  "app": {
    "id": "59786bc2a43b3a08620026b1",
    "name": "彩红竞猜1",
    "bundle": "1131184101",
    "storeurl": "https://itunes.apple.com/cn/app/id1131184101",
    "cat": [
      "IAB1",
      "IAB9"
    ],
    "ver": "369",
    "privacypolicy": 1,
    "publisher": {
      "id": "597565c6c5511a1b62000990",
      "cat": [
        "IAB1",
        "IAB9"
      ]
    },
    "keywords": "app,account,managed"
  },
  "device": {
    "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 12_4 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148",
    "geo": {
      "lat": -33.8591,
      "lon": 151.2002,
      "type": 2,
      "ipservice": 3,
      "country": "AUS",
      "region": "NSW",
      "city": "Sydney",
      "zip": "2000"
    },
    "dnt": 0,
    "lmt": 0,
    "ip": "45.117.100.153",
    "devicetype": 4,
    "make": "Apple",
    "model": "iPhone",
    "os": "iOS",
    "osv": "14.5",
    "hwv": "SE (2nd generation)",
    "h": 1792,
    "w": 828,
    "language": "en",
    "carrier": "T-Mobile",
    "connectiontype": 2,
    "ifa": "4423DD36-2738-46DC-84D1-02A47F95320D1",
    "dpidsha1": "5187c3f5db2870fd13455ff40d84235788c8750a"
  },
  "user": {
    "ext": {
      "consent": 1
    }
  },
  "at": 1,
  "tmax": 1500,
  "cur": [
    "USD"
  ],
  "bcat": [
    "IAB7-3",
    "IAB7-5",
    "IAB7-28",
    "IAB7-29",
    "IAB7-30",
    "IAB7-39",
    "IAB7-41",
    "IAB7-42",
    "IAB8-5",
    "IAB8-18",
    "IAB9-9",
    "IAB11",
    "IAB14-2",
    "IAB14-3",
    "IAB14-4",
    "IAB14-8",
    "IAB18-2",
    "IAB23",
    "IAB25-1",
    "IAB25-2",
    "IAB25-3",
    "IAB25-4",
    "IAB25-5",
    "IAB25-6",
    "IAB26"
  ],
  "badv": [
    "domain2.com",
    "domain3.com",
    "domain4.com"
  ],
  "bapp": [
    "618783545"
  ],
  "source": {
    "ext": {
      "schain": {
        "complete": 1,
        "nodes": [
          {
            "asi": "vungle.com",
            "sid": "597565c6c5511a1b62000990",
            "rid": "6142f149d8a5c775b2c9c146",
            "name": "乐世胜豪",
            "hp": 1
          }
        ],
        "ver": "1.0"
      }
    }
  },
  "regs": {
    "coppa": 1,
    "ext": {
      "gdpr": 0,
      "us_privacy": "1-N-"
    }
  },
  "ext": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "vungle.com",
          "sid": "597565c6c5511a1b62000990",
          "rid": "6142f149d8a5c775b2c9c146",
          "name": "乐世胜豪",
          "hp": 1
        }
      ],
      "ver": "1.0"
    },
    "moat_sdk": 1
  }
}

Bid Response Example (MRAID Playable)

Include "crtype": "MRAID 2.0" in the seatbid.bid.ext, and include an MRAID 2.0 standard ad markup in the adm field.

{
  "id": "614abfbfc92e1f61f41c712c",
  "seatbid": [
    {
      "bid": [
        {
          "id": "8",
          "impid": "1",
          "price": 98,
          "nurl": "http://kraken-ext1-apiqa-kraken.apiqa.svc.cluster.local:7700/win?price=${AUCTION_PRICE}",
          "burl": "http://kraken-apiqa-kraken.apiqa.svc.cluster.local:7700/win?aid=kraken-test-aid&impid=kraken-test-impid&price=100.001",
          "lurl": "http://kraken-qa1-apiqa-kraken.apiqa.svc.cluster.local:7700/lurl",
          "adm": "",
          "adomain": [
            "domain1.com"
          ],
          "bundle": "bundleid",
          "cat": [
            "Movies",
            "Music"
          ],
          "api": 7,
          "ext": {
            "skadn": {
              "version": "2.0",
              "network": "cDkw7geQsH.skadnetwork",
              "campaign": "45",
              "itunesitem": "880047117",
              "nonce": "473b1a16-b4ef-43ad-9591-fcf3aefa82a7",
              "sourceapp": "123456789",
              "timestamp": "1594406341",
              "signature": "MEQCIEQlmZRNfYzK",
              "ext": {}
            },
            "deeplink": "zalora://my//seg_s/m/",
            "imptrackers": [
              "https://us-event.app-install.bid/rtb/impr?id=123",
              "https://us-event.app-install.bid/rtb/impr?id=YnRyAgMAAAF6dACeAwAGRREAAAAwHZlv1LjyQ6eKNFvVILh75gACdXMB&price=${AUCTION_PRICE}"
            ],
            "crtype": "MRAID 2.0"
          }
        }
      ]
    }
  ],
  "bidid": "8",
  "cur": "USD"
}