get https://api.neuronsinc.com/predict/v2/media//benchmark_ranges
You can now get industry benchmark information for your images or videos.
Provided you have a valid media that can be either an image or a video that has been successfully predicted and the objective settings have been configured, you can get industry benchmark ranges for your medium's objectives (based on how the medium is segmented according to the objective settings configuration).
The output provided from this endpoint includes:
- upper and lower range of the benchmark for each metric.
- the metric name and type (start, end, total).
- score categorization - informing where the medium metric ranks in relation to the benchmark. The score categorisaitons range from extreme low to extreme high (see Performance buckets information in knowledge base).
- score title - a short summary sentence to inform when the metric is in benchmark range.
For more information on benchmark system, please refer to our knowledge base.
Example of successful response
For an image:
{
"medium": [
{
"upper": 100,
"lower": 89.3379352,
"metric_name": "focus",
"metric_time": "total",
"score_categorization": "extreme_high",
"score_title": "The Focus score of 92.8 is within the industry benchmark."
},
{
"upper": 46.495353,
"lower": 39.3922,
"metric_name": "cognitive_demand",
"metric_time": "total",
"score_categorization": "high",
"score_title": "The Cognitive Demand score of 53.9 is slightly above the industry benchmark."
},
{
"upper": 100,
"lower": 75.15201453239686,
"metric_name": "memory",
"metric_time": "total",
"score_categorization": "extreme_high",
"score_title": "The Memory score of 78.3 is within the industry benchmark."
},
{
"upper": 82.11677305160032,
"lower": 70.92786604358304,
"metric_name": "engagement_frt",
"metric_time": "total",
"score_categorization": "medium",
"score_title": "The Engagement score of 67.9 is close to the industry benchmark."
},
{
"upper": 100,
"lower": 88.57404140000001,
"metric_name": "focus",
"metric_time": "start",
"score_categorization": "extreme_high",
"score_title": "The Start Focus score of 89.8 is within the industry benchmark."
},
{
"upper": 100,
"lower": 86.865249,
"metric_name": "focus",
"metric_time": "end",
"score_categorization": "extreme_high",
"score_title": "The End Focus score of 91.6 is within the industry benchmark."
}
],
"aois": [
{
"upper": 100,
"lower": 21.54420471371851,
"metric_name": "attention",
"metric_time": "total",
"aoi_type": "branding",
"uuids": [
"06c95c85-6a6b-44ed-8929-55514ef73c87",
"4323e80c-9572-480c-91d5-061df6a1815d",
"88187748-3f58-43e0-aa39-a5420b361dff",
"a7e40f32-553b-498f-bb14-8c3f5d905531"
]
},
{
"upper": 23.000771403312687,
"lower": 7.316394932568072,
"metric_name": "attention",
"metric_time": "start",
"aoi_type": "branding",
"uuids": [
"06c95c85-6a6b-44ed-8929-55514ef73c87",
"4323e80c-9572-480c-91d5-061df6a1815d",
"88187748-3f58-43e0-aa39-a5420b361dff",
"a7e40f32-553b-498f-bb14-8c3f5d905531"
]
},
{
"upper": 100,
"lower": 19.31997612118721,
"metric_name": "attention",
"metric_time": "end",
"aoi_type": "branding",
"uuids": [
"06c95c85-6a6b-44ed-8929-55514ef73c87",
"4323e80c-9572-480c-91d5-061df6a1815d",
"88187748-3f58-43e0-aa39-a5420b361dff",
"a7e40f32-553b-498f-bb14-8c3f5d905531"
]
},
{
"upper": 0.7386601315997416,
"lower": 0.2852195184583589,
"metric_name": "time_spent",
"metric_time": "total",
"aoi_type": "branding",
"uuids": [
"06c95c85-6a6b-44ed-8929-55514ef73c87",
"4323e80c-9572-480c-91d5-061df6a1815d",
"88187748-3f58-43e0-aa39-a5420b361dff",
"a7e40f32-553b-498f-bb14-8c3f5d905531"
]
},
{
"upper": 100,
"lower": 83.8068808582658,
"metric_name": "percentage_seen",
"metric_time": "total",
"aoi_type": "branding",
"uuids": [
"06c95c85-6a6b-44ed-8929-55514ef73c87",
"4323e80c-9572-480c-91d5-061df6a1815d",
"88187748-3f58-43e0-aa39-a5420b361dff",
"a7e40f32-553b-498f-bb14-8c3f5d905531"
]
},
{
"upper": 97.3795235157013,
"lower": 55.257755517959595,
"metric_name": "attention",
"metric_time": "total",
"aoi_type": "product",
"uuids": [
"79571585-558e-43e6-b1ec-d84ce178fd6d"
]
},
{
"upper": 95.07224559783936,
"lower": 49.79230351746082,
"metric_name": "attention",
"metric_time": "start",
"aoi_type": "product",
"uuids": [
"79571585-558e-43e6-b1ec-d84ce178fd6d"
]
},
{
"upper": 96.50317370891572,
"lower": 56.569365262985215,
"metric_name": "attention",
"metric_time": "end",
"aoi_type": "product",
"uuids": [
"79571585-558e-43e6-b1ec-d84ce178fd6d"
]
},
{
"upper": 3.6014923857099768,
"lower": 2.122559598741289,
"metric_name": "time_spent",
"metric_time": "total",
"aoi_type": "product",
"uuids": [
"79571585-558e-43e6-b1ec-d84ce178fd6d"
]
},
{
"upper": 99.999,
"lower": 94.81034113212536,
"metric_name": "percentage_seen",
"metric_time": "total",
"aoi_type": "product",
"uuids": [
"79571585-558e-43e6-b1ec-d84ce178fd6d"
]
},
{
"upper": 56.21561408042908,
"lower": 38.024160861968994,
"metric_name": "attention",
"metric_time": "total",
"aoi_type": "headline_text",
"uuids": [
"7bed7119-197a-4d37-8259-8a84f2c5bf5f"
]
},
{
"upper": 61.63069844245911,
"lower": 44.2729301052168,
"metric_name": "attention",
"metric_time": "start",
"aoi_type": "headline_text",
"uuids": [
"7bed7119-197a-4d37-8259-8a84f2c5bf5f"
]
},
{
"upper": 45.662546157836914,
"lower": 27.44809687137604,
"metric_name": "attention",
"metric_time": "end",
"aoi_type": "headline_text",
"uuids": [
"7bed7119-197a-4d37-8259-8a84f2c5bf5f"
]
},
{
"upper": 2.1435845504618283,
"lower": 1.4101106333399482,
"metric_name": "time_spent",
"metric_time": "total",
"aoi_type": "headline_text",
"uuids": [
"7bed7119-197a-4d37-8259-8a84f2c5bf5f"
]
},
{
"upper": 98.30010284998326,
"lower": 87.40703040349038,
"metric_name": "percentage_seen",
"metric_time": "total",
"aoi_type": "headline_text",
"uuids": [
"7bed7119-197a-4d37-8259-8a84f2c5bf5f"
]
}
]
}For a video:
{
"medium": [
{
"upper": 76.97105207367804,
"lower": 58.5420466767034,
"metric_name": "focus",
"metric_time": "total",
"score_categorization": "low",
"score_title": "The Total Focus score of 47.8 overall is below the industry benchmark."
},
{
"upper": 48.17057050286579,
"lower": 42.51133540844187,
"metric_name": "cognitive_demand",
"metric_time": "total",
"score_categorization": "high",
"score_title": "The Total Cognitive Demand score of 66.9 overall is slightly above the industry benchmark."
},
{
"upper": 100,
"lower": 60.59429670667488,
"metric_name": "memory",
"metric_time": "total",
"score_categorization": "extreme_high",
"score_title": "The Total Memory score of 67.3 overall is within the industry benchmark."
},
{
"upper": 100,
"lower": 64.05506363159762,
"metric_name": "memory",
"metric_time": "start",
"score_categorization": "extreme_high",
"score_title": "The Start Memory score of 79.5 is within the industry benchmark."
},
{
"upper": 62.88917824007892,
"lower": 49.01451986639443,
"metric_name": "memory",
"metric_time": "end",
"score_categorization": "medium",
"score_title": "The End Memory score of 46.0 is close to the industry benchmark."
},
{
"upper": 68.04746140690483,
"lower": 61.921905294327075,
"metric_name": "engagement_frt",
"metric_time": "total",
"score_categorization": "medium",
"score_title": "The Total Engagement score of 59.8 overall is close to the industry benchmark."
},
{
"upper": 70.43553988677718,
"lower": 61.59591867963336,
"metric_name": "engagement_frt",
"metric_time": "start",
"score_categorization": "low",
"score_title": "The Start Engagement score of 49.8 is below the industry benchmark."
},
{
"upper": 76.22368938394268,
"lower": 64.48636035687164,
"metric_name": "engagement_frt",
"metric_time": "end",
"score_categorization": "low",
"score_title": "The End Engagement score of 53.4 is below the industry benchmark."
},
{
"upper": 79.90816880940997,
"lower": 67.09374181386383,
"metric_name": "focus",
"metric_time": "start",
"score_categorization": "low",
"score_title": "The Start Focus score of 54.0 is below the industry benchmark."
},
{
"upper": 88.03048705238979,
"lower": 67.81889003963194,
"metric_name": "focus",
"metric_time": "end",
"score_categorization": "medium",
"score_title": "The End Focus score of 66.1 is close to the industry benchmark."
},
{
"upper": 45.31152013387026,
"lower": 36.83913504310826,
"metric_name": "cognitive_demand",
"metric_time": "start",
"score_categorization": "high",
"score_title": "The Start Cognitive Demand score of 67.7 is slightly above the industry benchmark."
},
{
"upper": 43.92360004761716,
"lower": 36.15070929713629,
"metric_name": "cognitive_demand",
"metric_time": "end",
"score_categorization": "medium",
"score_title": "The End Cognitive Demand score of 38.5 is within the industry benchmark."
}
],
"aois": [
{
"upper": 11.510094096031231,
"lower": 2.1094115065891623,
"metric_name": "attention",
"metric_time": "total",
"aoi_type": "branding",
"uuids": [
"32a8ef30-fea5-29b1-305f-4baa2674d180"
]
},
{
"upper": 27.706216038592785,
"lower": 6.077979222560922,
"metric_name": "attention",
"metric_time": "start",
"aoi_type": "branding",
"uuids": [
"32a8ef30-fea5-29b1-305f-4baa2674d180"
]
},
{
"upper": 100,
"lower": 49.58148550863067,
"metric_name": "attention",
"metric_time": "end",
"aoi_type": "branding",
"uuids": [
"32a8ef30-fea5-29b1-305f-4baa2674d180"
]
},
{
"upper": 100,
"lower": 9.675000000000004,
"metric_name": "availability",
"metric_time": "total",
"aoi_type": "branding",
"uuids": [
"32a8ef30-fea5-29b1-305f-4baa2674d180"
]
},
{
"upper": 66.12967668296577,
"lower": 15.243246776435305,
"metric_name": "relative_attention",
"metric_time": "total",
"aoi_type": "branding",
"uuids": [
"32a8ef30-fea5-29b1-305f-4baa2674d180"
]
}
]
}