AdConnect for Seibidou

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

Seibidou is a programmatic DOOH RAP, please refer to Seibidou for more information. To use the AdConnect for Seibidou app, you will need an account with Seibidou.

AdConnect works as follows (highly simplified):

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

Before the Player is about to play out the AdConnect placeholder, a request is sent from the Player to Seibidou to get a full list of ad content for the upcoming hour. The DeviceID is then used to filter what content the relevant player should play.

The Seibidou integration is built around two key components: the Player and the Worker, which communicate using a BroadcastChannel.

The Player handles playback. It requests ads from the Worker, preloads and plays them, and reports back to the Worker when playback completes.
The Worker manages all communication with the RAP API. It handles playlist fetching, media caching, scheduling, and supplies the next ad to the Player for playback.

Installing and using the app

Make sure you are all set up in Seibidou, with a source URL, cmsType and api key.
Download the worker app here:
Seibidou-Worker
2.55 MB
Ensure the source URL, cmsType and API key in the config.json file of the worker app. Read Customizing the app below for details.
Upload the zip (including the config.json file with your API key) as a template in the CMS.
Create an invisible / background layer with a channel and playlist.
Create a message and publish to the playlist.
Download the AdConnect playout app here (Portrait and Landscape versions provided for convenience):
Seibidou-Player-L
1.28 MB
Seibidou-Player-P
2.55 MB
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.
It is recommended to upload your own fallback media, which is displayed when no ad is available from Seibidou. The duration can be used to define the fallback duration, ad playback duration is is defined by the received content.

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

Customizing the worker app

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

Setting the Seibidou source URL, cmsType and API key (mandatory!):
```
"src": "",
"cmsType": "DISE",
"apiKey": "",
```
Impersonating a different Display ID:
```
  "playbackDeviceId": ""
```
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

Customizing the playout app

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

Changing the template name in template.json:
```
"name": "Seibidou (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,
```