SofAds docs

SofAds is the ad network for Smart TV apps and games. Which side are you on?

I make TV apps or gamesAdd the SDK, test your ads, go live and get paid.I advertiseBook campaigns, build QR cards and video ads, and follow your results.

Want to see it first? Try the live demo: a small TV game with the real SDK and real test ads.

For publishers

New here? Start with the live demo: a small TV game in your browser with the real SDK, real test ads and a live log of every SDK call, so you see what you are about to build.

Everything a TV platform needs before the SofAds SDK can show ads: manifest entries, script order, privacy policy lines, and how to test before your listing is live. Every call, option and event is in the SDK reference.

Start here

Three steps, whatever the platform:

1. Include sofads.min.js in your app (the setup page for your platform shows exactly where).

2. Start the SDK with your app ID from the dashboard:

   SofAds.init({ appId: "sof_YOUR_APP_ID" });

3. Show ads at natural breaks. Until your store listing is live, every ad is a test ad.

Platform setup

• Samsung Tizen setup

  Complete index.html and the starter config.xml: webapis.js before the SDK, access and navigation rules, privileges, the Google (PAL) block and hosted apps.

• LG webOS setup

  appinfo.json, when you need webOSTV.js, BACK handling and LGUDID with user agreement.

• Whale TV setup

  Hosted web apps, loading the SDK from your server, and the WAID getter.

• Titan OS setup

  Including the Titan SDK, passing its device info to SofAds, and which IDs are never read.

SDK, testing and ad formats

• SDK reference

  Init options, interstitial and rewarded ads, events, rewards and onReward, consent, test mode and the debug overlay.

• Test ads and test devices

  Why an app gets test ads, what each placement shows, the scan test, and registering your own TV as a test device.

• Skippable ads

  How the skip countdown and the "Skip ad" button work, RTL placement, remote focus and skip tracking.

• Privacy and consent

  Consent and TCF, Made for children apps, which IDs the SDK reads per platform and when, and privacy policy lines.

• Troubleshooting

  Only test ads, no fill, kill switches, webapis.js missing, pending listings, app-ads.txt not found and Made for children.

• SDK changelog

  Every SDK version and what changed in it, so you know what you get when you upgrade.

Going live and getting paid

• Release checklist

  Everything to check before you submit: listings, test settings, Tizen config.xml, hosted apps, consent and privacy lines.

• Listings and app-ads.txt

  Adding a listing with your app ID, the SofAds line with your seller ID, and when a listing switches from test ads to live.

• Earnings and payouts

  Your revenue share, estimated and final earnings, the payout threshold and your payout details.

Monetization per platform

Store rules, advertising IDs and payments per platform are in the Smart TV app monetization overview:

• Tizen monetization: packaged web apps, Samsung Checkout for IAP, TIFA as advertising ID.
• LG webOS monetization: no public LG ads API, Paymentwall for payments, LGUDID with user agreement.
• Whale TV monetization: hosted apps on 400+ TV brands, an ad program with three revenue models.
• Titan OS monetization: hosted apps on Philips and AOC TVs in Europe, an advertising ID in the Titan SDK.

For advertisers

Full-screen ads on the biggest screen in the house, with a QR code that hands viewers a phone-sized next step. You book and pay for campaigns yourself in the advertiser area of the dashboard.

• Getting started

  Your advertiser account and team, verifying your landing domains, and adding balance by bank transfer.

• Creating a campaign

  The wizard step by step: targeting, the reach estimate, schedule, budgets and frequency caps, review.

• Creatives and specs

  QR cards, video and VAST tags: sizes, text limits, languages, landing URL macros and the family-safe rules.

• Pricing

  Pay per view, per scan or per result: what decides your price, CPA payouts and what is never billed.

• Conversion postback

  For pay-per-result campaigns: the click ID in the landing URL, the postback URL and its answers.

• Stats

  Impressions, scans, conversions and spend per day, by campaign, creative, country or platform.

Every ad follows the SofAds ad policy: family-safe, honest, and only to your own landing pages.