Player playback logs

Sometimes the standard on-air help is not enough and you need data on the fact of each playback. You can use the API for this task.

Attention! Every month, players send several billion records of the fact of playback to the visiobox.cloud server. In order for the database not to be too large and not to lose performance, the server aggregates this data into on-air help and deletes playback logs older than 7 days. Therefore, if you request logs, you can only get a log of the last seven days. If you need always up-to-date logs, you need to request them once a day and save them yourself.

The second option is to buy your own server license. In this case, you will not have restrictions on the storage period of logs in the database (however, you need to think about a reasonable balance between the need to have such an archive and performance).

---

The data request from the box is carried out via RELAY:

https://exchange.visiobox.cloud

The login pass will be issued upon request

Authorization: OAuth (see any API request to the exchange in the browser inspector)

---

Boxes (servers):

curl -H "Authorization: OAuth <token>" 'https://exchange.visiobox.cloud/v1/ls/boxes'

Organizations:

https://exchange.visiobox.cloud/v1/ls/organizations

Only those organizations that have given permission to access their logs

Advertisers:

https://exchange.visiobox.cloud/v1/ls/odvertisers

can be transmitted ?organization_id=1_1&organization_id=1_2

Devices:

https://exchange.visiobox.cloud/v1/ls/players

can be transmitted ?organization_id=1_1&organization_id=1_2

Campaigns:

https://exchange.visiobox.cloud/v1/ls/od/campaigns

can be transmitted ?organization_id=1_1&organization_id=1_2

Playbacks:

https://exchange.visiobox.cloud/v1/ls/playback_item_playbacks?max_id=1234

can be transmitted ?organization_id=1_1&organization_id=1_2. If the response is 503, then you need to wait N seconds and repeat the request with the same parameters.

For example:

https://exchange.visiobox.cloud/v1/ls/playback_item_playbacks?max_id=1234&organization_id=3_490

After N minutes, the response will contain a link to an archive of the following type:

{"url": "http://visiobox.cloud/reports/JndeRbz3gxShgkHC35BZl8KCcmLzfGMY2VmXJuBDsCqKbJzfi2JMlVMCKP6obO.json.gz"}