Bulk Uploading VAST Ad Tags

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

VAST (Video Ad Serving Template) is the IAB's standard for communicating the details of video ad serving. This standard handles the display of ads in, on, or around a video or audio player.

You can bulk upload VAST ad tags using a TXT file or an Excel workbook (XLSX). Click here to download a blank template. You can also download a template from the Bulk VAST Ads window or the Bulk Uploading Ads page, where you can find more information about formatting this file.

Note: While third-party VAST audio is supported, we recommended you host audio on the Basis DSP. Third-party VAST cannot track companion impressions and clicks (a limitation of the VAST spec), and our transcoding covers the complexity of varying spec requirements for different publishers.

To bulk upload a VAST ad tag:

  1. Go to Main MenuCampaigns.

  2. Select a campaign.

  3. Select a media plan.

  4. Select DSP ActionsCreative.

  5. Select AddBulk VAST.

  6. Click Upload file and select the ZIP file that contains your VAST ad tags and optional Excel file.

    1. Enable Automatically detect and insert macros to automatically insert macros into your tags. This feature is only available for Google Campaign Manager tags and Sizmek tags.

  7. Review your creatives and enter or edit the details on the panel on the right. You can select multiple ads to apply changes to more than one ad at a time.

    • 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.

    • VAST XML File URL: Enter the VAST tag (the code used to call a VAST ad).
      • Click Insert macros to automatically insert Basis DSP macros for supported ad servers.
    • VPAID Version(Optional): If your ad uses VPAID, select the appropriate VPAID version here. Video Player Ad-Serving Interface Definition (VPAID) is defined by the IAB
    • Declare Vendor (Optional): Select a vendor. Google requires certain ad serving vendors/technologies to be declared for ads to run on Google Ad Manager. If you're not using any of the vendors on the list, you don't need to make a declaration.

    • 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.

    • Macros: Select Insert Macros to automatically insert macros. This option is only available for Google Campaign Manager tags and Sizmek tags.

    • Event Tracking URLs (Optional): Event tracking URLs are called when a particular event happens. For example, the creative calls the Video Start URL when a video or audio file starts playing and calls the First Quartile URL when 25% of the video or audio file has played. Click Add Tracking URL, select the Event Type, and enter the Tracking URL (including https://). You can add multiple trackers of the same type, up to 100 total event trackers.

    • 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.

After you upload your creatives, you can preview them and link them to tactics.