{"id":29273696,"url":"https://github.com/simplifi/html5","last_synced_at":"2026-02-04T00:33:28.740Z","repository":{"id":52869562,"uuid":"48180919","full_name":"simplifi/html5","owner":"simplifi","description":"Simpli.fi HTML5 Docs and Samples","archived":false,"fork":false,"pushed_at":"2024-02-09T16:19:00.000Z","size":182,"stargazers_count":4,"open_issues_count":0,"forks_count":4,"subscribers_count":41,"default_branch":"master","last_synced_at":"2025-07-05T03:14:30.148Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/simplifi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2015-12-17T15:04:07.000Z","updated_at":"2024-02-09T16:15:30.000Z","dependencies_parsed_at":"2025-07-05T03:14:43.628Z","dependency_job_id":"adf16197-d9f9-4fd9-b431-dcb495cab86a","html_url":"https://github.com/simplifi/html5","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/simplifi/html5","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simplifi%2Fhtml5","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simplifi%2Fhtml5/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simplifi%2Fhtml5/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simplifi%2Fhtml5/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/simplifi","download_url":"https://codeload.github.com/simplifi/html5/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simplifi%2Fhtml5/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29062686,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-04T00:26:14.114Z","status":"ssl_error","status_checked_at":"2026-02-04T00:23:06.435Z","response_time":96,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-07-05T02:36:34.815Z","updated_at":"2026-02-04T00:33:28.726Z","avatar_url":"https://github.com/simplifi.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Simpli.fi HTML5 Developer Docs and Samples\n\n## About\n\nThis document describes how to create Simpli.fi compatible HTML5 ads.\n\n## Background\n\nA Simpli.fi compatible HTML5 ad has two parts. The first part is your creative, the HTML5 ad itself. The second part are the Simpli.fi Macros - a set of fields that are replaced in the ad creative when it is displayed to users. In order for the ad to function properly you must insert the Simpli.fi Macros into the HTML5 content of your ad.\n\n## What is an HTML5 ad?\n\nHTML5 ads are essentially just web pages, but they conform to a specific set of rules and are sized to fit in a standard ad location. The IAB publishes industry standards and recommendations that define the specifics of HTML5. At the time of this writing, these general recommendations are outlined in their [Fixed Size Ad Specifications](https://www.iab.com/wp-content/uploads/2019/04/IABNewAdPortfolio_LW_FixedSizeSpec.pdf). We proactively work with the IAB and contribute feedback on these specifications.\n\n## What are the Simpli.fi Macros?\n\nSimpli.fi Macros are placeholders that are used to set replacement values for the ad when the ads are served. You can think of them just like fields in a mail merge document. The list of macros is defined by Simpli.fi and are used in ads to set the target url for clicks, perform cache busting, and create dynamic HTML5 ads.\n\nPlease reach out to the Simpli.fi helpdesk or your client success rep in order to obtain an up-to-date list of supported macros.\n\n## Creating a Basic Ad\n\n### Getting Started\n\nWe’ll begin by creating a very simple custom HTML5 ad and providing the macro for the click tracking to work. Here are the basic steps:\n\nCreate a new folder on your computer that will contain the ad.\nAdd an image. In our example the ad will be a 300x250 ad, so the dimensions of our image will be 300x250 pixels.\n\nAdd an HTML page that references the image. Below is the HTML we will use for the ad.\n\n### Basic Ad HTML\n\n```\n\u003c!DOCTYPE html\u003e\n\u003chtml\u003e\n  \u003chead\u003e\n    \u003cmeta name=”ad.size” content=”width=300,height=250”\u003e\n  \u003c/head\u003e\n  \u003cbody\u003e\n    \u003cimg src=”300x250.jpg” onclick=”window.open('{{clickMacro}}')\"/\u003e\n  \u003c/body\u003e\n\u003c/html\u003e\n```\n\n### Uploading the Ad\n\nNext we’re going to create a zip file that contains the ad HTML and image file, and upload it to the Simpli.fi UI.\n\nSave the contents of the basic ad HTML above into a new file named `index.html`. Next, create a zip file that contains the `index.html` and `300x250.jpg`.\n\n\u003e NOTE: Only the actual files should be added to the zip. If you include the folder from the step above into the zip, it is rejected by ad validation in the UI.\n\nOnce you have created the zip file, drag and drop (or click browse) the zip file into your ad campaign in the UI. The ad, if valid, is automatically extracted and its contents saved.\n\nThe uploaded ad is automatically click-verified to ensure it clicks through to the target URL, if specified in the UI. If click verification fails, hover over the click-verify button/icon to view error messages. Click the click-verify button to reattempt the process, as needed.\n\n## HTML5 Ad Validations\n\nIn order for your HTML5 ad to pass validation, it must meet the following requirements:\n\n* Zip file must be 250 kb or smaller.\n* Zip file may contain up to 50 files.\n* There must be a single file named `index.html`.\n* HTML5 ad `index.html` must include a:\n  * ```\u003c!DOCTYPE html\u003e``` declaration.\n  * ```\u003chtml\u003e``` tag.\n  * ```\u003chead\u003e``` tag.\n  * ```\u003cbody\u003e``` tag.\n* Zip file may contain any of the other following file types:\n  * `.css`, `.js`, `.html`, `.gif`, `.png`, `.jpg`, `.jpeg`, `.svg`\n* Subfolders are not allowed.\n* HTML5 ad total render size must not exceed 2.1 MB.\n* External reference are allowed, but must not exceed 10.\n* External references cost against your overall render size limit; however, the following domains are exempt:\n  * `s0.2mdn.net/ads/`\n  * `ajax.googleapis.com`\n  * `fonts.googleapis.com`\n  * `fonts.gstatic.com`\n  * `tpc.googlesyndication.com`\n* If you use a `\u003cvideo\u003e` or `\u003caudio\u003e` tag you must host the external asset.\n* Videos that play by default **must not** play audio by default.\n* Audio **must not** play by default.\n\n## API Usage\n\nHTML5 Assets are now available through the Ads endpoint and are returned as a collection of assets under the ad.\n\nHTML5 Assets are not directly accessible. If you make a mistake and need to change an asset after it has been uploaded just delete the ad and recreate it.\n\n\n## Additional Information\n\n* If you include an `ad.size` meta tag in the ad when you upload it, the system will automatically detect and choose the correct ad size for you automatically. The ad size meta tag is defined within the `\u003chead\u003e` section of the `index.html`. For example:\n\n  ```\n  \u003cmeta name=\"ad.size\" content=\"width=300,height=250\"\u003e\n  ```\n* Macro replacement is only performed on the `index.html`. Placing macros into referenced javascript files is not supported.\n* Expandable ads are not supported.\n* When creating ads with the Google Web Designer, you must select \"Non-Google Ad\" from the Environment drop down list. DoubleClick, AdMob and AdWords environment ads are not supported.\n* If you have trouble getting your ad to automatically click-verify, try adding the `clickthru` class to the element that opens the target URL for the ad.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimplifi%2Fhtml5","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimplifi%2Fhtml5","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimplifi%2Fhtml5/lists"}