Taboola automatically generates a focal point for your Creative image. This helps ensure that the image is a good fit for the different placement sizes across Taboola’s network.
If the automatically generated focal point is not ideal for your image - e.g. it causes cropping issues - you can apply custom coordinates.
To do so, use the campaign item’s creative_focus field.
Examples
Apply custom coordinates
POST /backstage/api/1.0/demo-account/campaigns/1234/items/123/
{
"creative_focus": {
"type": "COORDINATES",
"coordinates": {
"x": 878,
"y": 827
}
}
}
{
"id": "123",
"campaign_id": "1234",
//...
"creative_focus": {
"type": "COORDINATES",
"coordinates": {
"x": 878,
"y": 827
}
}
}
Set to 'automatic' (default)
POST /backstage/api/1.0/demo-account/campaigns/1234/items/123/
{
"creative_focus": {
"type": "AUTOMATIC"
}
}
{
"id": "123",
"campaign_id": "1234",
//...
"creative_focus": {
"type": "AUTOMATIC",
"coordinates": null
}
}
The Creative Focus cannot be modified while status is CRAWLING.
Illustration:
Automatic focus:
Custom coordinates (to correct cropping issue):
Image Guidelines
For up-to-date guidelines and best practices, refer to the Help Center, or sync with your Taboola Account Manager.