AdConnect for Place Exchange

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

Place Exchange is a programmatic DOOH SSP, please refer to Place Exchange for more information. To use the AdConnect for Place Exchange app, you will need an account and register your inventory with Place Exchange. 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 Place Exchange. 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 Place Exchange. The request includes the Display ID, which allows Place Exchange 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 Place Exchange.

Installing and using the app

Make sure you are all set up in Place Exchange, with all Display IDs registered in the inventory. You will need your Place Exchange organization ID, user name, and password.
Download the app here (Portrait and Landscape versions provided for convenience):
PlaceExchange (P)
700.48 KB
PlaceExchange (L)
700.48 KB
Before you can use the app, you need to enter your organization ID, user name, and password in the config.json file within the zip file. See Customizing the app below.
Upload the zip (including your changes to the json files) as a template in the CMS.
Create a message from the template, and publish to playlist.
You have the option of uploading a fallback media, which will be displayed when no ad is available from Place Exchange

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 config.json file (and, optionally template.json) as described below, then create a new zip with all files.

Mandatory: setting the Place Exchange organization ID, user name, and password config.json:
```
    "username": "",
    "password": "",
    "organizationId": "",
```
Impersonating a different Display ID config.json:
```
  "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. Uncomment the settings above in the config.json file by removing the # characters, and fill out the ID, location name, latitude, and longitude.

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