Ad Serving Custom HTML Ads via Airtory

You can use the Airtory Studio to host and serve custom HTML ads that have been built using third-party platforms.

Along with having 270+ templatized rich media ad experiences, the Airtory Studio also enables advertisers to host and serve custom made HTML and iFrame Ads via a feature known as “Creative Upload”.

How to Upload an iFrame Ad:

  • Click on the Creative Upload tab from the sidebar in the Airtory Studio.
    Screenshot 2019-08-08 at 5.34.14 PM
  • Here, you can add a Creative Name and a New Campaign details.
  • Once you have the basic details in place, choose iFrame Ad from the Format Type drop-down.
    Screenshot 2019-08-08 at 5.34.47 PM
  • Enter the URL of the iFrame Ad. Please ensure that the URL is HTTPS to avoid probable issues.
  • You can define the width and the height in which the ad should render.
  • Next, you have the option to add a custom black border to the ad. Enter the pixel value of the thickness of the border.
  • If there is any more custom CSS that you wish to add, it can be entered in the next field. For eg: width:100%;height:100%;border:none;
  • By checking the ENABLE MRAID CUSTOM CLOSE box, a close button will be added to the ad. This is especially useful for ads that will be served as mobile interstitial.
  • The position of the close button can be selected from the drop-down menu.
    Screenshot 2019-08-08 at 5.36.47 PM
  • Lastly, there is an option to add a third party impression tracker, which will be added to the ad tag.
  • Once all the required fields are filled in, click on the EXPORT button at the bottom right.

How to Upload an HTML Ad:

  • Click on the Creative Upload tab from the sidebar in the Airtory Studio.
  • Here, you can add a Creative Name and a New Campaign details.
  • Once you have the basic details in place, choose Zip File Upload from the Format Type drop-down.
    Screenshot 2019-08-08 at 5.34.47 PM
  • The Zip file that is being uploaded should contain the index.html file along with the assets folder.
    • While archiving the files, please ensure that the index.html file and the assets folder are archived together and not the directory.
    • To ensure all event tracking is done correctly, it is imperative to ensure that one of the below custom JS files are included within the HTML creative:
      • For HTML Ads:
        <script type=”text/javascript”>”airtory” in window||(window.airtory={track:function(){window.airtory.track.q.push(arguments)}},window.airtory.track.q=[]);</script><script src=”https://cdn.airtory.com/js/creative-upload-helper.js”></script>
      • ​For GWD Ads:
        <script type=”text/javascript”>”airtory” in window||(window.airtory={track:function(){window.airtory.track.q.push(arguments)}},window.airtory.track.q=[]);</script><script src=”https://cdn.airtory.com/js/gwd/standard.js”></script>
      • ​For GWD Ads with EnablerJS:
        <script type=”text/javascript”>”airtory” in window||(window.airtory={track:function(){window.airtory.track.q.push(arguments)}},window.airtory.track.q=[]);</script><script src=”https://cdn.airtory.com/js/gwd/enabler.js”></script>
  • After uploading the zip file, please select the Ad Type from the drop-down menu
    Screenshot 2019-08-08 at 5.45.19 PM
  • Setting up a Glide Ad:
    Screenshot 2019-08-08 at 5.47.11 PM

    • The Glide Ad is an interscroller ad that is responsive and placed within the content of a page. (See our default format here)
    • User can enter the ad break text before and after the ad in the following fields
    • The background and font colour of the text can be customized to suit the ad and the page the ad will render on
    • If the ad contains a video, check the ENABLE VIDEO EVENTS to ensure the video quartile events are tracked and reported
    • There is an option to add a third party impression tracker, which will be added to the ad tag.
  • Setting up a Super Billboard Ad:
    Screenshot 2019-08-08 at 5.47.23 PM

    • The Super Billboard ad is a responsive desktop ad, which is usually placed below the header of a desktop page
    • If the ad contains a video, check the ENABLE VIDEO EVENTS to ensure the video quartile events are tracked and reported
    • There is an option to add a third party impression tracker, which will be added to the ad tag.
  • Setting up a Generic Ad:
    Screenshot 2019-08-08 at 5.49.53 PM

    • A Generic Ad is an ad that can be set up for any dimension
    • The dimension of the ad can be defined by entering the width and height values while setting up the ad
    • If the ad contains a video, check the ENABLE VIDEO EVENTS to ensure the video quartile events are tracked and reported
    • Select the sub-type of the ad from the next drop-down menu
      • None: Is an ad that will be executed in the defined dimension
      • Expando: Is an expandable ad which overlaps the content once expanded
      • Push Down: Is an expandable ad which pushes the content of the page when expanded
      • Interstitial: is a mobile full-screen ad. The duration after which the ad should auto-close can be defined.
    • For Expando and Push Down ads:
      • The width and height of the expanded ad needs to be defined
      • To Enable Auto Expansion of the ad, check the box
      • The no. of times the ad should expand for each user within 24 hours can be defined
      • The duration after which the expanded ad should auto-close can also be defined
      • For non-GWD HTML Expandable ads, ensure you call the airtory.expand() in the function to trigger the expansion and airtory.close() function to close the ad.
      • For Expando ads only, you can define the direction of the ad expansion
        Screenshot 2019-08-08 at 5.51.36 PM
    • There is an option to add a third party impression tracker, which will be added to the ad tag.
  • Setting up a Native Ad:
    Screenshot 2019-08-08 at 5.52.18 PM

    • A Native Ad is that which is placed within the content of a page
    • It is of a fixed dimension
    • The width and height of the ad needs to be defined
    • If the ad contains a video, check the ENABLE VIDEO EVENTS to ensure the video quartile events are tracked and reported
    • There is an option to add a third party impression tracker, which will be added to the ad tag.

