Input Parameters
When processing your media with V3.x, you will have the opportunity to define specific parameters to apply that the AI system will use in it’s evaluation.
Accepted file formats:
- Image: .jpg, .jpeg, .png
- Video: .mp4, .mov, .avi, .mpeg, .mpg, .m4v, .gif
Strongly Recommended:
- Country
- Gender Distribution
- Age Range
- Device Type
- Platform
Additional:
- Seasonal Campaign (Month & Time of Day)
Please note that if no values are defined, the default values will be applied for a general assessment of creative potential:
Global, Mixed Gender (Even), 18-65, Desktop, TV, Sep Morning
Our default parameters were chosen based on patterns in audience predisposition and provide a stable baseline for predicting the audience response when attention and reactions are moderate.
| Parameter | Additional descriptions |
|---|---|
| Country | Demographic attribute for predicting audience response considering their geographic location and cultural cues. List of supported countries |
| Gender Distribution | Demographic attribute for predicting audience response by their self-identified identity. Male Female Mix* |
| Age Range | Standard demographic grouping. 18-29 18-60 *GEN POP* 30-49 50-65 >65 |
| Device Type | Technical attribute for predicting audience response considering the devices they use, such as smartphones, tablets, or desktops. Mobile Desktop Mix* |
| Platform and format | Supported on reactions-v3.2 model. Allows marketers to select specific ad placements, to align with platform-specific audience behaviors: Youtube Pods Youtube Preroll ad X News Feed Tiktok Infeed Snapchat Stories Instagram Feed Instagram Reels Infeed Instagram Stories Hulu Preroll Ad Facebook Stories Facebook News Feed TV |
| Ad Format** | Supported on reactions-v3.0 model. Shorts refers to: TikTok, YouTube, Instagram ads in Reels, Stories, or Shorts feeds Feed refers to: Facebook, Instagram, X ads in user Feeds (not including TikTok) Stream refers to: ads shown before or during video content, usually on YouTube or Hulu TV refers to: Full screen ads without interruptions |
| Seasonal Campaign | Month and time the content airs or campaign launches For reference, we describe the identify trends in audience behavior: Month Attention and happy intensity gradually increase during the January-April period. Months like May, June, and July align with both high attention and elevated happy intensity. Despite lower attention and happy intensity in late-year months, audiences are receptive to seasonal or emotionally resonant content. Time of day The morning provides a stable baseline for reaching the audience when attention is moderate, and happy intensity is growing towards its peak. The afternoon is optimal for high engagement and peak "happy intensity". The evening sees slightly reduced attention but maintains decent happy intensity. Ex: Sep Morning |
*Mix refers to an even split of the options
**Each format is tied to one of the following platforms (Facebook, Instagram, X, TikTok, YouTube, Hulu) and its media viewing options.
To define multiple parameter sets for an ad, generate a separate predicted reaction request (only 1 at a time and wait for its result before start a new one on the same media) for each set and track their states and request IDs through the requests endpoint (for image or for video).