1. Vungle CN
  2. Vungle Exchange
  3. VAST, MRAID, and HTML Protocols

DSP 的 HTML 和 MRAID 广告素材提交指南

Avatar
Vungle Agent
关注

使用本指南在 Vungle Exchange 上投放HTML 和 MRAID 广告素材。

HTML 广告：支持的格式和文件类型

HTML 广告素材可以投放横幅广告格式（例如 320x50 和 MREC），也可以投放给全屏广告的结束页。有关结束页的更多信息，请参阅Vungle Exchange OpenRTB 2.5 EndCard 集成。

HTML 广告标记

HTML 广告标记可以采用以下形式：

  • 完整的 HTML 文档
  • JavaScript 代码片段
  • HTML 代码片段

素材文件类型

素材文件类型可包括：

  • PNG
  • JPG/JPEG
  • GIF（动画 GIF 将显示为静态图像）
  • Video

有关更多信息，请参阅Vungle Exchange OpenRTB 2.5 集成指南的横幅对象部分。

MRAID 点击需求

要将用户带到点击目标（例如，应用程序商店、应用程序或外部网站），请使用mraid.open （首选）或window.open打开目标 URL。不要使用window.location 。用户只能在与素材交互之后被带到外部目的地。

MRAID 广告：支持的格式和功能

对于全屏 MRAID 广告，Vungle Exchange 支持以下内容：

我们确实支持 我们不支持

✓ MRAID 2.0 标准中的静态广告

✓ MRAID 2.0 标准中无视频的可播放广告

🚫 MRAID 视频（使用 VAST 视频）

🚫自定义关闭按钮；调用useCustomClose()或在expandProperties对象中将useCustomClose设置为“true”都将被忽略

🚫 自定义隐私图标图像和 URL

🚫 包含 iFrame 的 MRAID 广告可能会导致技术问题

提交 MRAID 广告素材的要求

竞价者必须遵守Vungle Exchange OpenRTB 2.5 集成指南。

  • 要投放 MRAID 广告素材，请将以下字段和值对应添加到竟价响应的seatbid.bid.ext对象： "crtype": "MRAID 2.0" 。
  • 要投放 MRAID 可播放广告，除了传递"crtype": "MRAID 2.0"之外，您还必须根据IAB OpenRTB API 规范版本 2.5在seatbid.bid.attr中包含"attr": [13] 。

确定MRAID 播放的展示次数

对于包含横幅对象和视频对象的竞价请求，DSP 可以返回 MRAID 可播放内容。

如果展示机会是 如果投标请求包含 然后出价响应接受
全屏奖励

视频+横幅对象
和
battr不是“13”
  • VAST视频
  • 全屏MRAID
全屏插屏 视频+横幅对象
和
battr不是“13”
  • VAST视频
  • 全屏MRAID
全屏奖励 仅视频对象
  • 仅 VAST 视频
全屏插屏 只有视频对象
  • 仅 VAST 视频

确定允许奖励视频的展示次数

Vungle Exchange 目前在出价请求中使用以下字段来指示是否给广告奖励机会。

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

更多详细信息，请参阅Vungle Exchange OpenRTB 2.5 集成指南。

竞价请求示例

{
  "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
  }
}

竟价响应示例（MRAID 可播放）

在seatbid.bid.ext中包含"crtype": "MRAID 2.0" ，并在adm字段中包含 MRAID 2.0 标准广告标记。

{
  "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"
}

 

Questions?

Need further assistance, feel free to reach out to us, we’re here to help!

提交请求
这篇文章有帮助吗？