Vungle Exchange OpenRTB 2.5 原生广告集成

使用本文,按照 Vungle Exchange OpenRTB 2.5 规范将原生广告集成到您的出价响应中。

原生广告文件类型

  图片(Liftoff Monetize SDK v.6.11) 视频(待定)
文件类型 - JPG - PNG - MP4 - MOV
文件大小 N/A N/A
平台 - iOS
- Android
N/A

支持的功能

我们支持 我们不支持

✓ 展示记录用native.eventtrackers (优选,请参考 IAB OpenRTB Dynamic Native Ads API
规范版本 1.2 ,第 5.8 节)

native.imptrackers[]用于记录展示

✓ 用于记录多方点击response.link.click trackers[]

🚫 native.jstracker用于展示记录

🚫 曝光跟踪

🚫 native.link.fallbackdeeplink回调;目前,我们仅支持link.url

🚫 主要图像资源类型是 GIF (您可以上传GIF,Vungle Exchange 会将其渲染为静态图像)

参与竞价的技术要求

资源

资源 类型 必需的? 评论
主图像 JPG 或 PNG Yes

1.91:1 尺寸(417x800 及更高)

应用程序名称/品牌 文本 Yes 25 个字符截断
应用程序图标/徽标 JPG 或 PNG Yes 最小 80x80
应用程序文本 文本 Yes 90 个字符截断
CTA文本 文本 No 15 个字符截断
CTA 跳转目标链接 网址 No  
星级评定 字符串 No 字符串形式的浮点数(例如“4.3”)
赞助文字 文本 No 25 个字符截断
隐私图标 JPG 或 PNG No  
隐私网址 网址 No  

资源ID

资产 ID 由 Vungle Exchange 在竞价请求中分配。 DSP 需要响应竞价请求中收到的资源 ID。

资源ID 必需的? Description
1 Yes 主图
3 No CTA 按钮 URL
4 No CTA文本
5 Yes 应用程序图标
6 Yes 应用程序标题
7 Yes 应用文字
8 No 应用程序评级
9 No 隐私图标
10 No 隐私网址
11 No 由...赞助

图片网址

图像 URL 必须包含正确的文件扩展名。

正确示例:

有效示例,具有正确的文件扩展名
"img\": {\"url\": \"https://s3.amazonaws.com/vungle2-cdn-qa/assets/525ec4576ca69a3b4100000d/69ae9b8bf69e08a5a9d29051083a5319.jpg\"}

无效示例:

无效示例,没有文件扩展名
"img\":{\"url\":\"https://p0.ipstatp.com/origin/ad-site-i18n-sg/202108265d0d6c301e92a3d3409abeb6\",\"w\":1200,\"h\":627}

点击后 URL(目标 URL)

根据 IAB OpenRTB 动态原生广告 API 规范版本 1.2 的第 5.1 节,始终在response.link对象中包含点击 URL(或目标 URL):

字段 Required 类型 Description
链接 Yes 目标

目的地址链接。这是广告的默认链接对象。单个资源还可以有一个链接对象,该链接对象在资源被激活(点击)时应用。如果资源没有链接对象,则应用父链接对象。

Vungle Exchange 还通过Asset ID =“3”(CTA 按钮 URL)支持点击 URL(或目标 URL)。
通过其他资源(例如图像、应用程序图标或应用程序标题)上传的点击 URL(或目标 URL)将被忽略。

开放式衡量

当开放衡量可用于给定出价请求时,Vungle Exchange 会将imp.native.request.eventtrackers设置为{"event":555,"methods":[2]}

竞价请求和竞价响应示例

竞价请求示例

竞价请求示例
{
    "id": "",
    "imp": [{
            "Id": "",
            "Native": {
                "Request": "{
                "Ver": "1.2",
                "Context": 1,
                "Assets": [{
                    "id": 1,
                    "required": 1,
                    "img": {
                        "type": 3
                    }
                }, {
                    "id": 3,
                    "required": 1,
                    "data": {
                        "type": 11
                    }
                }, {
                    "id": 4,
                    "required": 1,
                    "data": {
                        "type": 12,
                        "len": 15
                    }
                }, {
                    "id": 5,
                    "required": 1,
                    "img": {
                        "type": 1,
                        "wmin": 80,
                        "hmin": 80
                    }
                }, {
                    "id": 6,
                    "required": 1,
                    "title": {
                        "len": 25
                    }
                }, {
                    "id": 7,
                    "data": {
                        "type": 2,
                        "len": 90
                    }
                }, {
                    "id": 8,
                    "data": {
                        "type": 3
                    }
                }, {
                    "id": 9,
                    "required": 1,
                    "img": {
                        "type": 1,
                        "w": 120,
                        "h": 120
                    }
                }, {
                    "id": 10,
                    "required": 1,
                    "data": {
                        "type": 11
                    }
                }, {
                    "id": 11,
                    "required": 1,
                    "data": {
                        "type": 1,
                        "len": 25
                    }
                }],
                "Eventtrackers": [{
                    "event": 1,
                    "methods": [1, 2]
                }],
                "Privacy": 1
            }
            ",
            "api": [
                5
            ],
            "battr": [
                5
            ]
        }, "bidfloor": 0
    }], "at": 0
}

竞价响应示例

竞价响应示例
{
    "id": "61764c49a49aded968c7ef0d",
    "seatbid": [{
        "bid": [{
            "id": "12193",
            "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": "{"
            native ": {"
            link ": {"
            url ": "
            https: //itunes.apple.com/app/autorap-by-smule/id524299475?uo=5"},"assets": [{"id": 1,"required": 1,"img": {"url": "https://s3.amazonaws.com/vungle2-cdn-qa/assets/525ec4576ca69a3b4100000d/69ae9b8bf69e08a5a9d29051083a5319.gif"},"link": {"url": "https://itunes.apple.com/app/autorap-by-smule/id524299475?uo=5"}},{"id": 3,"required": 1,"data": {"value": "https://itunes.apple.com/app/autorap-by-smule/id524299475?uo=5"}},{"id": 4,"required": 1,"data": {"value": "cta text"}},{"id": 6,"required": 1,"title": {"text": "My App"}},{"id": 5,"required": 1,"img": {"url": "https://cdn-lb.vungle.com/assets/525ec4576ca69a3b4100000d/icon.png"},"link": {"url": "https://itunes.apple.com/app/autorap-by-smule/id524299475?uo=5"}},{"id": 7,"required": 1,"data": {"value": "my App text."}},{"id": 9,"required": 1,"img": {"url": "http://www.myads.com/privacy-icon.png"}},{"id": 10,"required": 1,"data": {"value": "PRIVACY_URL"}},{"id": 11,"required": 1,"data": {"value": "SPONSORED_BY"}},{"id": 8,"required": 1,"data": {"value": "APP_RATING."}}],"privacy": "http://www.myprivacyurl.com","eventtrackers":[{"event":1,"method":2,"url":"https://www.mytracker.com/tracker.js"}]}}",
                "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}"]
            }
        }]
    }],
    "bidid": "12193",
    "cur": "USD"
}

Questions?

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

这篇文章有帮助吗?