Enabling ads using Google Ad Manager

Overview

OpenTV Platform supports client-side ad insertion (CSAI) using Google Ad Manager. This section explains what a client application needs to do to implement this.

Prerequisites

Before a client application can implement ad insertion, you must ensure that:

• Live and VOD content are ingested with the correct metadata to:

  • Enable ad insertion at the channel or content level.

  • Specify the time offset and duration for each ad to be inserted.

  See the csaiEnabled and csaiAdCueTimes elements in:

  • For XML ingest:

    • editorialChannel (editorial-based)

    • editorialContent (editorial-based)

    • technicalContent (editorial-based)

  • For ingest via API:

    • Creating an editorial channel

    • Creating an editorial content

    • Creating a technical content

  You can also enable/disable ads and set the time offsets in OpCon. See:

  • To enable/disable ads for a channel – Manage channel metadata

  • To enable/disable ads and set time offsets and ad durations for editorial and technical content:

    • Editing Editorial information

    • Technical versions

• The client application has integrated the appropriate Google Interactive Media Ads (IMA) SDK.

• The client application has integrated with Didomi for consent management to ensure that users' ad personalisation preferences are respected.

To enable ads and specify time offsets and durations for a broadcast (live) event, you must set them on the editorial and/or technical content that is linked to the event.

You cannot set them on an event object directly.

Once live events have been ingested with the correct CSAI metadata (on the linked editorial/technicals), the metadata is propagated to all generated catch-up and recorded content (if ads are enabled for the channel).

Use cases

The client application must implement the following use cases: