Custom fields allow you add additional information to the listings in ILSA. You can add as many custom fields to ILSA as you want. Usually the values for those fields will be returned by one (ore more) of your (webhook) enricher, but it is also possible to push information (see below).
Custom fields you’ve defined will appear in the Backoffice and are thus available for filtering, sorting and to be included in fieldsets.
The data types of fields are the same as described here on the fieldsets page.
You can’t create new custom fields in the Backoffice yet. Contact us and we can configure them for you.
Push fields are a type of custom fields that can be written to after the listing is created. Most fields are filled by DV or enrichers, but push fields are set by calls to the Hexon API.
One example usage of push fields is marking listings as top-ads. An advertiser on your site pays to promote a vehicle, and you set the field push.top_ad
to true through the Hexon API. You can now use push.top_ad
in your ordering.
PATCH https://api.hexon.nl/ilsa/api/v1/rest/objects/12345
Content-Type: application/json
Authorization: Basic ...
{
"push.top_ad": true
}
TIP
Changing a push field causes the vehicle to go through enrichment and indexing again. There will be a delay before your change is active on your site.