Custom Ad Breaks

<?xml version="1.0"?>
<query>
    <userid>[UserID]</userid> {/* required*/}
    <userkey>[UserKey]</userkey> {/* required*/}
    <action>[Action]</action> {/* required*/}
    <source>[SourceFile]</source> {/* required*/}
    <format>
        <output>[advanced_hls|fmp4_hls|advanced_fmp4|advanced_dash]</output>
        <apply_timecode>[yes|no]</apply_timecode>
        {/* multiple ad_breaks may be included */}
        <ad_break>
            <start>[StartTime]</start>
            <end>[EndTime]</end>
            <duration>[BreakDuration]</duration>
            <drop_segments>[yes|no]</drop_segments>
            {/* multiple marker_type parameters may be included */}
            <marker_type>[MarkerType1]</marker_type>
            <marker_type>[MarkerType2]</marker_type>
            {/* ... */}
            <marker_type>[MarkerTypeN]</marker_type>
            <id>[BreakID]</id>
            {/* multiple upid_data sections may be included */}
            <upid_data>
                <segmentation_upid_type>[SegmentationUPIDType]</segmentation_upid_type>
                <segmentation_upid>[SegmentationUPID]</segmentation_upid>
            </upid_data>
            <upid_data>
                {/* upid_data params */}
            </upid_data>
            <add_cue_in_tag>[yes|no]</add_cue_in_tag>
            <add_discontinuity_tag>[yes|no]</add_discontinuity_tag>
        </ad_break>
        <ad_break>
            {/* ad_break params */}
        </ad_break>
        {/* multiple cue_inserts may be included */}
        <cue_insert>
            <start>[StartTime]</start>
            <end>[EndTime]</end>
            <duration>[BreakDuration]</duration>
            <drop_segments>[yes|no]</drop_segments>
            {/* multiple marker_type parameters may be included */}
            <marker_type>[MarkerType]</marker_type>
            <marker_type>[MarkerType2]</marker_type>
            {/* ... */}
            <marker_type>[MarkerTypeN]</marker_type>
            <id>[BreakID]</id>
            {/* multiple upid_data sections may be included */}
            <upid_data>
                <segmentation_upid_type>[SegmentationUPIDType]</segmentation_upid_type>
                <segmentation_upid>[SegmentationUPID]</segmentation_upid>
            </upid_data>
            <upid_data>
                {/* upid_data params */}
            </upid_data>
            <custom_tag>[CustomTag]</custom_tag>
            <add_video_keyframe>[yes|no]</add_video_keyframe>
        </cue_insert>
        <cue_insert>
            {/* cue_insert params */}
        </cue_insert>
    </format>
</query>
{
    "query": {
        "userid": "[UserID]", // required
        "userkey": "[UserKey]", // required
        "action": "[Action]", // required
        "source": "[SourceFile]",
        "format": { // required
            "output": "[advanced_hls|fmp4_hls|advanced_fmp4|advanced_dash]",
            "apply_timecode": "[yes|no]",
            "ad_break": [
                {
                    "start": "[StartTime]",
                    "end": "[EndTime]",
                    "duration": "[BreakDuration]",
                    "drop_segments": "[yes|no]",
                    "marker_type": [
                        "[MarkerType1]",
                        "[MarkerType2]",
                        // ...
                        "[MarkerTypeN]"
                    ],
                    "id": "[BreakID]",
                    "upid_data": [
                        {
                            "segmentation_upid_type": "[SegmentationUPIDType]",
                            "segmentation_upid": "[SegmentationUPID]"
                        },
                        {
                            // upid_data params
                        }
                    ],
                    "add_cue_in_tag": "[yes|no]",
                    "add_discontinuity_tag": "[yes|no]"
                },
                {
                    // ad_break params
                }
            ],
            "cue_insert": [
                {
                    "start": "[StartTime]",
                    "end": "[EndTime]",
                    "duration": "[BreakDuration]",
                    "drop_segments": "[yes|no]",
                    "marker_type": [
                        "[MarkerType1]",
                        "[MarkerType2]",
                        // ...
                        "[MarkerTypeN]"
                    ],
                    "id": "[BreakID]",
                    "upid_data": [
                        {
                            "segmentation_upid_type": "[SegmentationUPIDType]",
                            "segmentation_upid": "[SegmentationUPID]"
                        },
                        {
                            // upid_data params
                        }
                    ],
                    "custom_tag": "[CustomTag]",
                    "add_video_keyframe": "[yes|no]"
                },
                {
                    // cue_insert params
                }
            ]
        }
    }
}

🚧

Note

ad_break options are only available for advanced_hls, fmp4_hls, advanced_fmp4, and advanced_dash output formats.

🚧

For start and end parameters

Specifying will affect timecode value conversion of the and parameters of /.

👍

SCTE35 credits

For SCTE35 opening and closing credits, you can use a parameter block. It has the same sub-parameters as except .