{"_id":"57adda25867a2e220087dac6","category":{"_id":"564dcf87d3320b0d0028ca10","version":"564621e10c30fb2100ba3817","__v":26,"pages":["564dcfb4d3320b0d0028ca11","564dd25da8671617004e7b71","564dd3a7e39c4435005a1f33","564ddbcbd3320b0d0028ca25","564ddcb2a8671617004e7b8e","564ddfffa8671617004e7b94","564de165a8671617004e7b97","564de17d9176e9170068007b","564de194e39c4435005a1f56","564de3d99176e9170068007e","564de439fe07a81700b5c3af","564ef3911e9a082b00344ea1","564f03dfedbade0d000efa57","564f0978234efc0d006e186e","564f0d9aaf8ae235002db90e","564f133e4f000617007bd68e","564f14d829338a1700beefcd","564f15619eb2701700532470","564f2fec6b10960d00865761","564f302b6b10960d00865764","564f33e219857f2b00387a44","564f35d110b21d3500ad29d3","564f42e41af2c835004bfbe9","564f456ab85ee335004cbdb3","5652e161b83d8e0d00d24b6b","56859949cfc7cf0d001cb3f5"],"project":"564621e00c30fb2100ba3814","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-11-19T13:32:55.176Z","from_sync":false,"order":6,"slug":"api-overview","title":"Ad Request API"},"project":"564621e00c30fb2100ba3814","__v":18,"parentDoc":null,"user":"564621d275c83f0d00e9d52d","version":{"_id":"564621e10c30fb2100ba3817","__v":14,"project":"564621e00c30fb2100ba3814","createdAt":"2015-11-13T17:46:09.275Z","releaseDate":"2015-11-13T17:46:09.275Z","categories":["564621e10c30fb2100ba3818","564624cf0c30fb2100ba3822","564628d69f3f550d00fa3db6","564dafeeda00e82b00ed601d","564daff8fc36dc3700882b95","564db0ccda00e82b00ed601f","564dcf87d3320b0d0028ca10","5661a6e436398e0d00f79566","568585153703ed1700e420b0","56858767d96a760d00545da6","56858d693703ed1700e420b2","56858d8d22c41b0d00e4666c","56859e9c009a8d0d00797130","5685a6453703ed1700e420d3"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-08-12T14:16:05.563Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"method":"get","results":{"codes":[{"name":"Complete Native Ad Response","status":200,"code":"{\n  \"native\": {\n    \"link\": {\n      \"url\": \"http://mobfox.dev:50000/exchange.click.php?h=8b286e3029a3560caf2e6d3f34585990\"\n    },\n    \"assets\": [\n      {\n        \"id\": 1,\n        \"required\": 0,\n        \"type\": \"icon\",\n        \"img\": {\n          \"url\": \"https://creative1cdn.mobfox.com/mftext/80x80/315C93/fff?text=MobFoxTestAd\",\n          \"h\": 80,\n          \"w\": 80\n        }\n      },\n      {\n        \"id\": 2,\n        \"required\": 1,\n        \"type\": \"main\",\n        \"img\": {\n          \"url\": \"https://creative1cdn.mobfox.com/mftext/1200x627/315C93/fff?text=MobFoxTestAd\",\n          \"h\": 627,\n          \"w\": 1200\n        }\n      },\n      {\n        \"id\": 3,\n        \"required\": 1,\n        \"type\": \"title\",\n        \"title\": {\n          \"text\": \"MobFox Test Ad\"\n        }\n      },\n      {\n        \"id\": 4,\n        \"required\": 1,\n        \"type\": \"desc\",\n        \"data\": {\n          \"value\": \"MobFox test ad description\"\n        }\n      },\n      {\n        \"id\": 5,\n        \"required\": 0,\n        \"type\": \"rating\",\n        \"data\": {\n          \"value\": \"4.5\"\n        }\n      },\n      {\n        \"id\": 6,\n        \"required\": 0,\n        \"type\": \"ctatext\",\n        \"data\": {\n          \"value\": \"READ IT NOW\"\n        }\n      },\n      {\n        \"id\": 7,\n        \"required\": 0,\n        \"type\": \"sponsored\",\n        \"data\": {\n          \"value\": \"Sponsored content\"\n        }\n      }\n    ],\n    \"imptrackers\": [\n      \"http://mobfox.dev:50000/exchange.pixel.php?h=8b286e3029a3560caf2e6d3f34585990\"\n    ]\n  }\n}","language":"json"},{"name":"Error with parameter","status":200,"language":"json","code":"{\n  \"error\": \"Native n_plcmttype parameter missing.\"\n}"},{"status":200,"name":"No Ads Available","language":"json","code":"{\n  \"error\": \"No Ad Available\"\n}"}]},"settings":"","examples":{"codes":[{"name":"Complete Native Ad Request","language":"curl","code":"curl \"http://my.mobfox.com/request.php?rt=api&r_type=native&i=212.232.28.95&s=a764347547748896b84e0b8ccd90fd62&u=Mozilla%2F5.0%20(iPhone%3B%20CPU%20iPhone%20OS%208_0%20like%20Mac%20OS%20X)%20AppleWebKit%2F600.1.3%20(KHTML%2C%20like%20Gecko)%20Version%2F8.0%20Mobile%2F12A4345d%20Safari%2F600.1.4&o_iosadvid=1976F519-26D0-4428-9891-3133253A453F&o_andadvid=c6292267-56ad-4326-965d-deef6fcd5er9&r_floor=0.8&longitude=12.12&latitude=280.12&demo_gender=male&demo_age=1982&demo_keywords=sports&n_ver=1.1&n_layout=content_wall&n_adunit=promoted_listings&n_context=product&n_plcmttype=atomic&n_img_icon_req=1&n_img_icon_size=80&n_img_large_req=1&n_img_large_w=1200&n_img_large_h=627&n_title_req=1&n_title_len=25&n_desc_req=1&n_desc_len=90&n_rating_req=0&m=test\"\n\n# This ad request will serve you a native test ad by using &m=test in your request\n# Replace the value of s= with your own inventory hash once you are ready for live ads"}]},"auth":"required","params":[{"_id":"56473ab856fb450d0041012d","ref":"","in":"query","required":true,"desc":"Requester type. Our SDKs will populate this parameter with their SDK version numbers.<br><br>","default":"api","type":"string","name":"rt"},{"_id":"56473ab856fb450d0041012c","ref":"","in":"query","required":true,"desc":"Requested ad type. Allowed values: banner, video, native.<br><br>","default":"native","type":"string","name":"r_type"},{"_id":"56473f2c054d8f0d00bc776f","ref":"","in":"query","required":true,"desc":"The hash of your inventory to identify which app is making the request.<br><br>","default":"a764347547748896b84e0b8ccd90fd62","type":"string","name":"s"},{"_id":"56473f2c054d8f0d00bc776e","ref":"","in":"query","required":true,"desc":"URL encoded user agent string.<br><br>","default":"","type":"string","name":"u"},{"_id":"56473ee7c7687d0d00739fa0","ref":"","in":"query","required":true,"desc":"Set IP address of the device making the request. API will first check for the X-Forwarded-For header before it falls back to this parameter.<br><br>","default":"69.197.148.18","type":"string","name":"i"},{"_id":"564776cd8056940d001942b9","ref":"","in":"query","required":true,"desc":"IAB native version you support in your app. Supported versions: **1.0**, **1.1**.<br><br>","default":"1.1","type":"string","name":"n_ver"},{"_id":"57d7cfa3f6bfa00e00680b26","ref":"","in":"query","required":true,"desc":"**Required when choosing n_ver = \"1.0\"**.<br><br>  Pick one of the following ids to best describe the adunit type you are requesting:<br> **paid_search_units**<br> **recommendation_widgets**<br> **promoted_listings**<br> **in_ad**: In-Ad (IAB Standard) with Native Element Units<br> **custom**: Custom /\"Can't Be Contained\"<br><br>","default":"","type":"string","name":"n_adunit"},{"_id":"57d7cc3cf01c1a0e00165249","ref":"","in":"query","required":true,"desc":"**Required when choosing n_ver = \"1.0\"**. <br> <br>Pick one of the following ids to best describe the layout you will render the ad with: <br> **content_wall** <br> **app_wall** <br> **news_feed** <br> **chat_list** <br> **carousel** <br> **content_stream** <br> **grid**: Grid adjoining the content <br> <br>","default":"","type":"string","name":"n_layout"},{"_id":"57addc065aa73d0e005fc6a5","ref":"","in":"query","required":true,"desc":"**Required when choosing n_ver = \"1.1\"**.<br><br>Pick one of the following ids to best describe the context in which the ad appears:<br>**content:** Content-centric context such as newsfeed, article, image gallery, video gallery, or similar.<br><br>**social:** Social-centric context such as social network feed, email, chat, or similar.<br><br>**product:** Product context such as product listings, details, recommendations, reviews, or similar.<br><br>","default":"","type":"string","name":"n_context"},{"_id":"57addc065aa73d0e005fc6a4","ref":"","in":"query","required":true,"desc":"**Required when choosing n_ver = \"1.1\"**.<br><br>Pick one of the following ids to best describe the design/format/layout of the ad unit being offered:<br>**in_feed:** In the feed of content - for example as an item inside the organic feed/grid/listing/carousel.<br><br>**atomic:** In the atomic unit of the content - IE in the article page or single image page.<br><br>**outside:** Outside the core content - for example in the ads section on the right rail, as a banner-style placement near the content, etc.<br><br>**recommendation:** Recommendation widget, most commonly presented below the article content.<br><br>","default":"","type":"string","name":"n_plcmttype"},{"_id":"57b31e5d1085171900794eeb","ref":"","in":"query","required":false,"desc":"Define if this asset is required in response. Requiring too many assets leads to lower fill rate.<br><br>","default":"0","type":"boolean","name":"n_img_icon_req"},{"_id":"57addc37867a2e220087daca","ref":"","in":"query","required":false,"desc":"Size of the icon image you are requesting. We recommend 80 which represents 80x80px. Width/height ratio will be 1:1.<br><br>","default":"80","type":"string","name":"n_img_icon_size"},{"_id":"57b31e5d1085171900794eea","ref":"","in":"query","required":false,"desc":"Define if this asset is required in response. Requiring too many assets leads to lower fill rate.<br><br>","default":"0","type":"boolean","name":"n_img_large_req"},{"_id":"57addc53faa7a10e004495e6","ref":"","in":"query","required":false,"desc":"Width of the large image you are requesting. We recommend 1200x627px. In case you request other sizes please respect these ratios 1:1, 4:3, or 1.91:1 for better fill rates.<br><br>","default":"1200","type":"int","name":"n_img_large_w"},{"_id":"57b46aa3fdc0f42000dc9a41","ref":"","in":"query","required":false,"desc":"Height of the large image you are requesting. We recommend 1200x627px. In case you request other sizes please respect these ratios 1:1, 4:3, or 1.91:1 for better fill rates.<br><br>","default":"627","type":"int","name":"n_img_large_h"},{"_id":"57b31e808d94953200fd3199","ref":"","in":"query","required":false,"desc":"Define if this asset is required in response. Requiring too many assets leads to lower fill rate.<br><br>","default":"0","type":"boolean","name":"n_title_req"},{"_id":"57addc8e867a2e220087dacb","ref":"","in":"query","required":false,"desc":"Request a title asset and define the max length of the returned text.<br><br>","default":"25","type":"string","name":"n_title_len"},{"_id":"57b31e93eeec08220094ea7a","ref":"","in":"query","required":false,"desc":"Define if this asset is required in response. Requiring too many assets leads to lower fill rate.<br><br>","default":"0","type":"boolean","name":"n_desc_req"},{"_id":"57addd073215100e00bcf3f9","ref":"","in":"query","required":false,"desc":"Request a description asset and define the max length of the returned text.<br><br>","default":"140","type":"string","name":"n_desc_len"},{"_id":"57addd4e3215100e00bcf3fa","ref":"","in":"query","required":false,"desc":"Request a rating asset to display eg: stars for an app. Use **1** to require the rating to be served.<br><br>","default":"0","type":"boolean","name":"n_rating_req"}],"url":"/request.php?rt=api&r_type=native&n_ver=1.1"},"isReference":false,"order":10,"body":"MobFox native ads are based on the [RTB Native Ads specification](http://www.iab.com/wp-content/uploads/2016/03/OpenRTB-Native-Ads-Specification-1-1_2016.pdf). MobFox respects the RTB specification but does not implement all it's features. The parts we implement are documented in the above request/response examples and explained in more detail below.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Inventory Hash (s=)\",\n  \"body\": \"The value of the **s=** parameter used in the above **ad request** example is a so called **test hash**, which will always serve you a **test ad**. Once you are ready for live ads you need to replace the value of *s* with your own **inventory hash**, which you can find in [MobFox Control Panel](https://account.mobfox.com).\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Fire the impressions\"\n}\n[/block]\nPublishers that render native ads must fire all impression URLs provided in **imptrackers** contained in the JSON ad response.\n\nYou must fire the impressions from within the same environment as the original ad request was made using the same **user agent** and **ip address** in order to pass our fraud detections.\nPass the **user agent** in the HTTP header **User-Agent**.\n\nUsing CURL for example this can be done easily. The SSP will respond with HTTP 200 OK no matter if the impression was a success or not for security reasons.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"// Fire all impresion URLs from the above native ad response\\n\\ncurl -H 'User-Agent: YOUR-USER-AGENT-HERE' 'http://rtbstaging.admaxim.com/adtracker/track/track/imp?id=Z608Z61484Z-1Z18551_168282Z50Z0Z0ZZ1.0Z0.5Z0.0Z0.5ZatZviennaZviennaZ1100ZsamsungZandroid_4.4Zgt-i9505Za-0f1104a0-87dc-488b-822c-9905bd2b76a0Ziab1ZZagx4-gnx1Z0-0-Z-1Z1200x627Z227f3554f5a74061752f2cd90258c685ZZ1Z2ZZ18551Z-1Z2Z2ZZZ2Z1Z&ts=1475068457070&creative_id=61484:608&mobfoxBidPrice=0.204&auctionId=227F3554F5A74061752F2CD90258C685&ru='\\n\\ncurl -H 'User-Agent: YOUR-USER-AGENT-HERE' 'http://my.mobfox.com/exchange.pixel.php?h=009830757c489d2cf7982155f3637fd6'\",\n      \"language\": \"curl\",\n      \"name\": \"Fire all impression URLs\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Assets in Native Ad Response\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"Native ads will be returned as JSON structure. You can render them as you wish. The best practice is to make them look and feel as cool as your app does. This promises better click rates.\",\n  \"title\": \"Render as you wish!\"\n}\n[/block]\nThe IAB native ad will come as a JSON response containing **all your required assets** and **additional assets** like **ctatext** (call to action text) or **sponsored** (disclaimer you need to render). Please make sure your app can handle/ignore these assets as well as other assets which might be returned within the JSON of the native ad.\n\nAll possible assets are described in the [IAB Native Ads specification](http://www.iab.com/wp-content/uploads/2016/03/OpenRTB-Native-Ads-Specification-1-1_2016.pdf).\n\n**MobFox supported assets are described below:**\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Type\",\n    \"0-0\": \"icon\",\n    \"1-0\": \"main\",\n    \"0-1\": \"Small thumbnail image.\",\n    \"1-1\": \"Large image.\",\n    \"2-0\": \"title\",\n    \"2-1\": \"Title of the ad.\",\n    \"3-0\": \"desc\",\n    \"3-1\": \"Description of the ad. Typically a text explaining what is being advertised.\",\n    \"4-0\": \"rating\",\n    \"4-1\": \"App rating, which you can render as stars for example.\",\n    \"5-0\": \"ctatext\",\n    \"5-1\": \"Call to action text. Typically put on a button to make the user click on it.\",\n    \"6-0\": \"sponsored\",\n    \"6-1\": \"Legally needed label, which you need to render to disclaim your ad.\",\n    \"h-1\": \"Description\"\n  },\n  \"cols\": 2,\n  \"rows\": 7\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"body\": \"In real-life some requested assets might be missing depending on your ad request and on the demand sources providing MobFox with the native ads. Your app should be able to render good looking ads with non-required assets as well.\\n\\nThe MobFox platform will filter a lot of these cases for you, for example all your required assets will be provided.\",\n  \"title\": \"Assets might be missing\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"We recommend passing these parameters on all of your ad requests to get the best eCPM:\\n* o_andadvid\\n* o_iosadvid\\n* latitude\\n* longitude\\n* r_floor\\n* demo_age\\n* demo_gender\\n* c_mraid\\n* adspace_width/adspace_height\\n\\nThese params are documented on our [Global Request Parameters](doc:global-request-parameters) page.\",\n  \"title\": \"Augment your ad request with global ad request parameters\"\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"Mozilla%2F5.0%20(iPhone%3B%20CPU%20iPhone%20OS%208_0%20like%20Mac%20OS%20X)%20AppleWebKit%2F600.1.3%20(KHTML%2C%20like%20Gecko)%20Version%2F8.0%20Mobile%2F12A4345d%20Safari%2F600.1.4\",\n      \"language\": \"text\",\n      \"name\": \"User Agent for testing\"\n    }\n  ]\n}\n[/block]","excerpt":"MobFox responds with standardised IAB Native ads","slug":"request-native-ads-iab","type":"endpoint","title":"Request Native Ads"}

getRequest Native Ads

MobFox responds with standardised IAB Native ads

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Query Params

rt:
required
stringapi
Requester type. Our SDKs will populate this parameter with their SDK version numbers.<br><br>
r_type:
required
stringnative
Requested ad type. Allowed values: banner, video, native.<br><br>
s:
required
stringa764347547748896b84e0b8ccd90fd62
The hash of your inventory to identify which app is making the request.<br><br>
u:
required
string
URL encoded user agent string.<br><br>
i:
required
string69.197.148.18
Set IP address of the device making the request. API will first check for the X-Forwarded-For header before it falls back to this parameter.<br><br>
n_ver:
required
string1.1
IAB native version you support in your app. Supported versions: **1.0**, **1.1**.<br><br>
n_adunit:
required
string
**Required when choosing n_ver = "1.0"**.<br><br> Pick one of the following ids to best describe the adunit type you are requesting:<br> **paid_search_units**<br> **recommendation_widgets**<br> **promoted_listings**<br> **in_ad**: In-Ad (IAB Standard) with Native Element Units<br> **custom**: Custom /"Can't Be Contained"<br><br>
n_layout:
required
string
**Required when choosing n_ver = "1.0"**. <br> <br>Pick one of the following ids to best describe the layout you will render the ad with: <br> **content_wall** <br> **app_wall** <br> **news_feed** <br> **chat_list** <br> **carousel** <br> **content_stream** <br> **grid**: Grid adjoining the content <br> <br>
n_context:
required
string
**Required when choosing n_ver = "1.1"**.<br><br>Pick one of the following ids to best describe the context in which the ad appears:<br>**content:** Content-centric context such as newsfeed, article, image gallery, video gallery, or similar.<br><br>**social:** Social-centric context such as social network feed, email, chat, or similar.<br><br>**product:** Product context such as product listings, details, recommendations, reviews, or similar.<br><br>
n_plcmttype:
required
string
**Required when choosing n_ver = "1.1"**.<br><br>Pick one of the following ids to best describe the design/format/layout of the ad unit being offered:<br>**in_feed:** In the feed of content - for example as an item inside the organic feed/grid/listing/carousel.<br><br>**atomic:** In the atomic unit of the content - IE in the article page or single image page.<br><br>**outside:** Outside the core content - for example in the ads section on the right rail, as a banner-style placement near the content, etc.<br><br>**recommendation:** Recommendation widget, most commonly presented below the article content.<br><br>
n_img_icon_req:
boolean0
Define if this asset is required in response. Requiring too many assets leads to lower fill rate.<br><br>
n_img_icon_size:
string80
Size of the icon image you are requesting. We recommend 80 which represents 80x80px. Width/height ratio will be 1:1.<br><br>
n_img_large_req:
boolean0
Define if this asset is required in response. Requiring too many assets leads to lower fill rate.<br><br>
n_img_large_w:
integer1200
Width of the large image you are requesting. We recommend 1200x627px. In case you request other sizes please respect these ratios 1:1, 4:3, or 1.91:1 for better fill rates.<br><br>
n_img_large_h:
integer627
Height of the large image you are requesting. We recommend 1200x627px. In case you request other sizes please respect these ratios 1:1, 4:3, or 1.91:1 for better fill rates.<br><br>
n_title_req:
boolean0
Define if this asset is required in response. Requiring too many assets leads to lower fill rate.<br><br>
n_title_len:
string25
Request a title asset and define the max length of the returned text.<br><br>
n_desc_req:
boolean0
Define if this asset is required in response. Requiring too many assets leads to lower fill rate.<br><br>
n_desc_len:
string140
Request a description asset and define the max length of the returned text.<br><br>
n_rating_req:
boolean0
Request a rating asset to display eg: stars for an app. Use **1** to require the rating to be served.<br><br>

Examples


Result Format


Documentation

MobFox native ads are based on the [RTB Native Ads specification](http://www.iab.com/wp-content/uploads/2016/03/OpenRTB-Native-Ads-Specification-1-1_2016.pdf). MobFox respects the RTB specification but does not implement all it's features. The parts we implement are documented in the above request/response examples and explained in more detail below. [block:callout] { "type": "info", "title": "Inventory Hash (s=)", "body": "The value of the **s=** parameter used in the above **ad request** example is a so called **test hash**, which will always serve you a **test ad**. Once you are ready for live ads you need to replace the value of *s* with your own **inventory hash**, which you can find in [MobFox Control Panel](https://account.mobfox.com)." } [/block] [block:api-header] { "type": "basic", "title": "Fire the impressions" } [/block] Publishers that render native ads must fire all impression URLs provided in **imptrackers** contained in the JSON ad response. You must fire the impressions from within the same environment as the original ad request was made using the same **user agent** and **ip address** in order to pass our fraud detections. Pass the **user agent** in the HTTP header **User-Agent**. Using CURL for example this can be done easily. The SSP will respond with HTTP 200 OK no matter if the impression was a success or not for security reasons. [block:code] { "codes": [ { "code": "// Fire all impresion URLs from the above native ad response\n\ncurl -H 'User-Agent: YOUR-USER-AGENT-HERE' 'http://rtbstaging.admaxim.com/adtracker/track/track/imp?id=Z608Z61484Z-1Z18551_168282Z50Z0Z0ZZ1.0Z0.5Z0.0Z0.5ZatZviennaZviennaZ1100ZsamsungZandroid_4.4Zgt-i9505Za-0f1104a0-87dc-488b-822c-9905bd2b76a0Ziab1ZZagx4-gnx1Z0-0-Z-1Z1200x627Z227f3554f5a74061752f2cd90258c685ZZ1Z2ZZ18551Z-1Z2Z2ZZZ2Z1Z&ts=1475068457070&creative_id=61484:608&mobfoxBidPrice=0.204&auctionId=227F3554F5A74061752F2CD90258C685&ru='\n\ncurl -H 'User-Agent: YOUR-USER-AGENT-HERE' 'http://my.mobfox.com/exchange.pixel.php?h=009830757c489d2cf7982155f3637fd6'", "language": "curl", "name": "Fire all impression URLs" } ] } [/block] [block:api-header] { "type": "basic", "title": "Assets in Native Ad Response" } [/block] [block:callout] { "type": "info", "body": "Native ads will be returned as JSON structure. You can render them as you wish. The best practice is to make them look and feel as cool as your app does. This promises better click rates.", "title": "Render as you wish!" } [/block] The IAB native ad will come as a JSON response containing **all your required assets** and **additional assets** like **ctatext** (call to action text) or **sponsored** (disclaimer you need to render). Please make sure your app can handle/ignore these assets as well as other assets which might be returned within the JSON of the native ad. All possible assets are described in the [IAB Native Ads specification](http://www.iab.com/wp-content/uploads/2016/03/OpenRTB-Native-Ads-Specification-1-1_2016.pdf). **MobFox supported assets are described below:** [block:parameters] { "data": { "h-0": "Type", "0-0": "icon", "1-0": "main", "0-1": "Small thumbnail image.", "1-1": "Large image.", "2-0": "title", "2-1": "Title of the ad.", "3-0": "desc", "3-1": "Description of the ad. Typically a text explaining what is being advertised.", "4-0": "rating", "4-1": "App rating, which you can render as stars for example.", "5-0": "ctatext", "5-1": "Call to action text. Typically put on a button to make the user click on it.", "6-0": "sponsored", "6-1": "Legally needed label, which you need to render to disclaim your ad.", "h-1": "Description" }, "cols": 2, "rows": 7 } [/block] [block:callout] { "type": "danger", "body": "In real-life some requested assets might be missing depending on your ad request and on the demand sources providing MobFox with the native ads. Your app should be able to render good looking ads with non-required assets as well.\n\nThe MobFox platform will filter a lot of these cases for you, for example all your required assets will be provided.", "title": "Assets might be missing" } [/block] [block:callout] { "type": "info", "body": "We recommend passing these parameters on all of your ad requests to get the best eCPM:\n* o_andadvid\n* o_iosadvid\n* latitude\n* longitude\n* r_floor\n* demo_age\n* demo_gender\n* c_mraid\n* adspace_width/adspace_height\n\nThese params are documented on our [Global Request Parameters](doc:global-request-parameters) page.", "title": "Augment your ad request with global ad request parameters" } [/block] [block:code] { "codes": [ { "code": "Mozilla%2F5.0%20(iPhone%3B%20CPU%20iPhone%20OS%208_0%20like%20Mac%20OS%20X)%20AppleWebKit%2F600.1.3%20(KHTML%2C%20like%20Gecko)%20Version%2F8.0%20Mobile%2F12A4345d%20Safari%2F600.1.4", "language": "text", "name": "User Agent for testing" } ] } [/block]

User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}