API solution for FRAMEN's exclusive content and monetisation

We offers different solutions to connect to your existing CMS or Digital Signage system.

40
M
Requsts per Day
20
M
People Reach Daily
100
+
Entertainment Channels
20
+
Creators

Monetise your inventory

api configuration

Scope

A GET-Request is being made to the RESTful vendor API in order to request for content of a specific Player for one play out. The response returns information about the content pieces to be played. In this case it returns two objects which describe the editorial content and the advertisement. Both objects can describe either an image, video or HTML.

Requirements

A stable internet connection and custom development for integration of our API

Programmatic Content Delivery

Programmatic describes the dynamics of delivering different content based on external factors and its ability to communicate and change in real time.

With other words this means, that every single play out of content needs to go through communication between the platform and the requesting device.

Implementation

Depending on the news setup, they will always be returned with either HTML, video or image file type. For HTML cases, the url needs to be opened in a WebView.When ads are delivered, the object will return meta data for this single play out. Ads can be pre-cached to reduce data traffic when the same creative is supposed to be run again.

PArams

key
type
required
org_token
string
true
screen_id
string
true

Response

key
type
data
key
type
requestId
string
3f7655be-2c46-4d98-a8d5-5bcb03d118c9
news
key
type
id
string
Itm_8Mfw51pXWMt
title
string
Putzerlippfische erkennen sich
mimeType
string
text/html
height
int
1080
weight
int
1920
newsType
string
WELT_WISSEN
duration
int
15000
url
string
https://framen.tv/lite/?itemId=685997
pop
string
https://api.framen.com/v3/lite_feedback?eventName=playback&eventValue=50&spotId=5f131bc6-306e-42ab-a7f8-777549f2cf00
ad
key
type
id
string
1Hisf8pfqrm2VgZWrakDm
title
Test_Creative_6_Landscape-10sec
mimeType
string
video/mp4
height
int
1080
width
int
1920
duration
int
10000
url
string
https://framen-pics.s3.eu-central-1.amazonaws.com/video-588530a1-7964-403b-a6ed-f51f00693db
pop
string
https://api.framen.com/v3/lite_feedback?eventName=playback&eventValue=50&spotId=721397556
billable
boolean
true | false
newsFirst
boolean
true | false
Inventory

Location

Locations act as geographical anchors and groups of screens. They define availabilities and categorize the environment. Screens can not exist without Locations, so please create Locations beforehand. Locations go through an approval process performed by FRAMEN.

Screens

Create a Screen within your organization, a screen belongs to a location and will be used in the API call. FRAMEN can also do bulk imports when necessary.

Dynamic Inventory Sync

Locations and Screens can be created, read and updated via dedicated APIs to ensure up-to-dateness of data and to make additions of screens as easy as possible.

trading setup

Creatives Approval

All creatives within a campaign targeting your screens will trigger a request that needs to be reviewed within 48 hours. The request is sent via email to the email of the account. You can also turn on the "Instant approval" feature where all ads will be approved first and you have 48 hours to reject them. Approval settings can be found in the FRAMEN dashboard.

Alternatively we also offer an API to retrieve all creative approval requests.

Ad Reports

All report and analytics data will have to be accessed via the FRAMEN dashboard.
The reports tab provides a summary of advertising data for each connected screen or display. It details all the ads that have been shown, the total number of ad spots played, and the overall impressions made.

Earning Overview

The earnings dashboard presents a comprehensive look at your total income and monthly earnings, which you can conveniently download as a PDF report.

Programmatic Content Delivery

Enjoy highly relevant content that align perfectly with your preferences and interests of your audience. As a result audiences have maximum content relevance.

Maximum Flexibility

Our API provides a range of adjustable parameters to suit your preferences. Easily change the priority or repetitiveness of advertisements and your own content.

Update Inventory

Easily bulk import your inventory to the FRAMEN system to make it available on our platform. Use the dashboard to manage and tweak your listings.

Creatives & Approval

Review and approve campaign creatives targeting your screens within 48 hours, or opt for "instant approval" with a 48-hour period to reject them as needed.

Be part of a big network

No-Code Implementation

Alternatively to our API, we offer several other option to connect with our platform.

Smart TV / App

The FRAMEN Screen Manager is available for Android TV and Fire OS App Markets. If you have screens running these OS just download the app and you are good to go.

Streaming Sticks

No Smart TV? No problem. Using an Android, Fire OS or Google Chromecast streaming stick will allow you to download our app.

FRAMEN logo

FRAMEN TV Box

FRAMEN also provides a Ready-to-Go content management solution. This is the best universal way to connect. Contact us to get details on technical requirements.

Request documentation