Trigger SCTE-35 marker insertion by Nimble API

Nimble Advertizer has wide variety of options to insert ads, including inserting ads per SCTE-35 markers. So if your original stream has those markers and your Advertizer is set up to trigger ads for it, your output will have proper ads.

In addition to reacting to available SCTE-35 markers, Nimble Advertizer is able to insert new markers right at the moment you need them using Nimble API. This will trigger almost immediate ads insertion so it's a good way to implement your own "big red button" for per-request ads insertion. Here's how you can do it.

Enable SCTE-35 processing

To enable SCTE-35 markers insertion, you need to add the following parameter into Nimble Streamer config file:

scte35_processing_enabled = true

You can read this page to find out how exactly you can make changes to Nimble Streamer config.

Set up Advertizer

SCTE-35 insertion feature set is part of Nimble Advertizer. So first you need to create and subscribe for Addenda license.

Then you need to set up Advertizer according to Advertizer tech spec. This includes preparation of ads files and setup configuration. As part the setup, you'll define what streams will be reacting to markers. You can read article explaining SCTE-35 markers handling mechanics, including example of handler response.

Set up Nimble API

Markers insertion is performed via Nimble native API.

1. Use this API page to enable API first
2. Use "Insert SCTE-35 Out marker" call (see description) to perform insertion for Out marker in order to go on commercial.
3. Use "Insert SCTE-35 In marker" call (see description) to perform insertion for In marker in order to return from commercial if you don't want to rely on Out marker.

Try to call that method on some test streams to see how it triggers the insertion of ads.

Use markers insertion

Once you have your Advertizer ready for markers handling and know how to use proper API call, you may develop further setup for triggering ads via API call in your production environment.

Besides immediate insertion via Advertizer, you may pass through the inserted SCTE-35 markers for further processing. Read this article for details of this functionality.


If you find any issues with SCTE-35 feature set, please file us a support ticket so we could help you.

Related documentation

Nimble Advertizer, SCTE-35 markers forwarding and passthrough, Inserting ads by Nimble Advertizer using SCTE-35 markers, SCTE-35 markers support in Nimble Streamer Playout