响应区
广告投放 API 响应 JSON 包含区域数组以及 renderers 和 user 对象。
在本页中,我们将解释 zones 数组,该数组包含与赢得广告请求的广告有关的所有详细信息。
该数组包含一个对象,其中包含所请求的每个区域 ID 的广告数据。
| 财产 | 说明 |
|---|---|
| idzone | 广告区域的 ID。 |
| 类型 | 使用的广告格式,如 "横幅广告"。 |
| 数据 | 广告数据(对象) |
下面是根据可用广告格式返回的每个 data 对象属性的详细列表。
旗帜
| 财产 | 说明 |
|---|---|
| 网址 | 广告指向的 URL。 |
| 印象 | 印象 URL |
| 图像 | 为广告上传的原始图片。 |
| 最佳图像 | 如果上传的创意是 GIF 动画,则这是为在广告中使用而创建的优化 MP4 版本。 |
| 宽度 | 广告的宽度(像素)。 |
| 高度 | 广告高度(像素)。 |
| 媒体 | 这显示了横幅的类型:图像、HTML 或视频:应分别为 "img_banner"、"html_banner "或 "vide_banner"。 |
横幅响应示例
图像横幅:
{
"zones": [
{
"idzone": 1111111,
"type": "banner",
"data": {
"url": "http://main.example.com/click.php?data=H4sIAAAAAAAAAyVOu04DMRD8lTRprX14bW9JQ0PBN6xzPlGAgCToQJqPx7nTTrGa0TxOyELNnKCJuWX3yqpVBW_3.9ftrE9neZ7Yti3FekuXzw8ABHBhKmoujuUa33H9O0RJ3JJkSmxALs3YJUNrqbkYjNpkGQKWmWIFUKJfMQI_UqMvY20_jukTVOZVuXr3EcrlYqNXW6lHjl6G1t3T32PiGEbzTtjp46Y7F27Hp1ltHz.JXZ31j96M1xdQzRbNJbxE1EJhbfWL8bLQCBvyD4rI3QwpAQAA",
"impression": "http://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAAzVPS05DMQy8Chdo5PEnn+5YsGCL4ADJa7ICIYqQiuTD4z5ax9HEI2fGZmIcCAfoA7Wj8ZGac0JNrJRg/vz66Ao/nftXP/9+p+3zw3NRLbhDVZFcXErU2dyoujJVa+Saq6GxOtjZLTt5EBxAiUiAqq0ViBRhB5E/vb3sF47EDMQvIbqwUVDXUVBrQraUEzRkw+oqdiHv4zRX/WlegCUobbTZBXmzOYotGl37yFNKCJGP9x65L0P/J4nlcHW+Ex4imsPh9hYV8wjynYnY98Gte81yosm2lswFmW2jPBsv07YQw/0B+rSsfmgBAAA=",
"image": "http://example.com/library/328752/47de5c021bd0d00b59ff78456c69f601baac9925.gif",
"optimum_image": "http://example.com/library/328752/c990e4df40cc46482927c08350b2c960a59679e5.mp4",
"width": 300,
"height": 250,
"media": "img_banner"
}
}
]
}
HTML 横幅:
{
"zones": [
{
"idzone": 2222222,
"type": "banner",
"data": {
"html": "\n<div id=\"example_id\">\nExample HTML Ad!\n</div>\n",
"impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAAz1OW2oDMQy8Si8Qo7Fky8p3+18IPYDteqGwJYGkkA8dvt7dUj1AjGY0ihRxIpwgL2Rn4XMiR0khRg0REsDF3y7vTn4b69f9tv7cw+PqauxJPGWPouIgN1h2jazFET1uK3I2cGZLc6RApMmN/OPyujdmxikpzwkCuw1KCcgp5ACRqZqnnZ5T7QosDLVmozJyT6NpWqhVqS0P1o3oba2zQr9+b46Hq8hh9Ac4M2cjHDMAY/YZ5DsyY//8n11qtiy0LJU/e2Xl0a3FUqlq70q/g8aBP0ABAAA=",
"width": 300,
"height": 250,
"media": "html_banner"
}
}
]
}
视频横幅:
{
"zones": [
{
"idzone": 4444444,
"type": "banner",
"data": {
"url": "http://main.example.com/click.php?data=H4sIAAAAAAAAAyVPy4rbQBD8lb34GNHz1Oi4EBaDHe3itWRHt3kpWWLNjGTJOKE_PmOZbuimqruKekFOQVaMIxTA8Pc8p.uGvW7oW.45LlNhdPhlpngtbBweMHv7chv23d.jvXzZP2RDpU1DRmJ0H9vabD.O.23dlFdqxv1kktasIfTcfpK_yxwvy.AO.93ox5Y08zR24bgMwf2QLUyTTok1x1ND_p2WOFxjiqPbyQ6mdP5cLs.jdO6kMeoUFtfV9f1Qdy65WzjU56m9pa6971M4hnS.HX7KlgbqA7U.9uw9K.X3cWRZym7p6zdEBEQiCUgOgjJMcQox.EdQpAVRBeVQEIHIZVkJkICsUhVwiQJURglSJDSLEEQGcKfisWZNbZzv1VKhEpkvCekZKStTec2ItMKbUvRgNNdGelauP.aic6_W2Q6yq2JQEXzBlX5WVuGSqOfGOBNrhAysrJDr4Pi.Q2l6kB6ctbLKNlaUXnvOcwiheleq__CkLqj3AQAA",
"impression": "http://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAAz1PSU4DQQz8Ch9Iq7x1u3NDIgeuQB7Qk+k5QYKQkHLw47FGEbYP5a3KZjAdQAfSJ6Ij/KgSXMgLKwpZvH48h1J8336ut+ssl9tXsFUWjwYR9vBmaB7SvUNrGDyUUbtoaG3dUBHEwUGBcEuIkILTwTKL0/ktzu8vgeLkLWc4BLiz5dKuTe6FqpVaSDWz0NzHHTGWdW7+26MRbUKtL30OoXqxuTTbsAwdS53SduHlc2Ts5yPvQn7mgp6tgqq8C+PhSaY1lR5YVCzSEHslzer/bJLZ2upl+jbHyoJGa9u20W0Mn75Y+wNJJUoPYQEAAA==",
"video": "http://static.example.com/library/256238/906f02361f3cd12043514304c777ed489599f637.mp4",
"width": 300,
"height": 250,
"media": "video_banner"
}
}
]
}
粘贴式横幅
| 财产 | 说明 |
|---|---|
| 网址 | 点击 URL |
| 印象 | 印象 URL |
| 图像 | 为广告上传的原始图片。 |
| 最佳图像 | 在粘贴横幅广告中,如果上传的创意是 GIF 动画,那么这就是为广告创建的优化 MP4 版本。 |
| 宽度 | 广告的宽度(像素)。 |
| 高度 | 广告高度(像素)。 |
| 频率周期 | 广告显示的频率(分钟)。 |
| v_pos | 广告的垂直位置。 |
| h_pos | 广告的水平位置。 |
| 媒体 | 这显示了横幅的类型:图像、HTML 或视频:应分别为 "img_banner"、"html_banner "或 "vide_banner"。 |
粘贴式横幅响应示例
{
"zones": [
{
"idzone": 4204610,
"type": "sticky_banner",
"data": {
"url": "http://main.example.com/click.php?data=H4sIAAAAAAAAAz1Qy4rbQBD8FV98jOie9xwNy.LgzVokkmx808tsQLIeI4Ex_fHpsZPQA1NVU11NjxIejXAEiaavZRnDVu624p3P_VsIX0k99JHK94Bb.QYaPJitMB2TZv69MAyCsXLWopIicsl86LhezSYoFqT3xvjIdLQLUAYhUsv0e7aL0DFs74yWOUYMTbr_rPZp9rH_zG0Q1XTRZanHcy7EKcshW7vm58dhaqcC82WeLrds7W9NcTIFzHM5jjLPTjk.TuvQh2EcpuZgLjCP51_c.COaxvMx9L3i5xVW.Rj6GScJYVIdPMYHzHIIzcFmNs3sMc1Tezt2nFFgUcWQN7sjAkKDyngHUtL_rUkk6BKhIEFN__6G_m5NGhyRQhKEggO0IQlwF5qzmBI5zbpFvEq0vvJtKdHUuq2svkJVqrIyrbRPb9WVfJ4TmQFtXsKGhQ09HbE4hue6F5JKaopuBa8eHh8v5DoeyLSqFhbKuuaNjPMtz1etr5pKOrTX.g.ZmJDwMAIAAA--",
"impression": "http://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAAzVOO25DMQy7Si8QQ3/L2Qp06dz2AParPaXImkGHj56LiDJEEJRFAsIL8AXoDeGKfFUOKuiFBApqfH6/h2Dcb4ly3P+CyatSUHOpHtyaWQshEEMIBU/e0Cin14rCFJjuUAsI1+QQpy9+vj72wxM1GOBBKeO+iO4FTYsVFAk55Vx7nKsVcTHWNtrsjHboHFUXjC592OS6rePWs3de+EcB9/MUvYTITzKzvzgLa2RBbCVrR34BY/2uLofrmg3XRGudh1uVCXosPOgJ0ouJzUoBAAA=",
"image": "http://example.com/library/328752/47de5c021bd0d00b59ff78456c69f601baac9925.gif",
"optimum_image": "http://example.com/library/328752/c990e4df40cc46482927c08350b2c960a59679e5.mp4",
"width": 300,
"height": 250,
"frequency_period": 1440,
"v_pos": "top",
"h_pos": "left",
"media": "img_banner"
}
}
]
}
即时信息
| 财产 | 说明 |
|---|---|
| 网址 | 点击 URL |
| 印象 | 印象 URL |
| 图像 | 图像的 URL |
| 最佳图像 | 如果上传的创意是 GIF 动画,则这是为在广告中使用而创建的优化 MP4 版本。 |
| 宽度 | 广告的宽度(像素)。 |
| 高度 | 广告高度(像素)。 |
| 频率周期 | 广告显示频率(分钟)。 |
| 媒体 | 这显示了使用的横幅类型:图像、HTML 或视频:应分别为 "img_banner"、"html_banner "或 "vide_banner"。 |
即时信息回复示例
{
"zones": [
{
"idzone": 4031007,
"type": "instant_message",
"data": {
"url": "https://main.example.com/click.php?data=H4sIAAAAAAAAA01Oy2oDMQz8lVxyXSTLtuxjLrn00G_wQ0uhDQmbBEqZj6.6uZQZJJiRRjogUi2UBUz4eDxu96OcjuHs7JvNZVwvAAjgTBJKUE74se16a9vnboaFyxIiLW4gxixclT1UmEiRmF1lBHDwlJSBkOibE4EdaH3aWp4VJfmAMq_CWnu1JpxHsq5ppd5i69lEfYPQv5rz9Rg5Dtjl_3gZe_GLfy3i_Q0tyZrFyuxT2KKFMWqfJKIjTx3yC41GCKIMAQAA",
"impression": "https://syndication.example.com/cimp.php?t=imp&data=H4sIAAAAAAAAA01OQWrEMAz8Sj8QM5Jly9lzf1AKucppcmnLloXCUubxdbIUqpFgJEbSKBSTYFJ5QrtIu+RCTdKSGpIULstCE/5st+tX3N7Tev1kVqlOy2rZWa3g6JAFcBaRweeGmmlWs8wuFKWyVIKtDA4iQejg68vzWUPCSi24S8Hgx1dBMk3DxNDbmOEORn/b9vY900X2LD73eYssdS1b97Kjh0Wv27B1bPWPGHlaxgNJ1c5b/zA92hHgHzu9gjNE1zC4eoS59xY1AmsvHq6mv8/Xp409AQAA",
"image": "https://static.example.com/library/32167/30faa1b47960b066dbc594e9251fbedf2349192e.jpg",
"optimum_image": "http://static.example.com/library/428515/d17db557c0761f48323156f47fd53dc3de393806.mp4",
"width": 250,
"height": 150,
"frequency_period": 1440,
"media": "img_banner"
}
}
]
}
原生广告
当响应返回本地广告时,zones.data 将返回两个对象: 布局和广告项目
data.layout
| 财产 | 说明 |
|---|---|
| widgetHeaderContentHtml | 显示 "Powered by "品牌的 URL*。 |
| 品牌标识 | 品牌徽标的 URL(如果启用)*。 |
| 品牌标识 | 品牌标识的 URL,当用户将鼠标悬停在该标识上时就会显示。 |
| itemsPerRow | 小工具每一行显示的广告数量。 |
| itemsPerCol | 在 widget 的每一列中显示的广告数量。 |
| font_family | 广告中使用的字体系列。 |
| 标题字体大小 | 品牌标题中使用的字体大小。 |
| 标题字体颜色 | 品牌标题中使用的字体颜色。 |
| widget_background_color | 部件背景色的十六进制代码。 |
| widget_width | 整个 widget 的宽度。 |
| 全尺寸布局的最小宽度 | 全尺寸布局的最小宽度,单位为像素。 |
| item_height | 每个广告的高度。 |
| item_padding | 每个广告之间的填充物。 |
| 图像高度 | 每个广告中图片的高度。 |
| 图像宽度 | 每个广告中图片的宽度。 |
| text_margin_top | 文本顶部边距的大小(像素)。 |
| 文本边距 | 文本下边距的大小(像素)。 |
| 文本左边框 | 文本左边距的大小(像素)。 |
| 文本右边距 | 文本右边距的大小(像素)。 |
| 标题字体大小 | 每个广告标题的字体大小。 |
| 标题字体颜色 | 每个广告标题的字体颜色。 |
| 标题字体权重 | 每个广告标题的字体重量。 |
| 标题装饰 | 标题是否有下划线。 |
| 标题颜色 | 悬停标题时的字体颜色。 |
| 标题上的字体权重 | 悬停标题时的字体重量。 |
| 标题悬挂装饰 | 标题是否在悬停时加下划线。 |
| 描述字体大小 | 每个广告描述的字体大小。 |
| 字体颜色 | 每个广告描述的字体颜色。 |
| 描述字体重量 | 每个广告描述的字体权重。 |
| 描述_装饰 | 描述是否有下划线。 |
| 描述悬停颜色 | 将鼠标悬停在描述上时的字体颜色。 |
| description_hover_font_weight | 将鼠标悬停在描述上时的字体重量。 |
| description_hover_decoration | 悬停时是否在描述下划线。 |
| 在新窗口中打开 | 点击广告时是否应在新窗口中打开。1=是,0=否。 |
| 移动响应式类型 | 使用移动设备时的响应类型(即无或紧凑)。1=紧凑,0=无。 |
| 页眉位于顶部 | 品牌标识应显示在广告上方还是下方。1=是,0=否。 |
| 页眉文本对齐 | 品牌标题的水平对齐方式。 |
| 已启用标题 | 标题是否启用。1=是,0=否。 |
| 已启用描述 | 是否启用说明。1=是,0=否。 |
| 图像边框大小 | 图像边框的像素大小。 |
| 图像边框颜色 | 图像边框的十六进制编码颜色。 |
| text_align | 文本的对齐方式:左对齐、居中对齐或右对齐。 |
| 已启用自定义 css | 是否启用自定义 css。1=是,0=否。 |
| 自定义 | 如果启用,自定义 css 将在此处显示。 |
| 已启用标题 | 是否启用页眉。1=是,0=否。 |
| 移动断点 | 广告区域的台式机和手机视图之间的分界点(以像素为单位)。 |
| spacing_v | 广告之间的垂直间距(像素),在 "高级选项 "中设置。 |
| spacing_h | 广告之间的水平间距(像素),在 "高级选项 "中设置。 |
| 放大 | 广告是否应在悬停时放大/缩小。 |
| 移动箭头 | 移动 widget 中广告的行数。 |
| 移动多列 | 移动 widget 中的广告列数。 |
| USE_V2_Script | 广告区是用较新的 V2 设置还是较旧的 v1 设置创建的。 |
| 已启用文本 | 是否显示文本标题和描述。1=是,0=否。 |
| 移动图片宽度 | 移动设备上每个广告中图片的宽度。 |
| 移动文本框大小 | 移动设备上文本框的大小。有效范围为 50-500。 |
| 已启用移动文本 | 标题是否在手机上启用。1=是,0=否。 |
| 移动文本位置 | 文字在移动设备上的位置:底部或右侧。 |
| 项目每边的间距 | 广告两侧的填充物,如果它们是使用旧版 v1 设置的话。 |
| 文本位置 | 文字是放在左侧还是右侧。 |
| 文本框大小 | 文本框的大小(像素)。范围 50-500。 |
| widget_height | 整个 widget 的高度。 |
| 已启用品牌 | 是否启用品牌标识。 |
| 品牌字体大小 | 品牌的字体大小。 |
| 品牌字体颜色 | 品牌的字体颜色。 |
| 品牌字体重量 | 品牌的字体重量。 |
| 品牌装饰 | 字体是否有下划线。 |
| 移动图片高度 | 移动设备上每个广告中图片的高度。 |
| 出版商广告类型 | 这是哪种类型的原生广告,即推荐、退出或插播:native-recommendation(原生推荐)、native-interstitial(原生插播)。 |
data.ad_items
| 财产 | 说明 |
|---|---|
| 图像 | 为广告上传的原始图片。 |
| 网址 | 点击 URL |
| 印象 | 印象 URL |
| 标题 | 广告标题文字。 |
| 描述 | 广告描述文字。 |
| 品牌 | 广告的品牌文字。 |
| 原始URL | 登陆页面的原始网址。 |
| 图像位置 | 广告图片的位置(如何裁剪图片)。 |
原生广告响应示例
{
"zones": [
{
"idzone": 4058715,
"type": "native_ad",
"data": {
"layout": {
"widgetHeaderContentHtml": "<a target=\"_blank\" href=\"https://www.exoclick.com\" rel=\"nofollow\">Powered By <span></span></a>",
"branding_logo": "//static.example.com/widget-branding-logo.png",
"branding_logo_hover": "//static.example.com/widget-branding-logo-hover.png",
"itemsPerRow": 4,
"itemsPerCol": 1,
"font_family": "Arial, Helvetica, Verdana, sans-serif",
"header_font_size": "12px",
"header_font_color": "#999999",
"widget_background_color": "transparent",
"widget_width": "1830px",
"minimum_width_for_full_sized_layout": "450px",
"item_height": "300px",
"item_padding": "10px",
"image_height": "450px",
"image_width": "450px",
"text_margin_top": "3px",
"text_margin_bottom": "3px",
"text_margin_left": "0px",
"text_margin_right": "0px",
"title_font_size": "16px",
"title_font_color": "#000000",
"title_font_weight": "normal",
"title_decoration": "none",
"title_hover_color": "#0000FF",
"title_hover_font_weight": "normal",
"title_hover_decoration": "none",
"description_font_size": "14px",
"description_font_color": "#555555",
"description_font_weight": "normal",
"description_decoration": "none",
"description_hover_color": "#0055FF",
"description_hover_font_weight": "normal",
"description_hover_decoration": "none",
"open_in_new_window": 1,
"mobile_responsive_type": 1,
"header_is_on_top": 1,
"header_text_align": "right",
"title_enabled": 1,
"description_enabled": 0,
"image_border_size": "",
"image_border_color": "",
"text_align": "left",
"customcss_enabled": 0,
"customcss": null,
"header_enabled": 1,
"mobile_breakpoint": "450",
"spacing_v": "10",
"spacing_h": "10",
"zoom": "1",
"mobile_rows": "2",
"mobile_cols": "1",
"use_v2_script": "1",
"text_enabled": "1",
"mobile_image_width": "450",
"mobile_text_box_size": "90",
"mobile_text_enabled": "1",
"mobile_text_position": "bottom",
"item_spacing_on_each_side": "5px",
"text_position": "bottom",
"text_box_size": "90px",
"widget_height": "570px",
"brand_enabled": "1",
"brand_font_size": "11px",
"brand_font_color": "#555555",
"brand_font_weight": "normal",
"brand_decoration": "none",
"mobile_image_height": "450",
"publisherAdType": "native-recommendation"
},
"ad_items": [
{
"image": "https://static.example.com/library/432437/97567ec37c751bc909fc06c96920bb353efefe36.jpg",
"url": "https://main.example.com/click.php?data=H4sIAAAAAAAAAz2OO27EMAxEr7LNljE0okhJZZo0KfYMkj9IgPwAG3GKOfxybSDgAJTI0RtdmBBzhhCBb9v2s17l.RpfXPu.D_Nfm9Zh_P70.1fb3n_n9UlJBhIGQGoQ47.LyHVw3gDRIUYjkwIlR2UKWjKUGopPQQ80xziI8CKiJMrDpb7NwCIO63VuAht17lmX0Ftq3WbJ_iKwfzTXkXuQLjzGZ8kjWeQ8hWj1.HUNp7WkoyXeXqmW0acQp0mWKdaUUaqUcTQbkaqlOziYDlsjAQAA",
"impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA01OS04FMQy7CheYKs6nad8OxAlAHKDzW4FYsHmLHJ5M0ZOI00apLddMjIWwMD2R3cRvqAHvBewFYoW5xsvbcyjiuI/9p2zfX6HCKv4YzbU3CyVrDgujlmp2h4Qa0Jwt0lWCEnLJLN1yKYRwio/313mQYIq8rw9BRblQQXQKzUe6U4BFw4FTMuPajyGomx2r20nr0LHWIwNd5uvnyJ5paQLFpcrkHpArnkgs+FuIa48siklnNf0nH+JUR60bidjoKd+HbHLuO7bTvP0ChQRmKEsBAAA=",
"title": "title 5",
"description": "description 5",
"brand": "brand 5",
"original_url": "https://www.example.com/natives-5",
"image_position": "50% 50%"
},
{
"image": "https://static.example.com/library/432437/d51084a3da98f857bca6ba19037cfe90b9a93c0b.jpg",
"url": "https://main.example.com/click.php?data=H4sIAAAAAAAAAz2OOW7EMAxFrzLNlBG4iFrKNGlS5AySR0ICZANsxCn.4UN7gIAEuH0.8oLIkjNVMOF1277Xqz5e5cl93_cwftttDcvXh9efbXv7GeuDAiCAEzNrJU34V4FzDc4LrBZEEhCNuWQyRLKS2WBUvMtQBzjGQWA3sGiEHirzaWae6rBeR1NOi42ebVJvsfU0NPsGob839_PuSboAciaH6XFZ9Z6RpHp.XekuLfEMES_PsCEcS7ZOc6HU6pR0mxIlVuNcUvsDR8DGSCMBAAA-",
"impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA01OSU4EMQz8Ch/oqLzFydxAvADEA9I96ROIA5c5+PHj7gEJV+Ko7FKlGEwLaGE8wS7iF6pB3guxFxIrzDVe3p5DKeZtXH/K9v0VKqzif09z7c1CYc3JwtBSze7ooUbUHBbpKoGEHDJLtyQFFI74eH89LyUYkf34kFCUCwpFR2gOcUMQi4YT7ZIZ1z6HUN1srm471qFjrTMDHebr58hzpsUJKi6Vg3/pI0vGE4mFHgRce2QhznVW03/yMU3nbjW7wfu8trHtuk3kZBuT7xcrT8hLAQAA",
"title": "Native 3 title",
"description": "Native 3 description",
"brand": "Native 3 brand",
"original_url": "https://www.example.com/natives-3",
"image_position": "50% 50%"
},
{
"image": "https://static.example.com/library/432437/59bb52f508ef418172a4809481e24a5ec01d9cfb.png",
"url": "https://main.example.com/click.php?data=H4sIAAAAAAAAAz2QOW7EMAxFrzLNlBG4iJJZppkmRc4gjWUkQDbARpziHz4cTxCQALV8vk_whMxSK1Uw4WXbvtazPp7lErnvexo_bV7T9fM97h9te_0e64MAIIALM6uTFvyrwNVT8BKrJZECZGOeKjEy2VTZYDTFK0MDEJgAgSPAohl6U1n8VuZFA9Z9NOVytdGrLdRbbr0MjWmjs7.1yMP3IJ0QVPoLvTmr3k8kxY.pne7SKR8l4_kJ5CLmOhp5pnmm1od1iZUs7p06_QJgI9fDIwEAAA--",
"impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA02OTU7EMAyFr8IFGj3/xensQJwAxAGSTroCsWAzCx9+3DJI2Ikjx0/PH4NpAS2MJ9hF/EI1yNdC7IXECnONl7fnUIp569efsn1/hQqr+N/TXNdmobDmZGFoqWZ3pMKImoMiXSWQKYfM0i2bkgNHfLy/njdVwYisx0JCUS4oFCtC8xM3BLFoONEuyTjW2YXqZnO47Rhd+6gzgQ7z8dnznLQ4k4pLpQcFHiyJJxIL/TbgukYG4hxnNP0n364sUKu1XQeq7juSgm3qgK29zzv4Hxr/SwEAAA==",
"title": "Native 2 title",
"description": "Native 2 description",
"brand": "Native 12 bran",
"original_url": "https://www.example.com/natives-2",
"image_position": "50% 50%"
},
{
"image": "https://static.example.com/library/432437/d32054c6f9c66c2853bff50b00578b15e0739875.jpg",
"url": "https://main.example.com/click.php?data=H4sIAAAAAAAAAz2Ou27GIAyFX.Vf_rHIxgbC2KVLhz4DEFAr9SYlajqch69JpApL.HL8Hd.g7FNiBuN137.3uzze_ZPFcRyu_5Z1c.3rw.rPsr_99O1BARDAkZklk0T8q8ApO8M5luC8j4AG5mXSlYL9AYEW6zLEAIYxEKY12ItCpirY1DaGGKzmXoRjC72mMKgWLTV2SbZBqO_F4vQ9STcDn8l8Mp1Frox8zOfVmS7pcgkVL89IK8fcZHQdSyfxWe2MtjYRP1RT_gOkVnReIgEAAA--",
"impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA01PSU4EMQz8Ch/oqLy103MD8QIQD0i6MycQBy5z8ONxGs0IV+LETqlcYTAtoIXxBLuIX2gN8q0QeyGxwrzGy9tzKMW4teOn7N9focIqfj+q61YtFFadLAw12exOFGpEdV5SVQIJmTRLtSwKQOGIj/fXcyctGJF5TiQU5YJCsSE0m7ghiEUjBa+SJvs2mtC62+huV/Smra8jHU31/tlynXZxgorLuqUSHpDpTyQW+ivASchAnM8Z9T99wIh1b2PHcbhxFwEN4UbjmD/+BS14KDZMAQAA",
"title": "title 4",
"description": "description 4",
"brand": "brand 4",
"original_url": "https://www.example.com/natives-4",
"image_position": "50% 50%"
}
]
}
}
]
}
外流视频
| 财产 | 说明 |
|---|---|
| 网址 | 点击 URL |
| 追踪 | 带有跟踪信息的对象。 |
| 视频 | 要加载的视频广告文件或 VAST 链接。 |
| 已启用品牌推广 | 启用品牌的标志。 此值目前未使用 |
| 频率周期 | 广告显示的频率(分钟)。 |
| 最大宽度 | 视频宽度大小。 |
| isVast | 说明获胜广告系列是普通视频广告(false)还是 VAST 链接广告(true)。 |
| ctaEnabled | 在广告上显示 CTA 的标志 |
| cta | 包含 CTA 详情的对象 |
| 印象 | 印象 URL |
data.tracking
目前,data.tracking 对象只返回一个包含用于跟踪视频播放的对象的 progress 数组。在这些对象中,"偏移量 "为 "00:00:10.000 "的对象将被调用来持久化视频视图。每个对象的属性说明如下:
| 财产 | 说明 |
|---|---|
| 胶印 | 以秒或视频广告播放百分比为单位的进度标记 |
| 网址 | 跟踪 URL |
data.cta
| 财产 | 说明 |
|---|---|
| displayUrl | 与广告登陆页面相关的 URL |
| 文本 | CTA 元素中使用的文本 |
外流视频响应示例
{
"zones": [
{
"idzone": 12345,
"type": "outstream_video",
"data": {
"url": "https:\/\/s.example.com\/click.php?d=H4sIAAAAAAAAA11S246bMBD9mrwl0fiKeexVkXabRc2SXeWlMsYkaA02YDct8sfXZFfbqhqwRjPHx2cuGc8YyWiEePHeTSvyYYW_pu96vW6ntj8b3Zh29FtluxQ1sq9TMHnd6DEAWZGvYdxI124a7dVlc2l9W6_IZz8GvcLcOyU7d4sophBtQG.kEGhDK4k3VYazDdWVYoJyqQSkG1OoilCZdrroMd1ihDGBaUoo06oXL88paMe62Be7ar_bV_e7Yn.XKdsfy.PxaYbQddMwDL31dXG6L54PDJUwD6f.MYSpvuNHGIe7E2P8NPRlWR7JAR5sZ5wLIWVPMLrnQzD1twXo.gqVjzibD2x.msvTzH5zhp5IVVaPWDJMDsGaYJDtSHC2Q3Z02EGPxy7MFhnbjYmT7T_W.nzZ3u.GXQ4IxOBcdXp.6P2rmtf3FheZuv42oWM59w_m_2QSk1z1VPwoXtyX7_zyQ7H5JeMNM_vw6DuhbZP0QAjOk6Gnrp87P1Hj.8nZ3tLE3vWjVTv8YZO6.SmNRbbnPnUze9uAtAIo4zwhGUPxqqtOTl6P7ayX4UeM8FagLRKwxShBUcZYaoGIbyOKDKEYKYo45lnighjRYjmGX6lqiJoRLDQCiQQiEktQkom8JjXOlBQ5REIxxhSxSCAHRZDOKUGKcFrTCtcc5ZIoIIjniRbilUzqYq2ZbuqSoCQQi4gzwJzGtL7rd8Q6IdYX35m1H3.3fi0nt25ao3vZ6SV0S9W6kcH4eCNfjBDCcyCLh4DSPI9Li9ITb_nFxDs6qV5KFhlPmCW4_DF.ORT_wP8aeW0RbIEtBwB6Z5q2nTxP489bXWkscQG8skHk8SfG8eEuNlQ3NMd5zasMNUwJIYBIBVLRnNMc_QHDw8Gc2AMAAA--&cb=e2e_6949260fe161c8.72624884",
"tracking": {
"progress": [
{
"offset": "00:00:10.000",
"url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=00%3A00%3A10.000&idzone=12345...."
},
{
"offset": "25%",
"url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=25%25&idzone=12345...."
},
{
"offset": "50%",
"url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=50%25&idzone=12345...."
},
{
"offset": "75%",
"url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=75%25&idzone=12345...."
},
{
"offset": "100%",
"url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=100%25&idzone=12345...."
}
]
},
"video": "https:\/\/u3y8v8u4.aucdn.net\/library\/940460\/8f1ab6fd40cb27cba71db1229c250d6bce1f8b68.mp4",
"brandingEnabled": 0,
"frequencyPeriod": 60,
"maximumWidth": 1000,
"impression": "https:\/\/s.example.com\/vregister.php?a=vimp&tracking_event=impression&t=api&idzone=12345....",
"isVast": false,
"ctaEnabled": 1,
"cta": {
"displayUrl": "singleflirt.com",
"text": "View More"
}
}
}
]
}
视频滑块
| 财产 | 说明 |
|---|---|
| 网址 | 点击 URL |
| 追踪 | 带有跟踪信息的对象。 |
| 视频 | 要加载的视频广告文件或 VAST 链接。 |
| 屏幕密度 | 整数,表示广告在用户设备的最大屏幕空间中所占的比例 |
| 完成时 | 隐藏 "表示隐藏广告,而 "重复 "表示广告留在页面上让用户重放 |
| closeAfter | 表示广告上显示关闭按钮前所需的秒数 |
| 已启用品牌推广 | 启用品牌的标志。 此属性目前未使用 |
| 频率周期 | 广告显示的频率(分钟)。 |
| 印象 | 印象 URL |
| isVast | 说明获胜广告系列是普通视频广告(false)还是 VAST 链接广告(true)。 |
| ctaEnabled | 在广告上显示 CTA 的标志 |
| cta | 包含 CTA 详情的对象 |
data.tracking
目前,data.tracking 对象只返回一个包含用于跟踪视频播放的对象的 progress 数组。在这些对象中,"偏移量 "为 "00:00:10.000 "的对象将被调用来持久化视频视图。每个对象的属性说明如下:
| 财产 | 说明 |
|---|---|
| 胶印 | 以秒或视频广告播放百分比为单位的进度标记 |
| 网址 | 跟踪 URL |
data.cta
| 财产 | 说明 |
|---|---|
| displayUrl | 与广告登陆页面相关的 URL |
| 文本 | CTA 元素中使用的文本 |
视频滑块响应示例
{
"zones": [
{
"idzone": 12345,
"type": "video_slider",
"data": {
"url": "https:\/\/s.example.com\/click.php?d=H4sIAAAAAAAAA11S246bMBD9mrwl0fiKeexVkXabRc2SXeWlMsYkaA02YDct8sfXZFfbqhqwRjPHx2cuGc8YyWiEePHeTSvyYYW_pu96vW6ntj8b3Zh29FtluxQ1sq9TMHnd6DEAWZGvYdxI124a7dVlc2l9W6_IZz8GvcLcOyU7d4sophBtQG.kEGhDK4k3VYazDdWVYoJyqQSkG1OoilCZdrroMd1ihDGBaUoo06oXL88paMe62Be7ar_bV_e7Yn.XKdsfy.PxaYbQddMwDL31dXG6L54PDJUwD6f.MYSpvuNHGIe7E2P8NPRlWR7JAR5sZ5wLIWVPMLrnQzD1twXo.gqVjzibD2x.msvTzH5zhp5IVVaPWDJMDsGaYJDtSHC2Q3Z02EGPxy7MFhnbjYmT7T_W.nzZ3u.GXQ4IxOBcdXp.6P2rmtf3FheZuv42oWM59w_m_2QSk1z1VPwoXtyX7_zyQ7H5JeMNM_vw6DuhbZP0QAjOk6Gnrp87P1Hj.8nZ3tLE3vWjVTv8YZO6.SmNRbbnPnUze9uAtAIo4zwhGUPxqqtOTl6P7ayX4UeM8FagLRKwxShBUcZYaoGIbyOKDKEYKYo45lnighjRYjmGX6lqiJoRLDQCiQQiEktQkom8JjXOlBQ5REIxxhSxSCAHRZDOKUGKcFrTCtcc5ZIoIIjniRbilUzqYq2ZbuqSoCQQi4gzwJzGtL7rd8Q6IdYX35m1H3.3fi0nt25ao3vZ6SV0S9W6kcH4eCNfjBDCcyCLh4DSPI9Li9ITb_nFxDs6qV5KFhlPmCW4_DF.ORT_wP8aeW0RbIEtBwB6Z5q2nTxP489bXWkscQG8skHk8SfG8eEuNlQ3NMd5zasMNUwJIYBIBVLRnNMc_QHDw8Gc2AMAAA--&cb=e2e_6949260fe161c8.72624884",
"tracking": {
"progress": [
{
"offset": "00:00:10.000",
"url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=00%3A00%3A10.000&idzone=12345...."
},
{
"offset": "25%",
"url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=25%25&idzone=12345...."
},
{
"offset": "50%",
"url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=50%25&idzone=12345...."
},
{
"offset": "75%",
"url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=75%25&idzone=12345...."
},
{
"offset": "100%",
"url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=100%25&idzone=12345...."
}
]
},
"video": "https://u3y8v8u4.aucdn.net/library/141372/7bbd0e98bb9b36baf778a8b970c74e26f51c037a.mp4",
"screenDensity": 25,
"onComplete": "repeat",
"closeAfter": null,
"brandingEnabled": 1,
"frequencyPeriod": 0,
"impression": "https://s.example.com/vregister.php?a=vimp&tracking_event=impression&t=api&idzone=12345...",
"isVast": false,
"ctaEnabled": 1,
"cta": {
"displayUrl": "fullclickenabled.com",
"text": "Watch Free"
}
}
}
]
}
全页面插播广告
| 财产 | 说明 |
|---|---|
| 网址 | 点击 URL |
| 印象 | 印象 URL |
| 图像 | 为广告上传的原始图片。 |
| 最佳图像 | 如果上传的创意是 GIF 动画,则这是为在广告中使用而创建的优化 MP4 版本。 |
| 宽度 | 广告的宽度(像素)。 |
| 高度 | 广告高度(像素)。 |
| 频率计数 | 广告可以显示多少次 |
| 频率周期 | 广告显示的频率(分钟 |
| 频率触发器类型 | 用于指示该广告的频率是基于印象 (0) 还是基于点击 (1) 的标志 |
| 广告触发方法 | 该广告区已启用触发方法 |
| 广告触发器类别 | 应触发广告的类别(如果有的话 |
| 首次触发点击 | 用户首次访问时需要点击的次数才能触发广告 |
| 下一次触发点击 | 首次触发广告后再次显示广告所需的点击次数 |
| 已启用 chrome_enabled | 标记用于指示该广告区是否为 Chrome 浏览器启用 (1)、禁用 (0) 或仅为该浏览器启用 (2) |
| 已启用封顶 | 指示是否对该广告区执行封顶的标志 |
| 媒体 | 这显示了横幅的类型:图像、HTML 或视频:应分别为 "img_banner"、"html_banner "或 "vide_banner"。 |
注: Fullpage Interstitial 响应的大部分属性都与广告的封顶和触发有关。由于您负责渲染广告,因此您可以自行决定是否关注这些属性。
全页面插页响应示例
请注意,虽然示例显示的是桌面 Fullpage Interstitial,但移动 Fullpage Interstitial 的响应除了 zone.type 外应该是一样的。
{
"zones": [
{
"idzone": 5808222,
"type": "desktop_fullpage_interstitial",
"data": {
"url": "https:\/\/s.example.com\/click.php?d=H4sIAAAAAAAAA01S2W7jOgz9mrwlgTZL8uPcWRAggWNkb18KWZIbz3iV5aYx9PFDp0XviIZBHx4d0iQFFxGJWEDh6n3bz.i3GfkFz.12W_ZF_VravCycX.qmArRUtQEQvMp5ghCd0V.DW6i2WOTW6.viWvjCzOgP7wY7I9y3WlXtA9GRxixHdqGkxAuWKbLIBBELZjMdScaVlghu9EOWDllZ9Ffr4FYkkSSEQECXhf7j1SuAjTNpkq6yZJVkm1WarIVu6tP5TsZxHKqq77oWjkmfN.llz9VwPp1Q7wCsj.O2NuaJn5BrL8cj8NF42jZN44ayMbtkczgYDdGxveyH0qz580Q8bEfnKRtaP_qKuLqrcdPhinXO.3HoKfFmtzEbt0vezGGXuN3l4A9t6i.JqXdus0suoHlX33n83w95To.paF0bnQ57ch9Mqj6q.cg3uW7N.bPKOrHafiL_BKEYcFn_5F_uf3arbhWP9fbw1r5URxJtSfbOry9mLbbFuTqr8ZJl.9_Wnu9dR.xQdFm.PZOhsO.3_OnbArr6Hcajitcauio.NwFWAQvOGWIxF.Fms0r13rpitNMSBILJUuIllmhJMFCxiCIGJ3yOKkQYh8BwICEWoAUUjtB7jMCZLCboHSOJguLS5jGTSmLDSUQ0hQ3JIy6lioU1MlAGcgxHgaIYaYptzCjWlDPDMmI4jhXViGIegywKN9rra9OU_aNKSAaFEhmIQISzAOs8_2LMgTG_.qqce3cv_Fz17TwvSluryk7QI2RsrobSh4f4ZJRSHiM6eRgxFsdhahWk.IxPJr_YUDW8gxQc.HyqZ_oMP_fpP_T_jUYfzhJoS4QQ_hLql62tevf2.C2YTpgIH2KQPbxBx7frkEtGIgQzs0LzDNoTUcHjTJuYiDzW.i9X4F4Z5wMAAA--&cb=e2e_69493367093292.02215167",
"impression": "https:\/\/s.example.com\/cimp.php?t=api&data=H4sIAAAAAAAAA11QS0pEMRC8iheYUP1J0nHt7AXxAG\/yMig4jvjEH314k4y4MEWgSVW6qpvBcUe8Y75CvgZfa3YmDkaBDIEJvr+7dSX\/aIfTsr2118fvFur55EWhCV5AIskJwjDzaDBm9kjkOeXIUZ0ox6j9eOndHR2iXaQUe0kB+130DL+\/u5mXOiQ6JeCzoCtmBmdzG1xhfBIMviRrx6K2GK2JI1eJlY4xmS0lt9VcUFCFWlGhKklXPfCaqCxSIZRK7wb\/kK0+nM9P25yqu\/X5uxVncFJH6D1GoDhzz+x93gLx3fgtBNVSvB\/4pJft67m6\/8kviC5DnYbBUP6jLyD8VoGGMabxeNjCSzttr+8zok6zgEFdtjk3dqnKEe3QF7cIlyxYI+ohq1VqyLYu7QfZRfrR8QEAAA==&cb=e2e_69493367093c99.73988768",
"image": "https:\/\/s3t3d2y1.afcdn.net\/library\/940460\/c8c01e1ff28dea8c9345f243dcd7b4ca8c7df26d.jpg",
"optimum_image": "https:\/\/s3t3d2y1.afcdn.net\/library\/940460\/a359ed6758e1c53523936ed27a001b7bf0f726ab.webp",
"width": 1600,
"height": 900,
"frequency_count": 1,
"frequency_period": 720,
"frequency_trigger_type": 0,
"ad_trigger_method": 3,
"ad_trigger_classes": "",
"first_trigger_clicks": 0,
"next_trigger_clicks": 0,
"chrome_enabled": 1,
"capping_enabled": 1,
"media": "img_banner",
"cid": 7675254,
}
}
]
}
页面内推送
| 财产 | 说明 |
|---|---|
| 网址 | 点击 URL |
| 印象 | 印象 URL |
| 图像 | 为广告上传的原始图片。 |
| 最佳图像 | 如果上传的创意是 GIF 动画,则这是为在广告中使用而创建的优化 MP4 版本。 |
| 标题 | 通知标题 |
| 描述 | 通知说明 |
| 水平位置 | 表示页面上的水平位置(左、中、右) |
| 垂直位置 | 表示页面上的垂直位置(顶部、中部、底部) |
| 延迟 | 页面加载后通知出现前的秒数 |
| 最大页面通知数 | 页面上可同时出现的通知数量 |
| 关闭一次隐藏一次 | 广告关闭后的隐藏时长(以秒为单位)(需要用户同意使用 cookie |
| 用户会话封顶 | 向用户展示广告的次数(需要用户同意使用 cookie) |
| 通知之间的延迟 | 上一个通知载入后,下一个通知出现前的秒数 |
页面内推送通知响应示例
{
"idzone":9999999,
"type":"in_page_push_notification",
"data":{
"url":"https://syndication.example.com/click.php?data=H4sIAAAAAAAAA02QvW7DMAyEX0VLVoGUSP2MXbp06DPQltwadeQgNuIU4MPXMYo2OE68w0ccOUF25BUs6.e6XpaTfzm51322bbNrXdaxfdh.PquCYkg55BQh6OU63upS7_OlybnaNimCJWfBoibnIfmISjlRdqwMSZVQvSLvGNDo4E5pB.7SQB1jHXwntQvZMlCMLgRkYA9Ij3wNnAPGobiB.l7EA_AQZOBSsCOqOwZ0.W5l7GUd52brXcpir3P_tehx0Ty55nDN4Zpp7mUyv0XNVjvTSWv1aj7X82T0IP_rAXOgTxv6S7C6I.FIPeuN9f1Ni3OIsXj0.0sEMJXEUQafa5QaovwASom5rH8BAAA-",
"image":"https://static.example.com/library/195600/0ce94b4e2b6222ee26594af823a65cb7059ca62d.jpg",
"title":"Title",
"description":"This is a description",
"impression":"https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA1VPW2rDQAy8Si+QZaSV9pH/XiBQ8O/au4bQ1glxKS7o8N24hFAJSTMwjCQG+wPigdIL8VH0iGAEJ+zgyIZhMCG73s7fbW3b5bqUz+aWD6OsAXiMSClnmOQkmdUUyTQhs3hL7JF8JCM1b3ikA3AX2uvbaa8ucAQyYYuMTVI339cbd+OOscGCjEpt9mNpY8hOITFyCKRQDxJYC5oDxbnyLNNUiu9b5lBmrZVGkXb3sfVnqeepfJ0vi2tbqau7Xab39XkaJ9qFzzz80R6wHZVuMpn9E8HUuHevOyHrz8wcYhHNtVSfRVklttxAOSTh6RdhQ+r1fQEAAA==",
"optimum_image":"https://static.example.com/library/195600/0c9243bcbb139db5671a779366a98a08f678b2f1.webp",
"horizontal_position":"right",
"vertical_position":"top",
"delay":0,
"max_notifications_on_page":2,
"once_closed_hide_for":10,
"user_session_capping":0,
"delay_between_notifications":10
}
}
多格式
多格式请求的响应可能会返回不同的结果:
- 如果获胜广告是一个本地广告系列,那么响应将包含一个**常规本地数据对象
- 如果中奖广告是一个横幅广告系列,并且您在版面上有一个单区,那么响应将包含一个**常规横幅数据对象
- 如果中奖广告是横幅广告系列,并且您选择了多个广告的布局,那么响应将包含一个组对象,该对象具有以下属性:
| 财产 | 说明 |
|---|---|
| 方向 | 多区布局的方向,可以是 "水平 "或 "垂直"。 |
| 广告项目 | 包含版面上每个位置的广告数据的数组。 |
无论结果如何,multizoneid 属性都将被添加到响应中,表明此响应对应的多格式广告区的区 ID。
多格式响应示例
下面的示例显示了采用水平 x 3布局的多格式广告区的区对象:
{
"zones": [
{
"group": {
"orientation": "horizontal",
"ad_items": [
{
"idzone": 12345,
"type": "banner",
"data": {
"url": "https://syndication.example.com/click.php?d=H4sIAAAAAAAAA01RTU_DMAz9NbtVlT.SNDlygAsHkPgFaZuySS2dmrAO5B9PEtCGHFmW37P97HROWSISlGNK53jghwM95RfTuoU2puCX87qHLYztsC4ZEAHBzhiF2oKTPfSLz7Tt9B0KQwiptdiihZYwU0kbUg6saNaMYEQjiigUEtflXiAMcCWdqcUcwRXBggirrCtPybiDgTE4xTiwUaPqaTToPA_AaFwuA9k5Dsd1nWMVAdX2fW9u.Sbnm2Na5iZtX6fU.HhuptMcPvwSSqpCY5j855yktqzamI0DLhGCUs5J3R9I_gjFVPX5HDYvWyIpBfkS5hcvzUQe317_1dyNim8B8O7xNj.2i3.P26VupaRMb6m2K4WX_HEvz2J0D9xZNyF7oyftstYRhr7TTo3QjT9DY7Q.5AEAAA--&cb=e2e_69495dc1258023.87481108",
"impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA01QW27CMBC8Si+ANftw4u13+a+KOEBiQotUiEQQ0GoPXzu0FI9ke3dnH7MMjgviBfMT4RnyzOZMHBIFSghM8OXq1ZX8MvT7bjoNx933EPK4d43EFt1AIo0ThJGSR4lCaDwSeWuamNmJY8NqSG6ts6NAtASUYjUCULjw9erFl+s3L63bmnV72AW4coTTPErpxK7FIGNcCWkuB0MWGkyFsjS60Z43DVknGUKNFTr8IlP+GMfPaR4fNwTStlaLfw6XIscgvqg5RYuqmZcDn8Pd9HXI7nc6PCakorD+XH59NfeR848HzfebZj58CvvufTqeb\/udm4a6r7oFUoWfu+OuO+3Gw72898rgzcDWgIX6bAOGNmZpt9SzbOMPcuXp2OIBAAA=&cb=e2e_69495dc1258be3.55680913",
"image": "http://example.com/library/328752/47de5c021bd0d00b59ff78456c69f601baac9925.gif",
"optimum_image": "http://example.com/library/328752/c990e4df40cc46482927c08350b2c960a59679e5.mp4",
"width": 300,
"height": 250,
"media": "img_banner",
},
"multizoneid": 67890
},
{
"idzone": 12345,
"type": "banner",
"data": {
"url": "https://syndication.example.com/click.php?d=H4sIAAAAAAAAA01Ry07DMBD8mt4iax.2Ex85wIUDSHyBk7i0UkKrODQF7cezdlFBa9mr2dnZh9tgO2IQMCiHdT3nHT_s6EnPtm0mjUuKczbDaVZEBARb7y26DoJsqZ9jXtNy_E6FIYRkOjTYgSFUKjlPznkQx44RvDhEEYtCElrVAmGAKzmlFgsEV4QORNgSkVbReICBMQXLOLC3o.1p9BgiD8Dog6aBbJyHw.k01TarrGLb1tzxRvHmsM5Tsy5fx7WJ.dzsj1P6iHMqUA2NaR8_p1WqZO2N2Qfg4iFYG4KU.YOV33gxW2_dRqezFk8KXxfhb_GiJfL49vov58_o9hoALDfeS2czx_e8XOpAWlDK97RVq2RdiOTlWXqA6CEmSBg7l6hl71se1O8p7e3wA2CxptPbAQAA&cb=e2e_69495dc1259304.50721064",
"impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA01QW24CMQy8Si9ANLbjkPBd/qsiDpDdhRapsBKLgFY+fL3Lo40l27HHjzGDdUY8Y34hLCALLsbEIVOgjMAEW67eLJJdNs2+DqfNcfezCW2\/t6jERa2ARJIRhJGzqagQkimRzUvMLDBiTayaYGVubHCRyMyRdPwEAA6GrVevtly\/m8+eMz8MmwBXVu8z7WIlWnSfCuNKyFM7FLRCmxKFWkmxiw13iUqVFkKpOBx2kaH97PuvYVofNwmknD2tj4CJ0ykQm401ziXGUswfbErX4fvQmj3hMM3IznD0TO6xsfY\/5k\/oDgkjadc0YWFD2NeP4Xi+3XYa6Pw9MV6AYoSd63FXT7v+8Oxt266JaKo2XJ37tlHJrhO6bcp+HvwC8uORF98BAAA=&cb=e2e_69495dc1259ad5.34119103",
"image": "https://example.com/library/451295/ca73592afb53e581f294bf7298e8ffb5f8da4c9f.jpg",
"optimum_image": "https://example.com/library/451295/51d30fc0dfe338ef5c05314ad9f6778c1bd6016f.webp",
"width": 300,
"height": 250,
"media": "img_banner"
},
"multizoneid": 67890
},
{
"idzone": 12345,
"type": "banner",
"data": {
"url": "https://syndication.example.com/click.php?d=H4sIAAAAAAAAA11Ry07DMBD8Gm5ptLt.xD5ygAsHkPgC13GaqHlUcdq0aD8eO0UFofFhNTP7tAGQZIChVNwuyyk.iecnek2vd2PdTHN0fSi7sVzaxO3deDhOx11_vp7n285PYz3tKAnMwFhpLVEZsLyG_eDiEubuK5R.GpiQSoMlGigJk5V0RUICsBJKIGhWiMwSmdhWqRawALiSStYMS3BFSGOykESUuiTdghcYrBTohZa13FOt0TrhQaC2KQ14FdG309THbQjYsK5r8eCLxBftMvTFMt.6pXDxVDRdH0Y3hExtUh0ad.4X3kpuswmhLYgcIUhpLef9K8k_esbdm65hSOkccfYzyYfK_PL58SfjF_SvCnAsB3eI82XbI_W5d.LNeyHi9zfW0hitq6bx6SahrpXz5AjznzifTvwNlJrwcuoBAAA-&cb=e2e_69495dc1259e91.21591992",
"impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA01Q0U7DMBD7FX5gle8uuSY8wzvSxAe0WQtIjEkrYgP548mysRErp4vPTqwoNK5EV6p3gnvYvWaqaJekk4ROBXxcPzEID9O4HZbPaf\/2M3Vlt6W5WO\/MEDOnwBQpMVo0gTOKMAFBEyjqvVoAmHsqUWFBVYPEdujB5\/VD21KhNOCosRrb4+xD4yUrjoLU\/MgoJlMOJsU8bMKoG5c8WIGJ5yoHD7aU193ufWl5cUYn0bWO4x9Bq\/kzjKuTp4YPIWfWBbbxsHx\/FPIqB2NC0uinjnbhTt7\/mhvEbm2rS7cdXpb9V0sVeLGd\/+V6Cz3MmIupz9BxRF+8L5vZVQLmnH3+BX0inm26AQAA&cb=e2e_69495dc125a500.54289539",
"image": "https://example.com/library/451295/ca73592afb53e581f294bf7298e8ffb5f8da4c9f.jpg",
"optimum_image": "https://example.com/library/451295/51d30fc0dfe338ef5c05314ad9f6778c1bd6016f.webp",
"width": 300,
"height": 250,
"media": "img_banner"
},
"multizoneid": 67890
}
]
}
}
]
}
响应式显示广告
某些格式(如横幅广告和全页面插播广告)除了可以接收来自其原始广告格式的需求外,还可以启用响应式展示广告接收来自原生广告活动的需求。在这种情况下,响应将包含original_zone对象,表明原始格式的类型和数据。
下面是一个横幅广告格式的示例:
{
"zones": [
{
"idzone": 5353142,
"type": "native_ad",
"data": {
"layout": {
"widgetHeaderContentHtml": "<a target=\"_blank\" href=\"https:\/\/www.exoclick.com\" rel=\"nofollow\">Powered By <span><\/span><\/a>",
"branding_logo": "\/\/s3t3d2y1.afcdn.net\/widget-branding-logo.png",
"branding_logo_hover": "\/\/s3t3d2y1.afcdn.net\/widget-branding-logo-hover.png",
"itemsPerRow": 1,
"itemsPerCol": 1,
"font_family": "Arial, Helvetica, Verdana, sans-serif",
"header_font_size": "12px",
"header_font_color": "#999999",
"widget_background_color": "transparent",
"widget_width": "450px",
"minimum_width_for_full_sized_layout": "450px",
"item_height": "300px",
"item_padding": "10px",
"image_height": "450px",
"image_width": "450px",
"text_margin_top": "3px",
"text_margin_bottom": "3px",
"text_margin_left": "0px",
"text_margin_right": "0px",
"title_font_size": "16px",
"title_font_color": "#000000",
"title_font_weight": "normal",
"title_decoration": "none",
"title_hover_color": "#0000FF",
"title_hover_font_weight": "normal",
"title_hover_decoration": "none",
"description_font_size": "14px",
"description_font_color": "#555555",
"description_font_weight": "normal",
"description_decoration": "none",
"description_hover_color": "#0055FF",
"description_hover_font_weight": "normal",
"description_hover_decoration": "none",
"open_in_new_window": 1,
"mobile_responsive_type": 1,
"header_is_on_top": 1,
"header_text_align": "right",
"title_enabled": 1,
"description_enabled": 1,
"image_border_size": "",
"image_border_color": "",
"text_align": "left",
"customcss_enabled": 1,
"customcss": "{\n width: 300px !important;\n height: 250px !important;\n}\n.exo-native-widget-header {\n display: none !important;\n}\n.exo-native-widget-item-container {\n width: 300px !important;\n height: 250px !important;\n max-width: 300px !important;\n padding-right: 0 !important;\n padding-bottom: 0 !important;\n}\n.exo-native-widget-item-image-wrapper { \n width: 300px !important;\n height: 250px !important;\n max-height: 250px !important;\n overflow: hidden !important;\n}\n.exo-native-widget-item-content-box {\n position: relative !important;\n}\n.exo-native-widget-item-content {\n position: absolute !important;\n z-index: 5 !important;\n top: 180px !important;\n background-color: white !important;\n opacity: 0.7 !important;\n height: auto !important;\n max-height: 110px !important;\n min-height: 70px !important;\n width: 100% !important;\n max-width: 300px !important;\n}\n.exo-native-widget-item-title {\n padding: 10px 8px 4px 8px !important;\n height: 20px !important;\n color: black !important;\n font-weight: 900 !important;\n font-size: 18px !important;\n display: flex !important;\n align-items: center;\n justify-content: center;\n text-align: center;\n white-space: normal !important;\n}\n.exo-native-widget-item-text {\n padding: 20px 8px 4px 8px !important;\n height: 20px !important;\n color: grey !important;\n font-weight: normal !important;\n font-size: 13px !important;\n display: flex !important;\n align-items: center;\n justify-content: center;\n text-align: center;\n white-space: normal !important;\n}\n.exo-native-widget-item-brand {\n padding: 5px 8px 0px 8px !important;\n height: 20px !important;\n font-weight: normal !important;\n font-size: 18px !important;\n display: none !important;\n align-items: center;\n justify-content: center;\n text-align: center;\n white-space: normal !important;\n}",
"header_enabled": 1,
"mobile_breakpoint": 450,
"spacing_v": 10,
"spacing_h": 10,
"zoom": 1,
"mobile_rows": 1,
"mobile_cols": 1,
"use_v2_script": 1,
"text_enabled": 1,
"mobile_image_width": 450,
"mobile_text_box_size": 90,
"mobile_text_enabled": 1,
"mobile_text_position": "bottom",
"mobile_image_height": 450,
"delaySeconds": 0,
"frequency": 0,
"frequencyCount": 0,
"publisherAdType": "native-recommendation",
"adTriggerType": "",
"popTriggerMethod": "",
"popTriggerClasses": "",
"item_spacing_on_each_side": "5px",
"text_position": "bottom",
"text_box_size": "90px",
"widget_height": "570px",
"brand_enabled": 0,
"brand_font_size": "11px",
"brand_font_color": "#555555",
"brand_font_weight": "normal",
"brand_decoration": "none"
},
"ad_items": [
{
"image": "https:\/\/s.example.net\/library\/451295\/4c5353dfe10c9e8ea12b05cc44eb0c6cafbc6100.jpg",
"url": "https:\/\/s.example.com\/click.php?d=H4sIAAAAAAAAA01RwW7DIAz9mt4iZBuHwnGH7rLDJvUDJkJIWylZqpA16.SPH6Cpmx4YYz.eMZi93rMzYhS0cl7Xa9rppx095zHOXXdX88lPURUzzMspqjBPORfT..GYVxEQ3BvDaJFQtthNPq1xuXxXphCSsqjQgiLMVCDDYBmk1a1GJmkRRRiFxO2zFohggSP4QrB5q5mIGFvR4CBojI41Bm245456g87rABqNy8dANp3CeZ7HVKtDxbZtzSPe5HhzXqexWZf7ZW18ujbDZYwfucESqqk.Dv5zXKVKFmitjQNdPARm56Q2DiS_hALOs.Xq5tuWVggNCFGhlq0cjm__.H8oDFCQf6DYzFX4KJ3U5E9pudWGWErh_JRVLsui3LL.64tQ77kbnOfWDtH2vQeLjgM548MQYvgB99zVE.gBAAA-&cb=e2e_694966c98c6cc2.67060117",
"optimum_image": "https:\/\/s3t3d2y1.afcdn.net\/library\/451295\/15c408293013fe9637290dbc36ec5a3fbd671c48.webp",
"title": "All systems online \ud83d\udc68\u200d\ud83d\ude80",
"description": "Reach for the stars in this new space simulation game.",
"brand": "ogame.com",
"original_url": "https:\/\/lobby.ogame.gameforge.com\/es_ES\/",
"image_position": "50% 50%",
"format": "native_ad",
"size": "300x300",
"iframe_url": "",
"impression": "https:\/\/s.example.com\/cimp.php?t=api&data=H4sIAAAAAAAAA01QW04DMQy8ChfoymM72Q3f9B9R9QC7aXhIlEpdRAHN4Um2tJCRbDlje2yraFhBV6o3kFvXWwEV2g3oMEinEK4393TwVKb9OL+X48t36fJhTw\/QFJgEZpEQUxkGBgsGVwaAsbfeU+M0ugwuTD2VUmGuqo7Qgk4kSmAv3G7uuN4+sIr3qhenJJYpWiN6DZBUPiHD0kmSZENJbsgWfeeT7iLSaFkMMdV04cnm\/Hw4vM7L5HJGB8Q6HMPlg1Y3SWJctRqDuKfE+oQLPc5fb5m8pgc\/O1q12hZrdX\/8f2D4XTUsFk1+SRfO3X58mo8f56suevXwrebMX3uyFMEoKT5OZZzyVC9gIfa7WDBZHqfwA7sG\/xjOAQAA&cb=e2e_694966c98c7af4.92854754",
"count_only_viewed_impressions": 0,
"video_thumb_id": null,
"video_thumb_url": null,
"video_thumb_enabled": 0
}
]
},
"original_zone": {
"type": "banner",
"data": {
"width": 300,
"height": 250
}
}
}
]
}
印象跟踪
确保对印象 URL 进行 GET 调用,以便为广告请求注册印象。一种方法是在显示广告的页面上创建一个不可见的图像文件,将印象 URL 作为源文件,例如
<img src="impression_url" width="0" height="0">