AdConnect for MyAdbooker

Dise AdConnect enables the integration of 3rd party advertising platforms into Dise.

MyAdbooker is a programmatic DOOH SSP, please refer to MyAdbooker.com for more information. To use the AdConnect for MyAdbooker app, you will need an account and register your inventory with MyAdbooker. When registering the inventory, use the Display ID from Dise to identify each screen.

AdConnect works as follows (highly simplified):

An AdConnect “message” is published to a playlist and acts as a placeholder for one ad from MyAdbooker. The playlist may contain other content.

Before the Player is about to play out the AdConnect placeholder, an ad request is sent from the Player to MyAdbooker. The request includes the Display ID, which allows MyAdbooker to identify the display in the inventory and decide which ad to serve.

The chosen ad is served back to the player, where it will be played out. A proof of play message is sent back to MyAdbooker.

Installing and using the app

Make sure you are all set up in MyAdbooker, with all Display IDs registered in the inventory
Download the app here (Portrait and Landscape versions provided for convenience):
MyAdbooker (P)
89.70 KB
MyAdbooker (L)
89.71 KB
As a minimum, you need to enter your MyAdbooker credentials (Client ID and API key) in the config.json file in the zip file - see below.
Upload the zip (including any changes to the json files) as a template in the CMS.
Create a message from the template, and publish to playlist. There are some options when creating the message:
Duration - defines the maximum ad length allowed for playback. MyAdBooker may return ads with shorter durations.
Fallback Media - this optional media will be displayed if no ad is returned (204) or if an ad fails to play. The fallback content duration is fixed at 6 seconds
Slot ID - each ad request may contain a slot ID, used when multiple AdConnect instances run on the same player to display different content (e.g., scenario1, scenario2). If only one slot is configured in MyAdBooker, the field can be left empty or set to match that slot’s configuration.

Tip: AdConnect works well in combination with the Share of Voice feature in Dise

Customizing the app

To customize the app, unpack the zip file, edit the template.json and config.json files as described below, then create a new zip with all files.

Changing the template name in template.json:
```
"name": "MyAdbooker (L)",
```
This is particularly useful if you need several copies of the app covering different resolutions than the standard portrait and landscape versions provided here.
Changing the resolution in template.json, if you need other resolutions than standard portrait or landscape:
```
"targetWidth": 1920,
"targetHeight": 1080,
```
Setting the MyAdbooker Client ID and API key in config.json (mandatory):
```
"clientId": "abc",
"apiKey": "xyz",
```
Please enter your MyAdbooker credentials
Changing the MyAdbooker API url in config.json:
```
 "src": "https://api.myadbooker.com/v1/adrequests",
```
The app is pre-configured to use the MyAdbooker production environment with the url above. Please refer to MyAdbooker if you need a different url.
Impersonating a different Display ID config.json:
```
  "playbackDeviceId": "",
  "locationName": "",
  "lat": "",
  "lng": ""
```
Normally, the AdConnect app will read the actual Display ID from the player, but for test purposes, you can override this and hardcode a different ID in the config.json file.