Ad format: Visimax
Overview
This document contains information about the Visimax format.
Example
Required assets
To build this format, you need the following assets:
- An image (
ads.format:visimax-displayandads.format:visimax) - A video (optional, only when
ads.formatisvisimax). - A list of products.
Tracking
For more information about the properties for each beacon type, see Ad-centric trackers.
| Trigger | Beacon | Click_zone | Action | Stop time | Product_ID | Version |
|---|---|---|---|---|---|---|
| Click on add to basket button | clickBeacon | product | add-to-cart | 123456789 | Display/Video | |
| Click on add to list button | clickBeacon | product | add-to-list | 123456789 | Display/Video | |
| Click on carrousel left arrow | clickBeacon | format | nav-next | Display/Video | ||
| Click on carrousel right arrow | clickBeacon | format | nav-prev | Display/Video | ||
| Click on image | clickBeacon | format | redirect | Display | ||
| Click on mute button | clickBeacon | video | mute | Video | ||
| Click on product information with redirect | clickBeacon | product | product-page | 123456789 | Display/Video | |
| Click on unmute button | clickBeacon | video | unmute | Video | ||
| Format can't be displayed because products are not available | noshowBeacon | no-stock | Display/Video | |||
| Format inserted on the page | impBeacon | Display/Video | ||||
| Format on screen - 50% - 0s | viewBeacon | 0 | Display/Video | |||
| Format on screen - 50% - 1s | pviewBeacon | 1 | Display/Video | |||
| Format on screen - 50% - 2s | pviewBeacon | 2 | Display/Video | |||
| Scroll-in to display at least 50% of the video | videoBeacon | play | % of completion (rounded down integer) | Video | ||
| Scroll-out to display less than 50% of the video | videoBeacon | pause | % of completion (rounded down integer) | Video | ||
| Video is paused. Click on video to start | clickBeacon | video | play | % of completion (rounded down integer) | Video | |
|
Video is playing. Click on video to pause. |
clickBeacon | video | pause | % of completion (rounded down integer) | Video | |
| Video playing on screen | videoBeacon | step | 25 | Video | ||
| Video playing on screen | videoBeacon | step | 50 | Video | ||
| Video playing on screen | videoBeacon | step | 75 | Video | ||
| Video playing on screen | videoBeacon | step | 100 | Video | ||
| Video starts playing | videoBeacon | step | 0 | Display/Video |
IMP, VIEW, and PVIEW trackers must only be fired when the ad is visible to the user clicking or swiping to the specific ad.
VIDEO tracker must only be fired when the video is visible to the user clicking or swiping to the specific ad, except for actions pause and play.
Sample response: display and video
{
"adRequestId": "8d42f232ac0b4c0890f7cbae28e6b2f",
"ads": [
{
"creativeId": 17379,
"format": "visimax",
"zoning": "middle",
"placement": "visimax-middle-1",
"assets": {
"images": [
{
"height": 1537,
"id": "backgroundMobile",
"mimetype": "image/jpeg",
"redirect": null,
"url": "https://cdn.kaminoretail.dev/creative-assets/16/2025/8/5/87bbca4b-ce8d-4efc-bf00-4105d2216d1.jpg",
"width": 1537
},
{
"height": 804,
"id": "backgroundDesktop",
"mimetype": "image/jpeg",
"redirect": null,
"url": "https://cdn.kaminoretail.dev/creative-assets/16/2025/8/5/66197b17-685f-412d-aade-9a68188341f.jpg",
"width": 2485
}
],
"video": {
"height": 360,
"mimetype": "video/mp4",
"url": "https://cdn.kaminoretail.dev/creative-assets/16/2025/8/5/1b642e90-41c0-4af3-98c1-b520b36127.mp4",
"width": 640
},
"videos": [
{
"height": 360,
"mimetype": "video/mp4",
"url": "https://cdn.kaminoretail.dev/creative-assets/16/2025/8/5/1b642e90-41c0-4af3-98c1-b0b3612027.mp4",
"width": 640
}
],
"texts": [
{
"id": "title",
"redirect": null,
"style": null,
"value": "test"
}
]
},
"products": [
{
"id": "1234",
"name": "Reconditionné APPLE iPhone XR 64Go Noir",
"price": "10.0",
"salePrice": "10.0",
"link": "https://qlf.www.retailer.com/ref/1500538",
"image": "https://retailer.scene7.com/is/image/retailer/0194252099223_h_f_l_0",
"brand": "retailer",
"inStock": true,
"lastStockUpdate": "",
"customerRating": null,
"extra": {}
},
{
"id": "32U321",
"name": "Reflex . Test bundle 28 retailer.fr",
"price": "10.0",
"salePrice": "10.0",
"link": "https://qlf.www.retailer.com/ref/1500431",
"image": "https://retailer.scene7.com/is/image/retailer/0018208861231_h_f_l_0",
"brand": "retailer",
"inStock": true,
"lastStockUpdate": "",
"customerRating": null,
"extra": {}
}
],
"trackingLinks": {
"videoBeacon": "https://delivery.kaminoretail.dev/tracking/creative?cid=2880&liid=5201&crid=17379&tt=VIDEO&r=retailer&pt=HomePage&pid=&pl=visimax-middle-1&ad_request_id=8d42f232ac0b4c0890f7cbae28e6b2f",
"viewBeacon": "https://delivery.kaminoretail.dev/tracking/creative?cid=2880&liid=5201&crid=17379&tt=VIEW&r=retailer&pt=HomePage&pid=&pl=visimax-middle-1&ad_request_id=8d42f232ac0b4c0890f7cbae28e6b42f",
"clickBeacon": "https://delivery.kaminoretail.dev/tracking/creative?cid=2880&liid=5201&crid=17379&tt=CLICK&r=retailer&pt=HomePage&pid=&pl=visimax-middle-1&ad_request_id=8d42f232ac0b4c0890f7cbae28e6b42f",
"impBeacon": "https://delivery.kaminoretail.dev/tracking/creative?cid=2880&liid=5201&crid=17379&tt=IMP&r=retailer&pt=HomePage&pid=&pl=visimax-middle-1&ad_request_id=8d42f232ac0b4c0890f7cbae28e6b42f",
"noshowBeacon": "https://delivery.kaminoretail.dev/tracking/creative?cid=2880&liid=5201&crid=17379&tt=NOSHOW&r=retailer&pt=HomePage&pid=&pl=visimax-middle-1&ad_request_id=8d42f232ac0b4c0890f7cbae28e6b42f",
"pviewBeacon": "https://delivery.kaminoretail.dev/tracking/creative?cid=2880&liid=5201&crid=17379&tt=PVIEW&r=retailer&pt=HomePage&pid=&pl=visimax-middle-1&ad_request_id=8d42f232ac0b4c0890f7cbae28e6b42f"
},
"campaignId": 2880,
"lineItemId": 5201,
"sponsored": true,
"dsa": {
"buyer": "Kamino",
"brand": "retailer"
}
},
{
"creativeId": 17396,
"format": "visimax-display",
"zoning": "middle",
"placement": "visimax-display-middle-2",
"assets": {
"images": [
{
"height": 804,
"id": "backgroundDesktop",
"mimetype": "image/jpeg",
"redirect": null,
"url": "https://cdn.kaminoretail.dev/creative-assets/16/2025/8/5/5cbfacc5-fc8e-4c1e-9bd6-4adbc66d410f.jpg",
"width": 2485
},
{
"height": 1537,
"id": "backgroundMobile",
"mimetype": "image/jpeg",
"redirect": null,
"url": "https://cdn.kaminoretail.dev/creative-assets/16/2025/8/5/3d22b92b-b9b5-4e5b-8cc2-d720c7622f6a.jpg",
"width": 1537
}
]
},
"products": [
{
"id": "89010",
"name": "Figurine NINTENDO Amiibo 10 Pikachu",
"price": "10.0",
"salePrice": "10.0",
"link": "https://qlf.www.retailer.com/ref/1500528",
"image": "https://retailer.scene7.com/is/image/retailer/0045496352455_h_f_l_1",
"brand": "retailer",
"inStock": true,
"lastStockUpdate": "",
"customerRating": null,
"extra": {}
},
{
"id": "1234",
"name": ". 13000088",
"price": "10.0",
"salePrice": "10.0",
"link": "https://qlf.www.retailer.com/ref/1500448",
"image": "https://retailer.scene7.com/is/image/retailer/3497678384872_h_f_l_0",
"brand": "retailer",
"inStock": true,
"lastStockUpdate": "",
"customerRating": null,
"extra": {}
},
{
"id": "98756",
"name": ". Bundle 1500515 et 1500516",
"price": "10.0",
"salePrice": "10.0",
"link": "https://qlf.www.retailer.com/ref/1500517",
"image": "https://retailer.scene7.com/is/image/retailer/3497670002989_h_f_l_0",
"brand": "retailer",
"inStock": true,
"lastStockUpdate": "",
"customerRating": null,
"extra": {}
},
{
"id": "65832",
"name": "Chaîne A/V KEF bundle 02 opt deliv",
"price": "10.0",
"salePrice": "10.0",
"link": "https://qlf.www.retailer.com/ref/1500521",
"image": "https://retailer.scene7.com/is/image/retailer/0637203201585_h_f_l_0",
"brand": "retailer",
"inStock": true,
"lastStockUpdate": "",
"customerRating": null,
"extra": {}
},
{
"id": "12344",
"name": "Accessoire PANASONIC Dongle Wifi (DY-WL1",
"price": "10.0",
"salePrice": "10.0",
"link": "https://qlf.www.retailer.com/ref/130470",
"image": "https://retailer.scene7.com/is/image/retailer/5025232552726_h_f_l_0",
"brand": "retailer",
"inStock": true,
"lastStockUpdate": "",
"customerRating": null,
"extra": {}
},
{
"id": "1234567ABC",
"name": "Figurine NINTENDO Amiibo 04 Donkey Kong",
"price": "10.0",
"salePrice": "10.0",
"link": "https://qlf.www.retailer.com/ref/1500454",
"image": "https://retailer.scene7.com/is/image/retailer/0045496352394_h_f_l_1",
"brand": "retailer",
"inStock": true,
"lastStockUpdate": "",
"customerRating": null,
"extra": {}
},
{
"id": "000000000001500478",
"name": "ACC. WPRO bundle quantité 3 et quantité",
"price": "10.0",
"salePrice": "10.0",
"link": "https://qlf.www.retailer.com/ref/1500478",
"image": "https://retailer.scene7.com/is/image/retailer/8015250040234_h_f_l_0",
"brand": "retailer",
"inStock": true,
"lastStockUpdate": "",
"customerRating": null,
"extra": {}
},
{
"id": "ABC-1873",
"name": "Elastique ELITE Bundle 3 comp STOCK",
"price": "10.0",
"salePrice": "10.0",
"link": "https://qlf.www.retailer.com/ref/1500479",
"image": "https://retailer.scene7.com/is/image/retailer/3048097982219_h_f_l_0",
"brand": "retailer",
"inStock": true,
"lastStockUpdate": "",
"customerRating": null,
"extra": {}
},
{
"id": "09123-abc",
"name": "Chauf Huile DELONGHI TRN505",
"price": "10.0",
"salePrice": "10.0",
"link": "https://qlf.www.retailer.com/ref/826526",
"image": "https://retailer.scene7.com/is/image/retailer/8004399052000_h_f_l_0",
"brand": "retailer",
"inStock": false,
"lastStockUpdate": "",
"customerRating": null,
"extra": {}
},
{
"id": "nrjz134",
"name": "Reflex . Test bundle 28 retailer.fr",
"price": "10.0",
"salePrice": "10.0",
"link": "https://qlf.www.retailer.com/ref/1500431",
"image": "https://retailer.scene7.com/is/image/retailer/0018208861231_h_f_l_0",
"brand": "retailer",
"inStock": true,
"lastStockUpdate": "",
"customerRating": null,
"extra": {}
},
{
"id": "jkefkn7",
"name": ". 13000090",
"price": "10.0",
"salePrice": "10.0",
"link": "https://qlf.www.retailer.com/ref/1500446",
"image": "https://retailer.scene7.com/is/image/retailer/3497678384872_h_f_l_0",
"brand": "retailer",
"inStock": true,
"lastStockUpdate": "",
"customerRating": null,
"extra": {}
},
{
"id": "1-kzejn324",
"name": "Figurine NINTENDO Amiibo 02 Peach",
"price": "10.0",
"salePrice": "10.0",
"link": "https://qlf.www.retailer.com/ref/1500438",
"image": "https://retailer.scene7.com/is/image/retailer/0045496352370_h_f_l_1",
"brand": "retailer",
"inStock": true,
"lastStockUpdate": "",
"customerRating": null,
"extra": {}
},
],
"trackingLinks": {
"videoBeacon": "https://delivery.kaminoretail.dev/tracking/creative?cid=2881&liid=5209&crid=17396&tt=VIDEO&r=retailer&pt=HomePage&pid=&pl=visimax-display-middle-2&ad_request_id=8d42f232ac0b4c0890f7cbae28e6b42f",
"clickBeacon": "https://delivery.kaminoretail.dev/tracking/creative?cid=2881&liid=5209&crid=17396&tt=CLICK&r=retailer&pt=HomePage&pid=&pl=visimax-display-middle-2&ad_request_id=8d42f232ac0b4c0890f7cbae28e6b42f",
"impBeacon": "https://delivery.kaminoretail.dev/tracking/creative?cid=2881&liid=5209&crid=17396&tt=IMP&r=retailer&pt=HomePage&pid=&pl=visimax-display-middle-2&ad_request_id=8d42f232ac0b4c0890f7cbae28e6b42f",
"pviewBeacon": "https://delivery.kaminoretail.dev/tracking/creative?cid=2881&liid=5209&crid=17396&tt=PVIEW&r=retailer&pt=HomePage&pid=&pl=visimax-display-middle-2&ad_request_id=8d42f232ac0b4c0890f7cbae28e6b42f",
"viewBeacon": "https://delivery.kaminoretail.dev/tracking/creative?cid=2881&liid=5209&crid=17396&tt=VIEW&r=retailer&pt=HomePage&pid=&pl=visimax-display-middle-2&ad_request_id=8d42f232ac0b4c0890f7cbae28e6b42f",
"noshowBeacon": "https://delivery.kaminoretail.dev/tracking/creative?cid=2881&liid=5209&crid=17396&tt=NOSHOW&r=retailer&pt=HomePage&pid=&pl=visimax-display-middle-2&ad_request_id=8d42f232ac0b4c0890f7cbae28e6b42f"
},
"campaignId": 2881,
"lineItemId": 5209,
"sponsored": true,
"dsa": {
"buyer": "Kamino",
"brand": "retailer"
}
}
]
}