How Add VAST & Custom Ads Integration in Admin Panel? - Streamit Laravel - Documentation

This document explains how Admin users can configure and manage Ads in Streamit (Laravel Backend). It covers both VAST Ads and Custom Ads, with step-by-step guidance and clear placement logic, ensuring easy understanding for non-technical users.

Overview

Streamit provides two powerful advertising modules:

VAST Ads Module – Automated, network-based video ads (programmatic).
Custom Ads Module – Manually managed, direct-sold or in-house ads.

These modules are designed to maximize monetization while maintaining a smooth user viewing experience across Mobile App, Web, and TV App.

1️⃣ VAST (Video Ad Serving Template) Module

The VAST module allows integration with programmatic ad networks such as:

Google Ad Manager
SpotX
SpringServe

VAST works via an XML-based Ad Tag URL, which the video player reads to fetch ads and tracking events automatically.

Ad Placement Logic & Timing

▶️ Pre-roll Ads (Entry Ads)

Trigger Logic: When the user clicks Play
Displayed: Before the main content starts
Best Use: Highest monetization value
Ideal For: Short promos, brand ads, guaranteed impressions

⏯ Mid-roll Ads (Engagement Ads)

Trigger Logic: When 50% of the video duration is completed
Displayed: During content playback
Best Use: Long-form content (Movies, TV Shows)
Ideal For: TV-style commercial breaks

⏹ Post-roll Ads (Retention Ads)

Trigger Logic: When 10% of the video duration remains
Displayed: Just before content ends
Best Use: Retention & promotions
Ideal For: Upcoming releases, next episode promos

🟦 Overlay Ads (Non-Interruptive Ads)

Trigger Logic: After 10% of content playback
Displayed: Small banner over the video player
Video Playback: Continues in background
Best Use: Brand visibility without interruption

Technical Constraints & Targeting

Granular Targeting:
- Assign VAST ads to specific Movies, Episodes, or Videos
- Serve context-aware ads based on content
Protocol Requirement:
- Must be a valid XML VAST URL
⚠️ Compatibility Note:
- Mid-roll, Post-roll, and Overlay ads are NOT supported for:
  - Vimeo videos
  - Embedded videos
- Reason: Third-party players have their own ad logic

Admin Steps – How to Add VAST Ads

Step 1

➡️ Navigate to the Admin Panel and open the Ads Manager module.

Step 2

➡️ Click on New button

Step 3

➡️ Fill required details:

Ad Type: VAST
Placement: Pre-roll / Mid-roll / Post-roll / Overlay
VAST XML URL
Content Targeting (Movie / Episode / Video)

Step 4

➡️ Click Save

User Side Display

you can see the added details.

User Side show

1. Website View:

2. Mobile View:

INFO

Mid-roll, post-roll, and overlay ads are not displayed within Vimeo & embedded movies, TV shows, or videos in the application.

2️⃣ Custom Ads Module

The Custom Ads module allows Admins to manage direct-sold or in-house ads without any third-party network.

This is ideal if you want to:

Promote your own content
Run local partner ads
Advertise subscription plans or offers

Placement Categories

Home Page Placement

Visual: Banner on Streamit Home Page
Strategy: High visibility
Best Use:
- Flash sales
- New features
- Brand takeovers

▶️ Player Placement (Interactive Pop-up)

Visual: Pop-up modal when user clicks Watch Now
User Action: Must close or click to continue
Best Use: High-impact promotions
Targeting Options:
- Specific Movie
- Specific Episode
- Specific Video

🧾 Banner Placement (Contextual Ads)

Visual: Banner below content title or description
Displayed On:
- Movie Details Page
- Episode Page
- Video Page
Best Use:
- Non-intrusive ads
- Long visibility during content browsing

🗂 Media Management & Redirection

📦 Supported Media Types

Images: JPG, PNG
Videos: MP4

🌐 Source Flexibility

Upload to Local Server (better speed)
Use External URL (saves storage)

🔗 Redirect URL

Every Custom Ad supports a Redirect Link
Clicking the ad can redirect users to:
- Subscription upgrade page
- External website
- Partner promotion page