Analytics (iOS)

Learn how to track analytics in an iOS app.

By default, a player's identity within the SDK is neither tracked nor recognized by JWP's analytics. However, adding a player ID to the JWPlayerConfiguration object enables you to use JWP Analytics (plays, time watched) to evaluate the performance of your players:

  • Run A/B tests
  • Filter Custom Report results
  • Create SDK-specific analytics queries through the Management API

Track analytics

To track analytics, you must add the player ID to the JWPlayerConfiguration object.


The player ID added to the JWPlayerConfiguration object must exist within the property linked to the license key supplied during the SDK setup. Using any other ID will cause associated data to be discarded.

Use the following recipe to add the player ID.

Generate a report

After a player ID has been associated with a player, you can generate reports through one of the following methods listed in below.

Custom Reports

Enables you to turn JWP data into actionable insights and to share the insights in a centralized location

When creating a new report, be sure to use the following steps when selecting metrics and dimensions:

  1. Under Metrics, select from the following metrics:
    • Performance > Plays
    • Performance > Time Watched
  2. Under Group By, select the following options:
    • Device > Platform
    • Content > Player
  3. Under Filters, select the following options from the dropdown menus:
    • Device
    • Platform
    • Equals
    • iOS


Enables you to fetch an analytics report over a custom date range

When querying the API, be sure to build your query with the following body parameters.

  "dimensions": [
  "filter": [
      "operator": "=",
      "value": [
      "field": "platform_id"
  "metrics": [
      "operation": "max",
      "field": "plays"
      "operation": "max",
      "field": "time_watched"