Managing Audio Markers
Audio Markers let you prepare media with a special marker that most listeners will not notice during normal playback. When the media is recognized, SORI can collect the marker's additional context together with the normal audio fingerprint result. A common use case is identifying the media, channel, or program version that produced an activity so reports can be grouped more precisely.
INFO
SDKs do not detect Audio Markers by default. Enable Audio Marker recognition in your Android, iOS, or Flutter integration only when your service uses Audio Markers.
Audio Marker list
The Audio Marker list shows the markers created in your account. Each marker has a name, tags, and attributes. You can search markers by name, tag, attribute key, or attribute value.
Creating an Audio Marker
To create an Audio Marker, open Audio Markers in SORI Console and click
Create Audio Marker.Fill in the following information:
- Name: A recognizable name for the marker.
- Attributes: Key/value properties to attach when this marker is collected.
- Tags: Tags for searching and organizing markers.
Attributes are the most important part of an Audio Marker. When a marker is recognized with a material, SORI stores the marker attributes as activity properties. These properties are then available for activity history, webhooks, statistics, and reports.
Use the following attribute keys when you want the values to appear as standard statistics and report dimensions:
| Attribute key | Report dimension |
|---|---|
media | Media |
channel | Channel |
program | Program |
Other attribute keys are stored with the activity, but they are not shown as standard grouping options in the current statistics and report screens.
TIP
If a campaign and an Audio Marker define the same property key, the Audio Marker value is used for the collected activity.
Creating marked media
On the Audio Marker detail page, use Material Converter to create media that includes the selected Audio Marker.
- Open the Audio Marker detail page.
- Upload an audio or video file in Material Converter.
- Click Proceed.
- Wait for the conversion job to complete.
- Download the completed file and use it in your media workflow.
Completed conversion files and uploaded source files are automatically deleted 24 hours after completion. Download the converted file before it expires.
Recognition and reports
When an SDK integration has Audio Marker recognition enabled, a marker can be collected alongside a normal material recognition result. SORI Console records the marker name and configured attributes in the activity.
Statistics and campaign reports can group recognized activity by Material, Media, Channel, or Program. To use Audio Marker groupings, configure marker attributes with the media, channel, or program keys before publishing the media that includes the marker.
Report and statistics exports include the selected grouping, so CSV and XLSX downloads can be used for downstream analysis.
Marker handling
SORI Console manages how each Audio Marker is assigned and embedded. Users only need to configure the marker name, tags, and attributes, then use the converted media in their own media workflow.