Overview
The media collection provides access to images and videos uploaded via the MX8 dashboard. These media items can be used in questions, filtered dynamically, and reported on using their associated metadata.
The media system is designed for:
Ad or concept testing
Filtering or tagging by metadata
Dynamically pulling content into questions
If no media has been uploaded, a dummy set is used with the default columns:
name,description,product,brand,campaign,agency,id
You can create and upload your own metadata columns via the MX8 dashboard.
@property media
Accesses the full media collection. Returns a MediaCollection object which can be iterated and queried.
for media in s.media: s.select_question("What do you think of this image?", options=["Like", "Dislike"], image=media)get_media_values(column: str)
Returns all values from a specific metadata column in the media collection.
Parameter | Type | Required | Description |
|
| yes | The column name to extract unique values from |
car_brands = s.get_media_values("brand")get_image(**filters)
Returns a single image matching the provided metadata filters.
ford_image = s.get_image(brand="Ford") s.image_question("What do you think of this Ford car?", image=ford_image)get_video(**filters)
Returns a single video matching the provided metadata filters.
ford_video = s.get_video(brand="Ford") s.play_video(video=ford_video)
get_images(**filters)
Returns a list of images that match the provided metadata filters.
for image in s.get_images(brand="Ford"): s.image_question("What do you think of this Ford car?", image=image)get_videos(**filters)
Returns a list of videos that match the provided metadata filters.
for video in s.get_videos(brand="Ford"): s.play_video(video=video)
Notes
You can chain filters using multiple keyword arguments (e.g.
brand="Ford", campaign="Summer")These tools allow dynamic, personalized question flows based on metadata
Media metadata is automatically included in reporting for grouped analysis
All media must be uploaded via the MX8 dashboard and tied to the current survey project