Documentation

Getting started with LtvAdx

From zero to your first VAST ad impression on CTV — choose your path below.

📺

Publisher Quick-Start

Monetise your FAST channel, streaming app, or linear TV inventory with VAST tags and SSAI.

Create channel & ad breaks
Get VAST tag URL
Verify first impression

🎯

Advertiser Quick-Start

Run HouseholdID-targeted CTV campaigns with verified VCR and cross-screen attribution.

Create campaign & line items
Upload VAST creative
Review VCR dashboard

Publisher quick-start

1. Create your account

Sign up and select the Publisher role. After email verification, our team activates your account within 24 hours on business days. You will receive an email when your account is ready.

2. Create a channel

In the dashboard, go to Publisher Portal → Channels & Apps → Add Channel. Configure:

Platform — Roku, Fire TV, Samsung Tizen, LG webOS, Android TV, or Linear
Content model — AVOD, FAST, BVOD, or LINEAR_TV
Floor CPM — minimum bid price in USD (e.g. $5.00)
IAB category — content genre for contextual targeting
SSAI enabled — toggle on for server-side ad insertion

Submit the channel for admin review. Once approved (typically within 1 business day), the channel is eligible to serve ads.

3. Define ad break slots

Go to Publisher Portal → Ad Breaks → Add Break. For each break, set: break type (PRE_ROLL / MID_ROLL / POST_ROLL), pod size (max ads per pod), max duration, and optional SCTE-35 cue ID for live streams.

4. Get your VAST tag URL

Use the VAST Tag Generator at Publisher Portal → VAST Tag Generator. Select your channel and platform. Copy the generated VAST URL:

https://ads.ltvadx.com/vast
  ?channelId=YOUR_CHANNEL_ID
  &adBreakId=YOUR_BREAK_ID
  &platform=ROKU
  &householdId={HOUSEHOLD_ID}
  &duration=30

5. Integrate into your player

Configure your CTV player to request the VAST URL at each ad break. Replace {HOUSEHOLD_ID} with the HouseholdID resolved from your server-side identity lookup (see the Identity API guide). For SSAI streams, see the SSAI integration guide.

6. Verify your first impression

Trigger an ad break in your test environment. Open Publisher Portal → Reports and confirm an impression appears within 2 minutes. A fill rate of 0% means no eligible line items are targeting your channel — ask the network admin to create a test campaign.

Advertiser quick-start

1. Create your account

2. Load credits

Navigate to Billing → Add Credits. Minimum top-up is $100 USD. Credits are deducted in real time as impressions are delivered — no monthly subscription.

3. Create a campaign

Go to Advertiser Portal → Campaigns → New Campaign. Set campaign name, buying model (CPM / CPV / CPCV), total budget, daily budget, and flight dates.

4. Create a line item with targeting

Under your campaign, create a line item. Key targeting settings:

Platforms — Roku, Fire TV, Samsung Tizen, etc.
Content model — AVOD, FAST, BVOD, LINEAR_TV
Countries — geographic targeting
Bid CPM — must exceed channel floor CPMs to win impressions
Frequency cap — max impressions per household per window
Min VCR threshold — only serve on channels where ML-predicted VCR exceeds this level

5. Upload a VAST creative

Go to Advertiser Portal → Video Creatives → Upload Creative. Paste your VAST 4.2 wrapper URL or a direct CDN video URL. Creatives require admin approval before they are eligible to serve — allow 1 business day.

6. Monitor delivery

Once your creative is approved and your line item is active, delivery begins automatically. Monitor impressions, VCR, and spend in real time at Advertiser Portal → VCR Dashboard.

Developer quick-start

For technical integrations, start with these guides:

VAST Tag Integration — VAST 4.2 on Roku, Fire TV, Android TV
SSAI Integration — HLS/DASH server-side stitching
OpenRTB 2.6 — connecting DSP seats and bid endpoints
Identity API — HouseholdID resolution and ACR signals
Developer Hub — code examples for all four integration paths

# Quick test: resolve a household, then request a VAST tag
curl "https://api.ltvadx.com/api/v1/identity/resolve" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ipAddress":"203.0.113.1","platform":"ROKU"}' | jq .householdId

# Request VAST with the resolved householdId
curl "https://ads.ltvadx.com/vast?channelId=YOUR_CHANNEL&householdId=hh_xxx&platform=ROKU"

Getting help

Browse the full documentation in the sidebar, or visit the Help Centre for FAQs. For integration support, contact us — include your Channel ID or Campaign ID and a description of the issue.