Documentation
Learn how to submit a VAST or VPAID tag request on ad:personam. This guide covers the request form, required fields, processing timeline, and best practices for XML-based video ad creatives.
VAST (Video Ad Serving Template) and VPAID (Video Player-Ad Interface Definition) tags let you run XML-based video ad creatives across premium programmatic inventory. On ad:personam, VAST tag creation is handled as an asynchronous request — you submit the details through a dedicated form, and the ad:personam ad operations team configures the creative in the ad-serving platform on your behalf.
Note: VAST ad submissions require a paid subscription plan.
How the VAST Request Process Works
Unlike standard display or video file uploads, VAST creatives require manual configuration in the underlying ad-serving platform. When you submit a VAST tag request:
- Your request is sent directly to the ad:personam ad operations team.
- You receive a confirmation copy of the request via email (CC).
- The team creates and configures the VAST creative, including tracking setup and line item assignment.
- Allow 1–2 business days for your VAST creative to be live.
This process ensures proper VAST XML validation, tracking integration, and compliance with IAB standards before the creative goes live.
Step-by-Step: Submit a VAST Tag Request
- Navigate to Advertiser > Campaign > Creatives.
- Click Create New Ad and select Video VAST Tag.
- Fill in the required fields (see below).
- Click Submit VAST Tag Request.
- You will see a confirmation message once the request is submitted.
Form Fields
All fields are required unless stated otherwise.
| Field | Description |
|---|---|
| Ad Name | A clear, descriptive name for your creative. Minimum 2 characters. This name will be displayed throughout the platform. |
| VAST XML URL | The secure HTTPS URL pointing to your VAST XML file hosted on a CDN. Must be a valid, accessible URL that returns VAST-compliant XML. |
| Landing Page URL | The click-through destination URL (HTTPS required). This is where users land after clicking the video ad. |
| Associated Line Item | The line item this VAST creative will be assigned to. Select from the available line items in your current campaign. |
VAST XML Requirements
URL Specifications
- Protocol: Must use HTTPS for secure delivery
- Hosting: URL should point to a CDN-hosted VAST XML file that is active and publicly accessible
- Content: Can contain Flash, HTML, or JavaScript content
- Compliance: XML must comply with IAB VAST standards and return valid, well-formed XML when accessed
What Happens If My URL Is Invalid?
The ad operations team will verify your VAST XML URL during setup. If the URL is inaccessible, returns empty content, or fails VAST validation, you will be contacted to provide a corrected URL — which may delay the 1–2 business day timeline.
Validation Rules
- Ad Name: Minimum 2 characters required
- VAST XML URL: Must be a valid URL starting with
https:// - Landing Page URL: Must be a valid URL starting with
https:// - Line Item: Must select an existing line item from your campaign
Troubleshooting VAST Creative Issues
Validate Your VAST XML
- Use a VAST validator (such as the Google VAST Inspector) to check if your URL returns valid VAST XML
- Ensure the XML complies with IAB VAST standards
- Verify the URL is accessible and returns proper content
Check URL Accessibility
- Open the VAST URL directly in a browser to verify it returns XML
- If the response is empty, the URL may be inactive or misconfigured
- Contact your CDN or hosting provider to resolve URL issues
Domain and Geographic Restrictions
- Ensure your hosting service is not blocking ad-serving domains (e.g.,
adnxs.com) - Check for geographic restrictions that could prevent the ad operations team from accessing your URL
- Whitelist necessary domains if required
Tips & Best Practices
- Descriptive naming — Use clear, meaningful names so the ad operations team and you can easily identify the creative
- Test your URL first — Always verify your VAST XML URL loads correctly in a browser before submitting
- Use reliable CDN hosting — A fast, globally available CDN ensures optimal ad delivery and avoids geographic access issues
- VAST validation — Run your XML through a VAST validator before submission to avoid delays
- Line item readiness — Make sure the target line item is already created and configured before submitting your VAST request
- Check your email — You will receive a CC copy of the request with all submitted details for your records