Skip to content
Kettledrum

Help / Dynamic ads

Set up dynamic ad insertion

Stitch is available on Timpani and Orchestra. It replaces fixed ads baked into the file with spots chosen when each listener downloads.

How Stitch works

Your episode is stored in Vault as a main body split at cue points. At download time, Stitch picks one prepared spot for each cue and joins the segments on codec frame boundaries. Delivered files have no gap, and the byte total includes the ads. Typical added latency is 6 ms.

Place cue points

  1. Open the episode, choose Ads, and click the waveform where an ad break should start.
  2. Pick a break length: 15, 30 or 60 seconds. Snap to silence is on by default and moves the cue up to 1.5 seconds to the nearest pause.
  3. You can place a pre-roll, post-roll and up to 6 mid-rolls.

If your editor writes chapter markers, name a chapter ad-break and Stitch imports it as a cue point on upload.

Campaigns and caps

A campaign is one or more audio spots with a date range, targeting and limits. Each cue point asks the campaigns that match the listener and picks the one with the highest priority that has not reached its cap.

  • Targeting: country, region, listening app, episode and time of day.
  • Caps: total impressions, impressions per day, and impressions per listener per week.
  • Fallback: a house spot plays when nothing matches. Without one, the break is skipped and the episode continues.

Cue point API

Set cue points from your own tools. Replace the token and ids with yours.

curl -X PUT https://de3.enotcloud.com/v1/episodes/ep_8f3k2/cues \
  -H "Authorization: Bearer $KD_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"cues":[{"at":0,"length":15},{"at":760,"length":30},{"at":2410,"length":30}]}'

On Orchestra you can also connect an ad server that returns VAST 4.2 or DAAST. Stitch requests a response per cue, waits at most 250 ms, and uses your fallback if the server is late.

Troubleshooting

  • Ad did not play: check the campaign date range and cap in Ads, Delivery log. Each decision lists the reason it was chosen or skipped.
  • Audible click: the spot was uploaded as MP3 with a different sample rate. Re-upload as 48 kHz WAV.
  • Preview shows no ads: previews use the master body without stitching. Open the delivered file to hear a real insertion.