All Collections
Developer documentation and guidance
Tracking downloads from custom sources
Tracking downloads from custom sources

Attribute downloads from custom players, apps or websites

Sharon Taylor avatar
Written by Sharon Taylor
Updated over a week ago

You can attribute and track download playback destination "source" from custom players, apps or websites by specifying a utm_source URL parameter value on the MP3 download URL, embed player URL or Omny.fm web player URL.

Supported custom sources

Omny Studio supports up to 50 custom download sources with the following (case insensitive) utm_source values.

CustomPlayer1
CustomPlayer2
CustomPlayer3
CustomPlayer4
CustomPlayer5
...
CustomPlayer50

Note: The values do not have any predefined meaning and can be associated with any player, app or website of your choosing.

Supported publishing URLs

You can specify a utm_source URL parameter value on the following Omny Studio publishing endpoints:

  • Clip MP3 download URL
    e.g. https://.../audio.mp3?utm_source=CustomPlayer1

  • Clip or playlist embed player iFrame URL
    e.g. <iframe src="https://.../embed?utm_source=CustomPlayer2"

  • Clip or playlist web player URL
    e.g. https://omny.fm/.../clip?utm_source=CustomPlayer3

Example

For example, you can attribute/track downloads from a custom mobile app by appending the MP3 download URL that's provided to the audio player with utm_source=CustomPlayer, for example

https://traffic.omny.fm/d/clips/.../audio.mp3?utm_source=CustomPlayer1

Downloads from that mobile app will then appear on the download analytics reports as "Custom player 1".

Re-naming custom sources

Once you've set up your custom sources, you can re-name them so that they display nicely in the Omny Studio analytics with the following steps.

1) Head to organization settings - analytics here: https://omnystudio.com/settings/analytics

2) Re-name your sources here and click save!

Your custom sources will now show up with their custom name in the Omny Studio analytics portal.

Did this answer your question?