measure_offer_displayed Measure offer shown
The result offered to measure one body measurement for a more exact size.
When to send it
Shopper app, when the offer card shows (D97, D101).
- Sent only after the shopper gave analytics consent; dropped, never queued, before it.
- Kept 90 days.
- Needs a non-null tracking_id: without one the event is rejected.
Required fields
| Field | Type | Rules | Description |
|---|---|---|---|
client_id |
integer |
greater than 0 | |
event |
"measure_offer_displayed" |
||
tracking_id |
string |
a UUID | |
timestamp_ms |
integer |
||
product_id |
string |
1–255 characters | |
reco_id |
string |
1–255 characters | |
measurement |
"height" | "chest" | "underbust" | "waist" | "pelvisGirth" | "hipsMax" | "upperArm" | "wrist" | "thigh" | "calf" | "neck" | "upperArmLength" | "forearmLength" | "upperLegLength" | "lowerLegLength" | "inseam" | "shoulderWidth" | "backLength" | "torsoHeight" | "sleeveLength" | "footLength" | "headCircumference" |
Optional fields
| Field | Type | Rules | Description |
|---|---|---|---|
event_id |
string |
1–255 characters | |
schema_version |
1 |
||
user_agent |
string |
at most 2048 characters | |
shop_country |
string | null |
at most 8 characters; may be null | |
channel |
string | null |
at most 64 characters; may be null | |
instance_id |
string |
1–255 characters | |
brand_id |
integer | null |
greater than 0; may be null | |
product_associated |
boolean |
||
ab_data |
object |
||
testEvent |
true |
||
extra |
object |
Example
Test values only. This example passes the event's schema.
{
"event": "measure_offer_displayed",
"client_id": 1000,
"tracking_id": "3f0b8c2e-4d5a-4b6c-8d7e-9f0a1b2c3d4e",
"timestamp_ms": 1792000000000,
"product_id": "TEST-JACKET-01",
"reco_id": "reco_01JTESTEXAMPLE000000000000",
"measurement": "waist"
}
Checks and messages
What Tracking debug in your back office checks for this event, with its exact message. An error means the event is not counted; a warning means it is counted but something is likely wrong; an info is a hint.
| Level | Check | Message |
|---|---|---|
| error | body_data |
the field: body data is not allowed here, the value was dropped (D110) |
| error | invalid_field |
what is wrong with the field |
| error | over_limit |
the field is over the limit of <limit> |
| error | product_id_missing |
missing product_id |
| error | tracking_id_missing |
missing tracking_id: the event is rejected. Send the visitor id (fmt_device_id) with every event. |
| warning | product_unknown |
product not found in your catalogue or has no size chart |
| warning | timestamp_missing |
timestamp_ms is missing or not a time in milliseconds: the time the event was received is used |
| warning | timestamp_out_of_range |
timestamp_ms is more than 30 days old or more than 3 days ahead: the time the event was received is used |
JSON schema
The schema the API checks this event against: measure_offer_displayed.schema.json.