Exporting the Ad:

  • Once the creative is made, your screen will look like the below, where you can see:
    Screenshot 2019-08-08 at 5.53.15 PM

    • The preview of the creative
    • Shareable preview link of the creative
      • You can also generate a PIN-protected preview URL to share the creative preview with only a selected audience
  • QR Code to view the creative on a mobile device on scanning
  • The Ad Tag has default Macros inserted. However, for specific media partners, the Macros vary:
    • Before Downloading the Ad Tag, select the media partner being used for trafficking the campaign from the drop-down menu
    • On selecting, the respective Macros will automatically be inserted
  • Once done, you can download the Ad Tag by clicking the DOWNLOAD TAG button on the bottom right
  • The Ad Tag can be copied onto the clipboard by clicking on COPY TAG button on the bottom right
  • There is also a direct link to the Statistics page of this particular creative from this page

Analytics for Custom HTML Ads:

iFrame Ads:

  • By default, iFrame Ads served via the Airtory Studio report only Impressions of the ad
  • For the clicks to be reported in the Airtory Analytics and for the data to pass via the Macros, one of the below custom JS files is required to be added within the HTML code of the creative before closing the body tag
    • For HTML Ads:
      <script type=”text/javascript”>”airtory” in window||(window.airtory={track:function(){window.airtory.track.q.push(arguments)}},window.airtory.track.q=[]);</script><script src=”https://cdn.airtory.com/js/creative-upload-helper.js”></script>
    • For GWD Ads:
      <script type=”text/javascript”>”airtory” in window||(window.airtory={track:function(){window.airtory.track.q.push(arguments)}},window.airtory.track.q=[]);</script><script src=”https://cdn.airtory.com/js/gwd/standard.js”></script>
    • For GWD Ads with EnablerJS:
      <script type=”text/javascript”>”airtory” in window||(window.airtory={track:function(){window.airtory.track.q.push(arguments)}},window.airtory.track.q=[]);</script><script src=”https://cdn.airtory.com/js/gwd/enabler.js”></script>

HTML Ads:

  • Campaign Summary analytics for the HTML Ads can be seen in the Analytics tab within the Airtory Studio
    • You can check this article to know more about Airtory Analytics
  • To track custom events of the ad within the Airtory Studio, add airtory.track(“<event-name>”) where the event code line is within the HTML code.

Please contact your Airtory Account Manager to enable this feature for your Airtory Studio account.