Podigee: Most-used fields

The table below gives information about most-used fields that you can import from Podigee. Other fields might also be available in Adverity.

The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.

API name	Adverity UI name	Description	Use in Adverity
analytics_episodes_cover_image	analytics_episodes_cover_image	The URL of the cover image associated with the podcast episode for analytics purposes. This field helps in identifying the visual asset linked to an episode’s performance data.	dimension
clients.{CLIENT}	clients.{CLIENT}	This field represents a specific client or application used by listeners to access the podcast. The {CLIENT} placeholder will be replaced by the actual client name (e.g., ‘Spotify’, ‘Apple Podcasts’, ‘Chrome’). It provides data on the number of downloads or interactions from that particular client.	dimension
clients_on_platforms.{CLIENT}.{PLATFORM}	clients_on_platforms.{CLIENT}.{PLATFORM}	This field combines information about the client application and the platform where the podcast was accessed. It indicates the number of downloads or interactions for a specific client ({CLIENT}) on a particular platform ({PLATFORM}).	dimension
countries.{CODE}	countries.{CODE}	This field represents listener demographics by country. The {CODE} placeholder will be replaced by a two-letter country code (e.g., ‘US’ for United States, ‘DE’ for Germany) and provides data on the number of downloads or listeners from that specific country.	metric
date	date	The specific date for which the analytics data is reported. This field is crucial for time-series analysis of podcast performance.	dimension
downloaded_on	downloaded_on	The date when the episode was downloaded by the listener. This field provides insights into when the content was consumed.	dimension
downloads	downloads	The total number of unique downloads for an episode or podcast. This is a primary metric for overall content performance.	metric
downloads.complete	downloads.complete	The number of complete downloads for an episode, indicating that the entire audio file was downloaded successfully.	metric
formats.aac	formats.aac	The number of downloads specifically for the AAC format of the podcast episode.	metric
formats.mp3	formats.mp3	The number of downloads specifically for the MP3 format of the podcast episode.	metric
formats.opus	formats.opus	The number of downloads specifically for the Opus format of the podcast episode.	metric
id	id	The unique identifier for an episode or podcast. This ID is used to distinguish between different content pieces.	dimension
number	number	The episode number, if applicable. This can be used to track sequential content.	metric
platforms.{PLATFORM}	platforms.{PLATFORM}	This field represents the operating system or device platform used by listeners. The {PLATFORM} placeholder will be replaced by the actual platform name (e.g., ‘iOS’, ‘Android’, ‘Windows’). It provides data on the number of downloads or interactions originating from that platform.	metric
published_at	published_at	The timestamp indicating when the episode was published.	dimension
slug	slug	A human-readable, URL-friendly identifier for the episode or podcast, often used in URLs.	dimension
sources.feed	sources.feed	The number of downloads originating from the podcast’s RSS feed.	metric
sources.social	sources.social	The number of downloads or listens attributed to social media platforms.	metric
sources.unknown	sources.unknown	The number of downloads or listens where the originating source could not be identified.	metric
sources.user_backend	sources.user_backend	The number of downloads or listens originating from the user’s backend system, typically for internal or specific integrations.	metric
sources.web_download	sources.web_download	The number of downloads initiated directly from a web interface, distinct from the embedded web player.	dimension
sources.webplayer	sources.webplayer	The number of plays or downloads initiated directly from the Podigee web player embedded on a website.	metric
sources.webplayer-download	sources.webplayer-download	The number of downloads specifically initiated from the Podigee web player, indicating a direct download rather than just a play.	metric
title	title	The title of the podcast episode or podcast.	dimension