Endpointpost /v3/scanTag
Parameters
| data string, required |
The ad tag in base64-encoded format. |
| spec_id int, optional |
The ID of a custom ad specification set, used to validate the creative. Defaults to 0 (IAB guidelines). |
| name string, optional |
The name of the ad tag. Will be added to the JSON result, allowing you to keep track of which creative you scanned. |
Response200 400 401 429
| 3pas string |
The name of the third-party ad server, if detected successfully. Remains blank otherwise.
|
| blocked_by_adblock boolean |
Whether or not the tag will likely be blocked by ad blockers.
|
| console array |
All errors and warnings generated while loading the creative.
|
| cookies array |
All cookies that were dropped by the creative, either set via JavaScript or via an HTTP header.
|
| cpu_usage int |
The CPU usage, in milliseconds.
|
| creative_rendered boolean |
Equals true in case something was painted on the screen, false otherwise.
|
| dialogs array |
Any dialog message the creative shows as a pop-up. Generally created by alert() and confirm().
|
| dimensions array |
The detected width and height of the creative.
|
| dom_content_loaded int |
The time it took for the DOMContentLoaded event to fire, in milliseconds.
|
| has_border boolean |
Whether or not the creative has a contrasting border.
|
| has_video boolean |
Whether or not the creative plays video content.
|
| iframes int |
The number of iframes added to the DOM. This should be kept at a minimum to reduce memory usage.
|
| local_storage array |
All key/value pairs stored in window.localStorage.
|
| memory_usage int |
The amount of RAM memory used, in bytes.
|
| meta array |
Meta-data about the scan, like the CPU used, the time it took to complete the scan, the server location, etc.
|
| mobile_friendly boolean |
Whether or not the creative will display fine on a mobile device. Equals true if the creative is either responsive or less than 300 pixels wide.
|
| network array |
All network requests and their responses, including a full echo of the HTTP headers. Provides SSL certificate information too.
|
| job_id string |
A unique ID assigned to the scan.
|
| name string |
The name of the creative (copied from the payload).
|
| tips_and_updatesscan_results object |
An object containing the full scan results, including the number of passed/failed tests.
The tests array contains the result of each test performed.
|
| screenshot array |
A screenshot of the creative, in both high-res and thumbnail format. The url points to the location where the screenshot can be found.
|
| ssl boolean |
An object with information about the creative's SSL-compliancy. Insecure URLs loaded over http:// will be listed here.
|
| uses_document_write boolean |
Whether or not the creative uses the JS document.write() function. Synchronous code should be avoided.
|
|
cURL
curl "https://.api.advalify.io/v3/scanTag"
-H "X-ApiKey: TCm2Hd_rT4pRNvSZ2cGYCJ6... (example)"
-X POST
-d '{
"data": "WW91ciBhZCB0YWcgaGVyZS4uLg=="
}'
Example Response
{
"3pas": "Google Ad Manager (GAM)",
"blocked_by_adblock": true,
"console": {
"errors": ["Error: ReferenceError: somefunction is not defined"],
"warnings": []
},
"cookies": [{
"domain": ".doubleclick.net",
"expires": 1646483650.085365,
"httpOnly": true,
"name": "IDE",
"path": "/",
"priority": "Medium",
"sameSite": "None",
"secure": true,
"session": false,
"size": 70,
"value": "AHWqTUlqh0OPFbGUeGXQqkXebE_Tf9xEs0i7fspXWBfoQHL0p3ooP5Iv-vx7JYmWKsA"
}],
"cpu_usage": 634,
"creative_rendered": true,
"dialogs": [],
"dimensions": {
"height": 250,
"width": 300,
"text": "90x728"
},
"dom_content_loaded": 166,
"has_border": true,
"has_video": false,
"iframes": 2,
"local_storage": [],
"memory_usage": "11313152",
"meta": {
"api_version": "v3",
"cpu": "AMD 16-Core EPYC 7302P",
"creative_type": "ad_tag",
"device": "Desktop",
"language": "en-US",
"ram": "128GB",
"scan_duration": "2.809499",
"server_location": "ams",
"timestamp": 1612787651,
"ua": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4280.88 Safari/537.36"
},
"missing_assets": [],
"mobile_friendly": true,
"name": "My ad tag",
"network": {
"load_size": {
"host_initiated_subload": 0,
"initial_load": 263515,
"total": 263515
},
"measurement_pixels": 0,
"responses": [{
"bytes": 19175,
"headers": {
"cache-control": "private, max-age=900, stale-while-revalidate=3600",
"content-encoding": "gzip",
"content-length": "19175",
"content-type": "text/javascript",
"date": "Mon, 08 Feb 2021 12:34:09 GMT",
"etag": "777 / 11 of 1000 / last-modified: 1612786878",
"expires": "Mon, 08 Feb 2021 12:34:09 GMT",
"server": "sffe",
"timing-allow-origin": "*",
"vary": "Accept-Encoding",
},
"is_pixel": false,
"method": "GET",
"resource_type": "script",
"server_ip": "142.250.179.194",
"ssl": true,
"ssl_info": {
"protocol": "TLS 1.3",
"validFrom": 1611043025,
"validTo": 1618300624
},
"status": 200,
"status_text": "",
"timing": 172,
"url": "https://securepubads.g.doubleclick.net/tag/js/gpt.js"
}]
},
"job_id": "2af21-de8d9-7cb57-8f014",
"scan_results": {
"failed": 2,
"passed": 19,
"report_url": "https://share.advalify.io/c2450-f8e87-71c8a-bf12f",
"tests": {
"load_size": {
"test": "load_size",
"name": "Load Size: Total",
"data_type": "int",
"unit": "bytes",
"expected": 524288,
"actual": 0,
"operator": "<",
"result": "passed"
}
}
},
"screenshot": {
"highres": {
"bytes": 37715,
"color": "#77b2c1",
"mime_type": "image/png",
"url": "https://try.cdn.advalify.io/img/qa-report-983243-aue7bczw9t3v.png"
},
"thumbnail": {
"bytes": 3460,
"color": "#77b2c1",
"mime_type": "image/jpg",
"url": "https://try.cdn.advalify.io/img/qa-report-983243-6gn25mbhxwu9.jpg"
}
},
"ssl": {
"compliant": true,
"insecure_urls": []
},
"uses_document_write": false,
}
|
