Syndication Jobs

A job is an active or scheduled instance that pushes content from an Uplynk channel or live event to a configured target.

You can create a job by:

• Starting from a channel or live event (classic method).
• Starting from the "Jobs" page (new method).

Each job:

• Is linked to its originating target.
• Inherits the configuration from the Job Template (but can be customized).
• Can be tracked via the "Linked Jobs" tab on the target.
• Can be edited independently after creation.

If a job diverges from the template, an "Out of sync with target" status will appear, and you can re-sync it to match the original configuration.

Creating a Syndication Job

Once you’ve created a Syndication Target, you can syndicate your stream by creating a job. Jobs represent the connection between an Uplynk channel or live event and a destination target. A job carries configuration for quality, renditions, markers, and more.

You can create a job in one of two ways:

Option 1: From the Syndication Jobs Page

1. Open the Syndication page from the left-side navigation
2. Click "Syndication Jobs".
3. Click "+ Job".
4. Select a channel or live event.
5. Select a target.
6. Click "Create Job".
7. (Optional) Edit the job configuration. By default, it inherits settings from the target’s Job Template.

Option 2: From a Channel or Live Event

1. Navigate to your Channel or Live Event.
2. Go to the Syndication (or Publish) tab.
3. Click "+ Add Target".
4. Select a Syndication Target from the list.
5. Click "Create Job".
6. (Optional) Edit configuration settings (e.g., quality, SCTE-35, metadata).

📘

Each job is initially in a stopped state. Only one job per target can be active at a time.

Configuration Settings

When creating a job, you can:

• Inherit from the Job Template (default behavior).
• Customize per job (which may cause it to go “Out of sync” with its target).

Key Configuration Options

• Video Quality: Low, Medium, or High (for RTMP/SRT/Zixi/etc.).
• Ray Selection: For HLS Push or Pull (select one or more resolutions to be included in the stream).
• SCTE-35 Marker Transmission:
  • Inserted at ad breaks (Channels) or markers (Live Events).
  • UPID set to external ID of the source.
• Output Location: Auto (recommended) or custom AWS zone.
• Key-Value Metadata: Custom query parameters appended to playback URLs.

📘

Some platforms (like YouTube or Facebook) also allow integrated auth settings like title, privacy level, and audience flags.

Job Status Definitions

Example error causes: invalid stream key, platform rejection, destination not reachable.

Best Practices & Notes

• Only one job per target can be active at a time, because the target’s connection info (e.g., URL, stream key) must remain unique per stream.
• Use consistent encoding resolutions (e.g., avoid mixing 720p slate with 1080p content) to prevent resolution capping or bitrate instability.
• For HLS Pull, copy the generated pull URL after the job is active and configure your destination platform to pull from it.
• If using integrated authentication (e.g., for YouTube/Facebook), Uplynk can automatically trigger a “go live” once streaming begins.
• To delay playback, inject ad parameters, or tag delivery, use query string parameters in the manifest.

Monitoring Jobs

To view all jobs:

1. Open the Syndication page from the left-side navigation.
2. Click the Jobs tab.
3. Use filters to narrow results by Channel, Live Event, or Job Status.

This view lets you quickly:

• Audit which jobs are currently active
• Review recent job history
• Troubleshoot failed syndication attempts