(wip) Content Ingestion

Springserve has partnered with Streaming to enable seamless sharing of publisher content metadata. To facilitate this integration, the content metadata must be provided in a CSV or RSS file format, which needs to be added in the Streaming platform for access by Springserve.

For detailed instructions on how to import CSV files or add RSS feeds, please refer to the following guide [here]. This will walk you through the necessary steps to ensure that your content metadata is properly configured and accessible.

Accessing the Metadata in Springserve:

Once the data is available in Streaming, you need to contact your Springserve account manager to enable the content ingestion feature setting for your account. Once this feature is activated, your account will be able to call an API that fetches the metadata associated with the content_id={{CONTENT_ID}} parameter. This parameter must be present in each request to retrieve the relevant metadata.

For information on setting up content targeting in Springserve, refer to the guide: [Content Attribute Targeting]

The following content attributes will be targeted based on the value of the content_id macro:

  • content_id

  • content_title

  • content_series

  • content_season

  • content_episode

  • Duration

  • content_categories

  • rating

  • content_genre

  • content_producer_name

  • network_name

  • channel_name

  • content_livestream

  • production_quality

  • cuepoints

Example Metadata and Usage:

Below is a sample row of metadata:

seatId

seriesName

videoTitle

contentRating

producer

genre

network

channel

content_id

seatId

seriesName

videoTitle

contentRating

producer

genre

network

channel

content_id

78910

Bluey

Hats

TVG

Brumm

kids

Net1

ch-12

12345

If the request contains the content_id parameter, Springserve will call the API and populate all associated metadata in outbound requests for ads.

Example Inbound Publisher Request:

https://tv.springserve.com/vast/32123?w=1920&h=1080&cb={{CACHEBUSTER}}&ip={{IP}}&ua={{USER_AGENT}}&pod_max_dur={{POD_MAX_DUR}}&pod_ad_slots={{POD_AD_SLOTS}}&content_id=12345&did={{DEVICE_ID}}

Sample Outbound Request:

The following represents a sample outbound OpenRTB spec where the content object contains all the associated metadata for content_id=12345:

"content": { "id": 12345, "title": "Hats", "series": "Bluey", "genre": "Kids", "producer": "Brumm", "contentrating": "TVG" }, "ext": { "channel": "ch-12", "network": "Net1" }

This approach ensures that metadata such as title, genre, producer, and more is shared between Springserve and Streaming to enhance ad requests.