> For the complete documentation index, see [llms.txt](https://docs.responsiveads.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.responsiveads.com/deploying-ads/vast-video-and-ctv-ads.md).

# VAST Video & CTV Ads

This guide explains how to prepare a creative, export its video, configure a VAST deployment, publish it, and test the resulting ad tag. It also covers adding an interactive SIMID overlay for supported CTV placements.

> **The workflow at a glance:** Set up a VAST format → organize the creative into groups → export the video → create a deployment → select its video → **Publish All** → test and copy the tag.

### 1. Choose what you want to create

| Creative type   | What viewers receive                                         | What to configure                                             |
| --------------- | ------------------------------------------------------------ | ------------------------------------------------------------- |
| Video-only VAST | A video ad                                                   | A Video Group and a CTV video export                          |
| VAST with SIMID | A video with a separate interactive overlay, where supported | A Video Group, a separate SIMID Group, and a CTV video export |

#### Key terms

* **VAST** is the ad tag a video player uses to load the video and its tracking information.
* **CTV** means connected TV. The app uses its CTV export controls to prepare videos for VAST, including video-only ads.
* **SIMID** provides the separate interactive layer. The player and placement must support SIMID for viewers to use that layer.
* A **deployment** holds the delivery settings for a particular version or placement of your creative.
* A **manifest** is the published configuration behind a VAST tag. The app creates it when you publish.

> **Before you start:** Confirm the placement's required dimensions, duration, frame rate, VAST version, and support for SIMID or TV remote interaction.

### 2. Set up a VAST format

1. Create or open your creative.
2. Add a suitable format, or edit an existing format.
3. In the format editor, set **Format Type** to **VAST**.

<img src="https://1588470797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAs6tyouSPGAAcvS6CYBG%2Fuploads%2FtMmGDl4GaKiDrbL1soQ8%2Funknown.png?alt=media&amp;token=6cbd86c0-ace0-4df2-bab8-5a6916511250" alt="" height="263" width="507">

4. Set the dimensions required by your placement.
5. Save the format and creative.

Adding a VAST format makes **CTV Settings** available in the editor and **VAST Ad Tags (Manifests & Ad Serving)** available on the creative's [Summary Page](https://docs.responsiveads.com/ad-management/summary-page).

{% hint style="info" %}
**Note:** Format Type is configured separately for each format. A creative can contain both Display and VAST formats. Create your VAST deployment from the VAST Ad Tags section and select the intended VAST format.
{% endhint %}

### 3. Organize the creative into groups

The exported video and the interactive overlay are prepared separately, so each lives in its own [group](https://docs.responsiveads.com/creating-ads/designing-your-ad-in-the-fluid-ad-creator/elements/group-element-html).

<img src="https://1588470797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAs6tyouSPGAAcvS6CYBG%2Fuploads%2FAqUJsWFjgvVsGVYxwNg7%2Funknown.png?alt=media&amp;token=fa5671cd-6b29-40c1-8a73-078e12704e4c" alt="A creative organized into a SIMID Group and a Video Group" height="156" width="448">

#### Video Group

Put everything that should appear in the finished video inside one group. This can include source video, text, images, branding, and animations.

Anything that must remain visible when the ad plays without interactivity belongs in this group.

#### SIMID Group (optional)

For an interactive creative, put the overlay content inside a separate group. This might include buttons, interactive messages, or other controls.

The SIMID Group is excluded from the CTV video export and displayed separately during supported playback.

**Example**

* **Video Group:** Product footage, logo, and an animated offer.
* **SIMID Group:** An interactive button and supporting overlay text.

#### Group requirements

Each selectable group must:

* Be a **top-level** group.
* Contain at least one element **at the size you are editing**.
* Be **separate** from the group selected for the other purpose.

{% hint style="warning" %}
**Warning:** An empty group or a standalone background element will not appear as an eligible group.
{% endhint %}

### 4. Configure CTV Settings

<img src="https://1588470797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAs6tyouSPGAAcvS6CYBG%2Fuploads%2FVtygyhU2QAI0mxgPbHyI%2Funknown.png?alt=media&amp;token=a693bde2-648a-4891-97da-a5b18ec33824" alt="CTV Settings with a Video Group and SIMID Group selected" height="332" width="427">

1. Deselect all elements in the editor.
2. Open **Setup → CTV Settings**.
3. Under **Video Group**, select the group containing your video content.
4. For an interactive creative, select the separate overlay group under **SIMID Group**.
5. Save the creative.

For video-only VAST, leave **SIMID Group** empty. The app displays a warning that no SIMID overlay is configured; VAST publishing remains available.

{% hint style="info" %}
**Note:** If a selected group is deleted, emptied, or moved inside another group, return to CTV Settings and select an eligible group.
{% endhint %}

### 5. Add SIMID interactions (optional)

Select an interactive element inside your SIMID Group and configure its actions in **Design → Element Triggers → Click**. See [Interactions & Triggers](https://docs.responsiveads.com/creating-ads/designing-your-ad-in-the-fluid-ad-creator/interactions-and-triggers) for general trigger setup.

When a SIMID Group is configured, the available actions include:

* **Play SIMID Host Media**
* **Pause SIMID Host Media**
* **Stop SIMID Host Media**

These actions request control of the video playing in the host player. Their behavior depends on the player's support.

Configure button destinations and other required interactions, then save the creative.

{% hint style="warning" %}
**Warning: TV remote interaction requires separate preparation and testing.** Selecting a SIMID Group does not automatically give buttons directional navigation or selection through a remote. If your creative depends on remote interaction, use a template or implementation prepared for that behavior and test it on the intended device.
{% endhint %}

### 6. Export the video

On the creative's Summary Page:

<img src="https://1588470797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAs6tyouSPGAAcvS6CYBG%2Fuploads%2F59v1hsKJUfIf1jsJvfDS%2Funknown.png?alt=media&amp;token=8281d5f8-ebf8-443c-ad5a-5defa9d74202" alt="The Video/Animated GIF (Export) section" height="143" width="624">

1. Open **Video/Animated GIF (Export)**.
2. Click **New Export**.
3. Enter a descriptive export name.
4. Select the correct **Format**.
5. Choose the **Layout Variant**, if applicable.
6. If using a data feed, click **Include in export** and choose the required rows. Each selected row creates a video for each selected size.
7. Set **Type** to **mp4 Video**.
8. Confirm that this checkbox is selected: **Confirm Video Export for CTV (All other groups & SIMID layer turned off for export)**

This setting records the selected Video Group, excludes the other groups, and makes the completed MP4 available for selection as a default VAST video.

#### Set the duration and video settings

Choose the appropriate duration option:

| Option                 | Use it to                                      |
| ---------------------- | ---------------------------------------------- |
| **Custom**             | Enter the required duration in seconds         |
| **Animation Timeline** | Match the creative's animation duration        |
| **HTML5 Video Length** | Use the HTML5 video duration from the creative |

If the creative contains multiple HTML5 videos, verify the resulting duration carefully. Use **Custom** when you need a specific placement duration.

* **Maximum length:** The export dialog indicates a maximum video length of 89 seconds. Use the duration required by your placement.
* **FPS:** Set the required frame rate. The available options are 29.97, 30, and 60.
* **Video quality:** Available for a confirmed CTV export with all three duration options. It uses a scale of 6–35, where lower numbers produce higher quality. The default is 17. This is a quality setting, not a bitrate in kbps.

#### Add sizes and start the export

1. Select the required size or sizes.
2. Click **Add** so they appear under **Added to Package**.
3. Click **Save** to start the export.
4. Wait for processing to finish.

Completed CTV exports display **(CTV)** beside their type. Their individual video outputs are also registered in the media gallery for selection in regional video rules.

{% hint style="info" %}
**Review before you deploy:** Download the output and check the picture, audio, dimensions, duration, text, and animation timing. For an interactive creative, confirm that the SIMID overlay has not been recorded into the video. If you exported several sizes or data variants, review each output you intend to use.
{% endhint %}

For general export settings, see [Video/Animated Gifs](https://docs.responsiveads.com/deploying-ads/video-animated-gifs).

### 7. Create a VAST deployment

<img src="https://1588470797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAs6tyouSPGAAcvS6CYBG%2Fuploads%2FbmSuGXhdGM6yj4HYTbBb%2Funknown.png?alt=media&amp;token=97543f9f-019f-4da5-b853-137d64d3f708" alt="The VAST Ad Tags (Manifests &#x26; Ad Serving) section" height="92" width="624">

1. On the creative's Summary Page, open **VAST Ad Tags (Manifests & Ad Serving)**.
2. Click **New Deployment**.
3. Enter a descriptive name.
4. Choose the correct VAST **Format**.
5. Select the appropriate layout or data variant, if applicable.
6. Enter the placement's **Clickthrough URL**.
7. Add any supplied **Impression tracker** information.
8. Review **Element click-throughs** if the interactive creative has individual destinations.
9. Click **Save**.

Use separate deployments when you need separately managed tags or delivery settings.

{% hint style="info" %}
**Note:** Saving a deployment stores its settings. Use **Publish All** to apply those settings to delivery.
{% endhint %}

{% hint style="warning" %}
**Warning:** Selecting a deployment layout or data variant does not generate a new MP4. Select an exported output that already contains the intended video content.
{% endhint %}

### 8. Select the default video

<img src="https://1588470797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAs6tyouSPGAAcvS6CYBG%2Fuploads%2FivrOGuP0xAZ8nCVCK13g%2Funknown.png?alt=media&amp;token=01927c90-10a2-4cee-b42f-a6e5fbe491c9" alt="The Default VAST MP4 dropdown in a deployment row" height="180" width="451">

In the deployment's row:

1. Open **Default VAST MP4**.
2. Choose the completed CTV export and the correct output.

Only completed MP4 exports created with the CTV confirmation checkbox selected appear in this dropdown. An export containing several sizes or data variants provides separate output choices.

The default video serves when no regional video rule matches. For a campaign without regional rules, it is the video that serves.

Changing this selection saves the choice and marks the creative as changed. Click **Publish All** when you are ready to apply it.

A default video is optional if the deployment contains valid DMA Video rules. Read the next section before using **No default video**.

### 9. Add regional videos (optional)

DMA rules let one VAST tag serve different videos to different geographic markets. This uses the same Conditions Table described in [Condition Variants](https://docs.responsiveads.com/creating-ads/variants/condition-variants), with VAST-specific rules.

<img src="https://1588470797-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAs6tyouSPGAAcvS6CYBG%2Fuploads%2F46jB0GEBuQ6BtIfjplHR%2Funknown.png?alt=media&amp;token=d8db18f1-4f48-438e-8410-e4cd8279c654" alt="A Conditions Table mapping DMA codes to videos" height="372" width="624">

1. Prepare the required videos in the media gallery. Completed CTV export outputs can be selected there.
2. Edit the deployment and set **Layout Variant** to **Dynamic**.
3. Click **Edit conditions table**, or use the deployment row's **Open Conditions Table** action.
4. Add a **DMA condition** column.
5. Add a **Video** value column.
6. For each row, enter the DMA code or codes and use **Select from media gallery** to choose the video.
7. Save the conditions and deployment.
8. Click **Publish All** to apply the rules.

{% hint style="info" %}
**Note:** The **Dynamic** option requires layout variants to exist, and its availability depends on your account's enabled features.
{% endhint %}

For VAST video selection, configure the **DMA condition** and **Video** value explicitly. Selecting a Market or layout variant alone does not create a regional video rule.

#### Regional video rules

* Each usable row needs at least one DMA code and a selected video.
* If a DMA appears in multiple usable rows, the first usable occurrence takes priority.
* VAST video rows support DMA targeting only. Leave other condition cells on those rows empty.
* A DMA + Video row with another populated condition produces **Invalid video conditions** and blocks publishing for that deployment.
* Separate rows used only to change SIMID content can contain other supported conditions.
* Choose videos with dimensions and duration consistent with the deployment and placement.
* Keep a default video when viewers outside the listed markets should still receive an ad.

{% hint style="warning" %}
**Important: Publishing with No default video.** You can publish valid DMA Video rules with **No default video** selected. Requests without a matching regional rule will then receive no ad, including requests where the viewer's DMA cannot be determined.
{% endhint %}

Exporting data feed variants creates video outputs. You must assign those outputs to regional rules yourself.

### 10. Publish the creative and VAST manifests

In **VAST Ad Tags (Manifests & Ad Serving)**:

1. Confirm each deployment's default video or regional rules.
2. Click **Publish All**.
3. Wait for publishing to finish.
4. Check the **Status** of every deployment you intend to use.

**Publish All** publishes the creative first, then publishes the eligible VAST manifests. This also publishes the creative used by the SIMID overlay.

{% hint style="warning" %}
**Warning: Publish All does not create or refresh video exports.** If the video content changed, create and select a new CTV export before publishing. Deployments without a usable video, or with invalid video conditions, are skipped. Check each row even when other deployments publish successfully.
{% endhint %}

#### Understanding the Status column

| Status                       | Meaning and next step                                                                                                    |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **Checking…**                | The app is loading the published manifest state. Wait for the check to finish.                                           |
| **Needs video**              | Select a default CTV video or add valid DMA Video rules. Publish All skips this deployment.                              |
| **Invalid video conditions** | Remove additional populated conditions from DMA + Video rows, then publish again.                                        |
| **Draft**                    | The creative or manifest has not been published. Click Publish All.                                                      |
| **Pending**                  | The creative or manifest settings have changed since publishing. Click Publish All to apply them.                        |
| **Publishing…**              | The manifest upload is in progress. Wait for completion.                                                                 |
| **Publish failed**           | Publishing failed, or the published manifest could not be loaded. Review the displayed message and retry as appropriate. |
| **Published**                | The app considers the creative and manifest current. Continue with playback testing.                                     |

If a deployment previously served successfully, a skipped or failed publish does not apply your new settings to its existing manifest.

### 11. Test and copy the VAST tag

After publishing:

1. Use the deployment row's external-link action to open the Google IMA preview.
2. Confirm that the expected video loads and plays.
3. Test the tag in the intended publisher or ad-platform player.
4. For regional campaigns, test matching markets and the default or no-ad behavior.
5. For SIMID, verify that the overlay appears and its interactions work.
6. For CTV, test required remote-control behavior on the target device.
7. Open the **Copy VAST URL** menu using the tag icon.

The copy menu provides:

| Action                      | Use it for                                                                             |
| --------------------------- | -------------------------------------------------------------------------------------- |
| **Copy default URL (Auto)** | Automatic VAST version selection based on the requesting device                        |
| **Copy VAST 2.0 URL**       | A placement requiring VAST 2.0; video delivery without SIMID                           |
| **Copy VAST 3.0 URL**       | A placement requiring VAST 3.0; video delivery without SIMID                           |
| **Copy VAST 4.2 URL**       | A placement requiring VAST 4.2, including SIMID delivery when configured and supported |

{% hint style="info" %}
**Note:** Choosing VAST 4.2 does not make an unsupported player interactive.
{% endhint %}

* Use **Download All Tags** to download a spreadsheet of published deployment tag URLs. You can also select deployment rows and use the bulk tag-download action.
* The row's **View JSON** action lets you inspect its published manifest when troubleshooting.

Give your ad operations team the VAST URL. Preserve the complete copied URL, including its deployment identifier and any version parameter. Video export links and manifest JSON serve different purposes. For the parameters a VAST URL accepts, see VAST Endpoint URL Parameters.

{% hint style="warning" %}
**Warning:** A successful desktop video preview does not establish that SIMID or TV remote interaction will work in the final placement.
{% endhint %}

### 12. Update an existing creative

| What changed                                                          | What to do                                                                                                    |
| --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| Video content, animation, audio, layout, or data used in the video    | Save the creative, create and review a new CTV export, select the replacement output, then click Publish All. |
| Default video selection                                               | Select the replacement output, then click Publish All.                                                        |
| Regional videos or rules                                              | Save the conditions and deployment, then click Publish All.                                                   |
| Deployment clickthrough, element destinations, or impression trackers | Save the deployment, then click Publish All.                                                                  |
| SIMID design, actions, or group selection                             | Save the creative, click Publish All, then retest the overlay and interactions.                               |
| Video Group selection                                                 | Save the creative, create a new CTV export, select the required output, then click Publish All.               |

Publishing updates the existing deployment tag. You can continue using the same tag URL while keeping the same deployment.

Allow about a minute for manifest changes to appear, then retest. Recheck the relevant deployment's Status before handing off the tag.

### Troubleshooting

| Problem                                                 | What to check                                                                                                          |
| ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| CTV Settings or VAST Ad Tags is missing                 | Confirm that a format has Format Type set to VAST. Save and reopen the relevant editor or summary page.                |
| CTV Settings is difficult to find                       | Deselect all elements, then open Setup → CTV Settings.                                                                 |
| A group is missing from a dropdown                      | Confirm that it is a top-level group with content at the selected size and is not selected for the other role.         |
| The CTV export checkbox is missing                      | Select mp4 Video, confirm that a VAST format exists, and configure a Video Group.                                      |
| An export is missing from Default VAST MP4              | It must be complete, be an MP4, and have been exported with the CTV confirmation checkbox selected.                    |
| A deployment shows Needs video                          | Select a default CTV output or configure at least one usable DMA + Video row.                                          |
| A deployment shows Invalid video conditions             | Clear additional conditions from DMA + Video rows. Keep overlay-only targeting on separate rows.                       |
| Publish All finishes, but a deployment is not Published | Check that row's Status and message. Ineligible deployments are skipped, and individual manifest uploads can fail.     |
| The video plays without an overlay                      | Check the SIMID Group, publish with Publish All, and confirm VAST 4.2 and player support.                              |
| The wrong regional video plays                          | Check DMA codes, row order, selected media, and whether the latest rules were published.                               |
| The tag returns no ad                                   | Confirm that the manifest was published and that the request has a matching regional rule or a default video.          |
| Old video or settings still appear                      | Confirm that the correct replacement output is selected, click Publish All, allow about a minute, and test again.      |
| Buttons do not respond to a TV remote                   | Confirm that the creative includes the required remote-navigation behavior and test on the intended player and device. |

### Before handing off the tag

* [ ] Confirm the correct deployment and video output.
* [ ] Review dimensions, duration, frame rate, audio, and visual content.
* [ ] Verify clickthrough destinations and supplied trackers.
* [ ] Test regional rules and default-video or no-ad behavior.
* [ ] For SIMID, verify the overlay and interactions in a supported player.
* [ ] For CTV, verify required remote-control behavior.
* [ ] Confirm the deployment's Status is **Published**.
* [ ] Copy the appropriate VAST URL for the placement.
