What is the difference between Array of Objects attributes and Array of Objects event parameters?
Array of Objects attributes store structured records that belong to the user profile, such as subscriptions or policies the user owns. Array of Objects event parameters store structured records that belong to a single action, such as the items purchased in one transaction.
The most important behavioral difference is that attributes support patch actions (add, merge, replace, remove), while event parameters are insert-only.
Do I have to create the structure before sending data?
Yes. The Array of Objects event parameter and its object keys must be defined in the panel before ingestion. Parameters that are not registered are ignored during ingestion.
Where do I put the array in the payload?
Inside object_event_params, next to event_params. This is the only accepted location. An array or object placed inside event_params is ignored because event_params accepts scalar values only.
What happens if I send an unregistered parameter or an empty array?
The parameter is ignored with a warning, and the event itself is still stored. The request does not fail, and other events in the same batch are not affected.
Can I update a single object inside an event after it was sent?
No. Array of Objects event parameters are insert-only. To correct data, send the event again with the correct payload.
What happens if I send object keys that are not defined in the panel?
Only the keys defined in the parameter schema are stored. Undefined keys are ignored.
How are multiple object key conditions evaluated in segmentation?
They are combined with AND and evaluated within the same object. A user matches only if one single object in the array satisfies all conditions together.
What does "Number of Objects" count?
It counts how many objects in the array satisfy the conditions. An object containing two matching values still counts as one object.
Can I rename or delete object keys after creation?
No. Object key and sub-object key names and data types are fixed after creation. You can only append new object keys and new sub-object keys. The parameter's display name and sample data remain editable.
Can I nest another Array of Objects inside an object?
No. Object-type keys are allowed, but nested Arrays of Objects are not supported. A maximum of 2 levels is available.
What are the system limits?
Limit | Value |
Array of Objects event parameters per panel | 20 |
Objects per array | 50 by default, configurable 1–1000 |
Keys per object | 20 by default, configurable 1–100 |
Nesting levels | 2 |
String length per value | 500 characters |
Payload size per request | 5 MB |
Can the object and key limits be raised?
Yes. The maximum number of objects per array and the maximum number of keys per object are configured per parameter and can be raised by the Insider team on request. The parameter count per panel and the nesting depth are fixed.
What happens if I send a single object instead of an array?
It is automatically wrapped into a one-element array, so {"items": {...}} and {"items": [{...}]} are stored identically.
Can I send more than one Array of Objects parameter on the same event?
Yes. An event can carry several Array of Objects parameters at once, for example items and shipping_addresses.
Where can I use Array of Objects event parameters?
In Dynamic Segmentation on events, and in the Advanced Filter on User Profiles. They are not available in Dynamic Content.