Bulk Uploading HTML5 Ads

Note: You can upload ads from a campaign's line item view or through the tactic editor.

You can upload multiple HTML5 ads at once in a ZIP file (maximum 25 MB) that includes your creatives and one Excel file that contains details about each ad. Additionally, each HTML5 ad should be a ZIP archive. See Preparing HTML5 Ads for more information.

Click here to download a blank template of our Excel file. You can also download it through the Bulk HTML5 modal or on Bulk Uploading Ads, where you can find more information about formatting this file.

To upload HTML5 ads in bulk:

  1. Go to Main Menu > Campaigns.

  2. Select a campaign.

  3. Select a media plan you want to add HTML5 creatives to.

  4. Select DSP ActionsCreative.

  5. Select AddBulk HTML5.

  6. Click Upload file and select a ZIP file (25 MB max) that contains your native ads and optional Excel file. Then, click Create. If you get an error message, make sure everything is formatted correctly. See Bulk Uploading Ads for formatting information about the ZIP file and Excel spreadsheet.

    Note: Click Download excel template to download a blank copy of our bulk upload template that you can include in your ZIP.

  7. When the file successfully uploads, enter more information for each creative. If you're including an Excel file, these details will already be filled out. You can select multiple ads to apply changes in bulk.

    • Ad Name: Enter the creative's name (maximum 150 characters). Enter a descriptive name you can recognize when you have many creatives in the DSP.

    • Dimensions: Select the dimensions of the creative from the menu.

    • Click Method: Select how you want to handle the ad's clickability.
      • Entire Ad Clickable: A layer on top of the ad makes it click through to the Destination Click URL. This option limits interactivity and doesn't allow for additional tracking events.
      • Query String Parameter: The Destination Click URL will be passed to the ad using a query string parameter. The query string parameter must be named clickTag or clickTAG.
      • Query String Parameter (Redirect Only): The destination URL for the ad is not declared within the DSP, but is decided at runtime by the creative. JavaScript code inside the HTML5 creative must read the click tag from a query string parameter and then append the destination URL to this value based on where on the ad the click happened. The query string parameter must be named clickTag or clickTAG.
      • For more information, see Preparing HTML5 Ads.
    • Destination URL: Enter the URL of the landing page to which the ad clicks through. This URL often points to an intermediate tracking server, which in turn sends the user to the landing page.

      • For URLs, include the https:// prefix.
      • For click-to-call tactics, use "tel:" followed by the phone number, including the country and area codes, such as tel:14165551234.
    • Image Impression Tracking URL: If you're using a third-party impression tracker, enter the image tracking URL to track impressions for the ad. If you have more than one, click Add image impression tracking URL. You can add up to three image trackers. The DSP automatically tracks impressions for your ads even if you don't provide a URL.

    • Ad Name: Enter the creative's name (maximum 150 characters). Enter a descriptive name you can recognize when you have many creatives in the DSP.

    • Destination URL: Enter the URL of the landing page to which the ad clicks through. This URL often points to an intermediate tracking server, which in turn sends the user to the landing page.

      • For URLs, include the https:// prefix.
      • For click-to-call tactics, use "tel:" followed by the phone number, including the country and area codes, such as tel:14165551234.
    • Image Impression Tracking URL: If you're using a third-party impression tracker, enter the image tracking URL to track impressions for the ad. If you have more than one, click Add image impression tracking URL. You can add up to three image trackers. The DSP automatically tracks impressions for your ads even if you don't provide a URL.

    • Script Impression Tracking URL: If you're using a third-party impression tracker, enter the script tracking URL to track impressions for the ad. If you have more than one, click Add script impression tracking URL. You can add up to three script trackers. The DSP automatically tracks impressions for your ads even if you don't provide a URL.

    • SSL Status: If the creative itself and all of the trackers it uses meet the requirements for secure environments, enable SSL secure. Make sure you mark the ad appropriately. If you mark an ad that contains non-secure elements as secure, it may not render correctly. The DSP uses this status to decide if the ad can be used for ATS-compliant impressions. See ATS Compliance for more information about testing an ad for ATS security.

    • Dimensions: Select the dimensions of the creative from the menu.
    • SSL Status: If the creative itself and all of the trackers it uses meet the requirements for secure environments, enable SSL secure. Make sure you mark the ad appropriately. If you mark an ad that contains non-secure elements as secure, it may not render correctly. The DSP uses this status to decide if the ad can be used for ATS-compliant impressions. See ATS Compliance for more information about testing an ad for ATS security.
    • Brand Domain: Enter a domain that represents the brand. When you set the domain for the first creative that you upload for a brand, it becomes the default domain for any new creatives that you upload for that brand. See Brand Domains and Verticals for more information.

    • Brand Verticals: Select the categories that best represent the ad. When you set the verticals for the first creative that you upload for a brand, those become the default verticals for any new creatives that you upload for that brand. See Brand Domains and Verticals for more information.

      Note: If you are creating a political campaign, you must select Sensitive Categories > Political (Elections). When you select this vertical, additional fields for political ad details appear on the New Image modal. See Uploading Political Ads for more information.

  8. Click Create. Your ad appears on the Creative panel. You can now link your creatives to tactics.