Documentation

Complete guide to integrating and using PopAds

Table of Contents

Getting Started

Welcome to PopAds

PopAds makes it easy to monetize your video content with our VAST-compliant ad tag. This guide will help you integrate PopAds into your video player in just a few minutes.

Prerequisites

  • • A PopAds publisher account
  • • Your unique VAST Tag URL
  • • A VAST 2.0+ compliant video player

Quick Setup Steps

  1. 1

    Get Your VAST Tag

    Sign up or log in to your PopAds dashboard to retrieve your unique VAST Tag URL.

  2. 2

    Choose Your Player

    Select from our integration guides for Video.js, JW Player, Brightcove, or any VAST-compliant player.

  3. 3

    Integrate & Test

    Add the VAST Tag to your player configuration and test that ads are serving correctly.

  4. 4

    Go Live

    Deploy to production and start earning revenue from your video traffic.

VAST Tag Integration

Your VAST Tag URL

Your VAST Tag URL is unique to your account and can be found in your publisher dashboard. It looks like this: 

https://popadsnetwork.com/YOUR_PUBLISHER_ID/vast.xml

Basic Integration

Most VAST-compliant video players accept a VAST Tag URL in their ad configuration. Here's a generic example: 

<script>
  var player = videoPlayer({
    adTagUrl: 'https://popadsnetwork.com/YOUR_PUBLISHER_ID/vast.xml'
  });
</script>

Important Note

Always use HTTPS for your VAST Tag URL to ensure compatibility and security.

Video.js Setup

Installation

First, install Video.js and the IMA plugin: 

npm install video.js videojs-ima

Configuration

Add the following code to integrate PopAds with Video.js: 

<video id="my-video" class="video-js" controls preload="auto">
  <source src="your-video.mp4" type="video/mp4">
</video>

<script>
  var player = videojs('my-video');
  
  player.ima({
    adTagUrl: 'https://popadsnetwork.com/YOUR_PUBLISHER_ID/vast.xml'
  });
</script>

JW Player Setup

Configuration

JW Player has built-in VAST support. Configure it like this: 

jwplayer("my-player").setup({
  file: "your-video.mp4",
  advertising: {
    client: "vast",
    schedule: {
      adbreak1: {
        offset: "pre",
        tag: "https://popadsnetwork.com/YOUR_PUBLISHER_ID/vast.xml"
      }
    }
  }
});

Multiple Ad Breaks

You can add multiple ad breaks at different positions: 

advertising: {
  client: "vast",
  schedule: {
    preroll: {
      offset: "pre",
      tag: "https://popadsnetwork.com/YOUR_PUBLISHER_ID/vast.xml"
    },
    midroll: {
      offset: "50%",
      tag: "https://popadsnetwork.com/YOUR_PUBLISHER_ID/vast.xml"
    }
  }
}

Testing & Debugging

Verify Integration

Follow these steps to ensure your integration is working correctly:

  • Load your page with the video player
  • Play the video and verify the ad loads before content
  • Check browser console for any errors
  • Verify impressions appear in your dashboard

Common Issues

Ads Not Loading

Check that your VAST Tag URL is correct and uses HTTPS. Verify your account is approved.

CORS Errors

Ensure your page is served over HTTPS when using the VAST Tag.

Player Compatibility

Verify your video player supports VAST 2.0 or higher.

Optimization Tips

Maximize Your Revenue

Placement Matters

Pre-roll ads typically have the highest completion rates and CPMs.

Video Quality

Higher quality content attracts premium advertisers and better CPMs.

User Experience

Balance ad frequency with user experience to maintain engagement.

Mobile Optimization

Ensure your player is responsive and works well on mobile devices.

Need Help?

Our support team is here to help you get the most out of PopAds. We offer multiple ways to get assistance:

Telegram Support

Join our Telegram channel for instant support and community help.

Join Channel

Email Support

Send us an email for detailed technical questions.

support@popadsnetwork.com

Response Times

Telegram: Usually within minutes • Email: Within 24 hours