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 and VMAP tags.

  1. Create a channel
  2. Get VAST tag URL
  3. Verify first impression
🎯

Advertiser Quick-Start

Run household-capped CTV campaigns with signed tracking and per-creative VCR reporting.

  1. Create campaign & line items
  2. Upload VAST creative
  3. 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)
  • Category — content category for the channel

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

3. Decide your break types

Each VAST request states its break type (PRE_ROLL, MID_ROLL, POST_ROLL or BUMPER) and the seconds available. Ad-break records in the portal are for your own planning — the ad server uses the values on the request.

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
  &platform=ROKU
  &breakType=MID_ROLL
  &duration=30
  &householdId={HOUSEHOLD_ID}

5. Integrate into your player

Configure your CTV player to request the VAST URL at each ad break. Replace {HOUSEHOLD_ID} with a stable household id — your own, or one from the Identity API. Without it, frequency caps and audience targeting do not apply. SSAI is not ready for live traffic yet — see the SSAI guide.

6. Verify your first impression

Trigger an ad break in your test environment. Open Publisher Portal → Revenue and confirm the impression appears within a few minutes. An empty VAST means no eligible line item targets your channel yet — ask the network admin for a test campaign, and quote the response's X-Request-Id.

Advertiser quick-start

1. Create your account

Sign up and select the Advertiser role. After approval, sign in to app.ltvadx.com.

2. Load credits

Navigate to Wallet. Minimum top-up is $100 USD (18% GST is added). Credits are deducted as impressions are billed — no monthly subscription.

3. Create a campaign

Go to Advertiser Portal → Campaigns → New Campaign. Set campaign name, total budget, daily budget, and flight dates. Impressions are billed at CPM. Line items serve under an order, which needs approval.

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 — applied only to requests that carry a country
  • Bid CPM — must exceed channel floor CPMs to win impressions
  • Frequency cap — max impressions per household per window
  • Min VCR threshold — skip serving when the creative's measured 7-day VCR is below this level

5. Upload a VAST creative

Go to Advertiser Portal → Video Creatives → Upload Creative. Paste your VAST 4.2 wrapper URL or a video file URL. Creatives need admin approval before they can serve.

6. Monitor delivery

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

7. (Optional) Sequence multiple creatives with an Ad Journey

Instead of a single flat line item, use Advertiser Portal → Journeys → New Journey to sequence households through multiple ad steps — an introductory creative, a follow-up offer, a closing message — with CPM that increases automatically as a household shows more intent. See the Ad Journeys overview for how branching and the conversion pixel work.

Developer quick-start

For technical integrations, start with these guides:

YOUR_API_KEY below is a self-service API key — generate one from Settings → API Keys in the dashboard. The raw key is shown once at creation; it authenticates exactly as your own dashboard login would. The identity call below needs a publisher (or admin) account's key.

# 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 '{"deviceId":"YOUR_DEVICE_ID","ip":"203.0.113.1","platform":"ROKU"}' | jq .householdId

# Request VAST with the resolved householdId
curl -sD - "https://ads.ltvadx.com/vast?channelId=YOUR_CHANNEL&householdId=hh-xxx&platform=ROKU&breakType=PRE_ROLL"

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.