Object Management
Review tracked objects, refine metadata, and organize objects into groups for displays and rules.
Overview
After processing, Studio populates your project with tracked objects. Objects are the foundation for:
- Clickable/hoverable interactions (object events)
- Object-bound overlays (tooltips, cards, hotspots)
- Rules that react to visibility, clicks, hover, and time
Select & Inspect Objects
Use the Entities panel to browse objects and groups. Clicking an object selects it and shows its details in the Inspector.
Edit Labels and Metadata
In the Inspector, you can adjust an object’s label/name and attach structured metadata (for example SKU, URL, price, or any custom fields). This data can be used by plugins (templates) and rules.
Object Groups
Object Groups are named collections of objects. They help you scale interactivity across many tracked items.
// Object Groups are a practical way to:
// - bind the same display behavior to many objects
// - target rules/actions at a set (e.g. "all products")
//
// Example names:
// - products
// - people
// - hotspots
// - sponsorsCustom Data Schema
Each group can define a Data Schema – a set of custom fields that objects in that group can have. This lets you tailor data collection for different use cases:
- E-commerce: title, price, currency, product URL, image
- Education: difficulty level, duration, prerequisites
- Real Estate: square footage, price, bedrooms, agent contact
To configure a data schema, click the gear icon on a group and go to the Data Schema tab. You can use the visual editor or switch to JSON mode for advanced editing.
// Example Data Schema for an e-commerce group
{
"fields": [
{ "key": "title", "type": "string", "label": "Title" },
{ "key": "description", "type": "textarea", "label": "Description" },
{ "key": "price", "type": "number", "label": "Price" },
{ "key": "currency", "type": "select", "label": "Currency",
"options": [
{ "value": "USD", "label": "USD ($)" },
{ "value": "EUR", "label": "EUR (€)" }
]
},
{ "key": "url", "type": "url", "label": "Product Link" },
{ "key": "imageUrl", "type": "image", "label": "Image URL" }
]
}
// Access in plugin templates:
// {{object.data.title}}
// {{object.data.price}}
// {{object.data.url}}{{object.data.fieldKey}}.Tracking Visualization (BBox / Polygons)
Use the top menu View → Object Overlays to switch between:
- Bounding Boxes: lightweight and easy to read
- Polygons: more precise shapes (great for replacement zones)
- Hidden: clean preview without tracking overlays
Best Practices
- Group early so rules and displays stay simple as object count grows.
- Name consistently (e.g.
products,people,sponsors). - Store the important business fields directly on objects so templates can render instantly.