Podigee: Most-used fields

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.

metric

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}).

metric

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.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.unknown

sources.unknown

Represents downloads from sources that are not explicitly identified or categorized within the Podigee analytics data. This field provides insights into listens originating from unclassified platforms or referrers.

metric

sources.webplayer

sources.webplayer

The number of plays or downloads initiated directly from the Podigee web player embedded on a website.

metric

title

title

The title of the podcast episode or podcast.

dimension