The Frequency content can be integrated into your systems through any one of multiple paths. The integration options for Frequency's content and services are as follows:
- Full Service Integration - A Full Service Integration is the fastest way to share Frequency content with your customer base. A full service Frequency integrations includes the Frequency API services along a Frequency video player. A Full Service Integration is typically a client side integration, but can also include server side integration if a server infrastructure already exist.
- Standalone Video Player - The Frequency video player is a full featured player capable of playing all of Frequency's video content, advertisements, and handle ad and video play metrics beaconing. The standalone video player is expected to be the only video player on the client.
- Shared Video Player - Frequency has a version of the video player that can also operate in a "Lite" or shared mode. When using the Frequency "Lite" video player it can co-exist with other client side video players while still offering all the capabilities of the full Frequency video player, with the exception that it can only play HTML5 supported media types.
- Partial Service Integration - A Partial Service Integration uses the Frequency API services are used to access video content and its metadata, but used your video player instead of one of the Frequency video player options. A Partial Service Integration can either be client side, server side or a combination of client and server integration.
- Content only Integration - A Content only Integration is a licensing ingestion process that does not use any of the Frequency services or players.
The question of which integration path to use is significantly influenced by whether you are doing a fresh start implementation or will be integrating into an existing system. A fresh start implementation will will enjoy the head start of a full integration with the Frequency services, yet Frequency has integration options to best support your path to pipeline the Frequency video content into your infrastructure and ultimately clients.
A full integration with Frequency provides full access to all Frequency service APIs to access video metadata along with various video content personalization and search services. The available Frequency services include:
Added to these capabilities are two full featured video player options, a standalone player or a player capable of playing along side your existing video player.
Standalone Video Player
The standalone Frequency video player can play Frequency and non-Frequency video content. The player has complete advertisement VAST 3.0 support along with ad and video playback metrics beaconing. The standalone video player is the best option if there is not a specialized video player already in the client application. This is because in one step all video and advertisement capabilities are made available to your client app.
Shared Video Player
With a shared video player architecture there is an existing client video player and possibly its advertisement and beaconing operations that the Frequency video player must play alongside. To play alongside an existing player Frequency offers a "Lite" video player. The "Lite" player has the same advertisement and beaconing support as the standalone Frequency video player, the only difference is that the "Lite" player is built solely on a shared HTML5 video object and can only play HTML5 video object supported media types. In this arrangement the Frequency "Lite" video player plays the Frequency video content and the existing video player can play all non-Frequency content. If you don't have pre-existing specialized video handling, it is better to use the Frequency standalone video player. That is because the standalone player supports a larger diversity of player options and media types such as YouTube or content specific players.
No Player Integration
The no player integration path supports access to all of the Frequency service APIs as in the full integration path options, with the exception that you must handle all video playback, advertisement and beaconing support on your own. This path is best for server side integrations where where the Frequency content is seamlessly blended into your current content delivery infrastructure.
Content Only Integration
With the content only integration path you get licensed access to the Frequency content assets and raw metadata. The content assets and metadata would then be ingested into your systems.
Frequency Integration Comparison Table
|Integration Options||Full Integration|
(full video player)
(shared video player)
|No Player Integration||Content Only Integration|
|Video Discovery APIs||X||X||X|
|Video Metadata APIs||X||X||X|
|Shared Video Player||X|
Supports Content Supplied Players
|Video Metrics Beaconing||X||X|
|Video Metadata Ingest||X|
Full Integration with Video Player
The full integration with video player scenario includes the following steps:
- Authenticate with Frequency.
- Use the Frequency services to access video metadata.
- Play videos described in the metadata.
If you wish for the user state to be shared across multiple devices you could go a step further beyond device authentication and actually authenticate the user within the Frequency system.
It is important that the auth access token and device id are placed in the request header for all subsequent access of the Frequency services.
Links to the Frequency authentication services documentation:
Accessing Video Metadata
The Frequency video metadata and its various query modes, guide, search, rules, etc is then accessed through the Frequency API REST services. A typical Frequency REST call to access the video metadata looks like the following:
Note: The media url necessary to play a video, along with advertisement support is part of the video metadata returned in the API responses.
Links to the Frequency video metadata services documentation:
The following code snippet shows how to construct the Frequency video player and then use it to play a video:
Links to the Frequency video player documentation:
Full Integration with Shared Video Player
With a shared video player architecture the client has two video players, the existing client video player and the Frequency "Lite" video player. The Frequency video player plays the Frequency video content and the existing video player can play all non-Frequency content. This path is taken if the client app has an existing player for handling specialized content, advertisement or beaconing support. If specialized video handling does not pre-exist it is better to use the Frequency dedicated video player. That is because the dedicated player supports more media types than the shared "Lite" video player.
In a shared video player architecture the client infrastructure has its own HTML5 based video player. Since the Frequency "Lite" player also uses the HTML5 video object, both can share the HTML5 video object by both using the same video element id. A typical client registers for video playback events to mark playback start, progress and end. The only difficulty in a shared player architecture is insuring that the client app uses the video playback event correctly. If advertisements are not played events can be registered through the existing video player, ignoring the "Lite" player events. When advertisements are played with the Frequency "Lite" player it is required for the "ended" video player event be switched from the existing player to the Frequency "Lite" player. This is because when playing advertisements the Frequency player will only send video end events when the requested video has finished playing and not at the end of advertisement segments. The remainder of the standard HTML5 video events can be shared seamlessly between the client video players.
The following code snippet describes how to create a shared video player configuration and how to switch the video player "ended" event from one player to the next.
Links to the Frequency video player documentation:
No Player Integration
The no player integration path is a simplification of the above scenarios. Frequency services are used to access video metadata as shown in the above scenarios and your own player is used to play the video content. In this scenario you are responsible for all advertisement and video metrics beaconing. To perform the Frequency required beaconing you would need to authenticate as shown above and post beaconing events using the Frequency activities services. This is done as follows:
Links to the Frequency video Activities services documentation:
Content only Integration
There is not a formal integration procedure for a content only integration. This could be a one time video metadata dump with or without periodic metadata updates. When a content only integration is considered all details and steps to the integration would have to be negotiated.