Acquisition

About

The Acquisition API lets you request the most relevant metrics for your apps which are available on the Acquisition Overview page of the justtrack dashboard.

Supported Metrics

MetricShortAbout

activeUsers

Number of users with opens (unique opens)

advertisingSpend

Sum of advertising spend from source defined per network

averageRevenueEventValue

AREV

AREV - Average revenue per revenue event

averageRevenuePerActiveUser

ARPAU

ARPAU - Average revenue per active user

averageSessionLength

Sum of time spend in app divided by number of sessions

averageTimeSpendInApp

Sum of time spend in app divided by number of active users

blockedUsers

Number of blocked users

clicks

Number of ad clicks

clickThroughRate

CTR

CTR - Number of ad clicks divided by number of ad impressions

clickToInstallRate

CTI

CTI - Number of installs divided by number of ad clicks

contributionMargin1

CM1

CM1 - Sum of revenue minus sum of advertising spend

contributionMargin1Rate

CM1%

CM1% - Sum of contribution margin divided by sum of revenue

contributionMargin2

CM2

CM2 - Sum of revenue minus sum of spendum of spend

contributionMargin2Rate

CM2%

CM2% - Sum of contribution margin 2 divided by sum of revenue

costPerAction

CPA

CPA - Sum of advertising spend divided by number of successfully sent action postbacks

costPerInstall

CPI

CPI - Sum of advertising spend divided by number of installs

effectiveCostPerClick

eCPC

eCPC - Effective cost per ad click

effectiveCostPerView

eCPV

eCPV - Effective cost per ad impression

effectiveCostPerMille

eCPM

eCPM - Effective cost per thousand ad impressions

externalAdvertisingSpend

Sum of advertising spend imported from network(s)

externalClicks

Number of ad clicks imported from network(s)

externalImpressions

Number of ad impressions imported from network(s)

impressions

Number of ad impressions

installs

Number of installs

installRate

IR

IR - Number of installs divided by number of ad impressions

installsPerMille

IPM

IPM - Number of installs per thousand ad impressions

monetizationAdImpressions

Number of successful ad impressions

monetizationAdImpressionsBanner

Number of successful ad impressions with banner type

monetizationAdImpressionsInterstitial

Number of successful ad impressions with interstitial type

monetizationAdImpressionsRewarded

Number of successful ad impressions with rewarded type

monetizedUsers

MU

MU - Number of users with revenue event in the selected time range

payout

Sum of concluded payouts (the defining timestamp is the conclude date)

payoutPerActiveUser

PPAU

PPAU - Sum of payout divided by number of active users

payoutRate

Sum of payout divided by sum of revenue

restrictedUsers

Number of restricted users

retentionRate

Number of active users divided by number of installs

returnOnAdvertisingSpend

ROAS

ROAS - Sum of revenue divided by sum of Advertising Spend

returnOnInvestment

ROI

ROI - Sum of revenue divided by sum of Spend

revenue

Sum of revenue

revenueEvents

Number of revenue events

skadInstalls

Number of SKAd Postbacks sent by the network

spend

Sum of advertising spend and payouts

suspiciousUsers

Number of suspicious users

Supported dimensions
[
  "app",
  "country",
  "date",
  "network.id",
  "campaign.id",
  "adsetName",
  "platform.id",
  "channel.id",
  "country.id",
  "dayOfWeek",
  "week",
  "month",
  "user.type",
  "campaign.type",
  "sourcePublisher",
  "sourceId",
  "sourceName", 
  "exchangeId",
  "exchangeName", 
  "sourceBundleId",
  "sourceCategory",
  "sourcePlacement", 
  "sourceUrl", 
  "externalAdSetId",
  "adType",
  "creativeName",
  "installAppVersionName",
  "creative.id", 
  "initialClientVersion",
  "installNumber",
  "testGroupId"
]

Table API

This API provides data to build custom tables. The metrics are grouped by the requested dimensions.

curl -H X-API-Key: <API_KEY> https://api.justtrack.io/reporting/v1/acquisition/table

Request

The general request to the Table API looks like:

{
   "cohort": {
       "enabled": bool,
       "dx": [int]
   },
   "interval": {
       "from": "YYYY-mm-dd",
       "until": "YYYY-mm-dd"
   },
   "metrics": [string],
   "dimensions": [string],
   "filters": {
       "<dimension>": [string],
   },
   "pagination": {
       "page": int,
       "limit": int
   },
   "orderBy": {
       "name": string,
       "direction": string,
   }
}
NameTypeDescription

cohort

Cohort object

Cohort or daily logic

interval

Interval object

Time interval within which data should be aggregated

metrics

[]string

List of requested metrics

dimensions

[]dimensions

List of dimensions by which data should be split

You can request up to 3 dimensions

filters

Filters object

Filters to limit requested data. Optional

pagination

Pagination object

Batch number and amount of data rows to return

orderBy

OrderBy object

Descending or ascending order by selected metric or dimension

Response

{
   "pagination": {
       "page": int,
       "limit": int,
       "total": int
   },
   "rows": [
       {
           "<dimension>": string,
           "<metric>": float
       }
   ],
   "sum": {
       "<metric>": float
   }
}
NameTypeDescription

pagination

Pagination object

Used pagination settings and total amount of data rows

rows

[]Row

List of data rows

sum

Sum object

Sum for all table entries (not only for the requested page)

Graph APi

The Graph API offers the same data as Table API with more flexible date grouping options.

curl -H X-API-Key: <API_KEY> https://api.justtrack.io/reporting/v1/acquisition/graph

Request

{
   "cohort": {
       "enabled": bool,
       "dx": [int]
   },
   "interval": {
       "from": "YYYY-mm-dd",
       "until": "YYYY-mm-dd"
   },
   "granularity": string,
   "metrics": [string],
   "filters": {
       "<dimension>": [string]
   }
}
NameTypeDescription

cohort

Cohort object

Cohort or daily logic

interval

Interval object

Time interval within which data should be aggregated.

granularity

Scale of the data aggregation

metrics

[]string

List of requested metrics

filters

Filters object

Optional filters to limit the requested data

Response

{
   "<date>": {
       "<metric>": float
   }
}

<date> stands for the date within which data was aggregated. Depends on the requested granularity.

<metric> stands for the requested metric name and contains float value.