At a glance: Aggregate reports described. Comparison of aggregate and analytics tools/APIs
Aggregate performance reporting—tools and reports
- Predefined aggregate reports available in the platform are described. This includes samples of UA aggregate reports.
- The platform offers a number of aggregate reporting and analytics options. Use the tool comparison table to understand the main function and the differences between the tools.
- About raw-data reporting
Tool comparison
| Tool | Description | Multiple /single app (1) | Data freshness | Embed in scripts | Timezone | Currency |
|---|---|---|---|---|---|---|
| Export data |
Aggregate performance reports downloaded via the user interface |
Single | Real-time | x |
App-specific |
App-specific |
| Pull API*-aggregate |
Aggregate performance reports using URIs in the browser/embedded in scripts
|
Single |
Real-time |
✓ |
Selectable |
App-specific |
| Master API P | Performance metrics (KPIs) using URIs in the browser/embedded in scripts | Multi | Daily | ✓ | Selectable Default: UTC (2) |
Selectable Default: USD |
| Pivot P | Get campaign performance metrics (KPIs) via the user interface | Multi | Daily | x | App-specific (2) | USD |
| Cohort |
Cohorted campaign performance analytics via the user interface
|
Multi | Daily | ✓P API only | App-specific (2) | App-specific |
|
Notes/abbreviation: (2) Apps all need to be set to the same app-specific time zone. If not then time is in UTC. |
||||||
| Limitations | Pull API: Aggregate | Master API |
|---|---|---|
| Data limit (1) | 200K lines 24 calls per day per application and up to 120 calls per day per account |
Unlimited file size and unlimited calls per day |
| Data retention period | Lifetime | Lifetime |
| (1) The upper limit may depend on the account package. | ||
Report descriptions
- The reports described are available via the Export data page or by using Pull API aggregate.
- They are Lifetime value (LTV) so that the reporting date range relates to the conversion date defined as follows:
- Install date for UA and Protect360 reports
- Re-attribution or re-engagement date in the case of retargeting reports
- The earliest reporting date available is the first app install date.
UA reports
| Report name | Grouped by |
|---|---|
| Partners (media sources) | Agency, media source, campaign |
| Partners by date | Date, agency, media source, campaign |
| Activity by date | Date, agency, media source, campaign |
| Geo | Country, agency, media source, campaign |
| Geo by date | Date, country, agency, media source, campaign |
| View-through attribution (VTA) KPIs | |
| Note: If Facebook is the media source selected then additional columns are included: Adgroup ID, Adgroup name, Adset ID, Adset name | |
Example of aggregate reports in CSV files.
Date fields in the CSV files have the format yyyy-mm-dd. When you open a CSV file in Excel, date fields are formatted using your computer's date and time settings. Be sure to select the appropriate date display in Excel.
Examples of aggregate reports
Partners (media source) LTV aggregate report
Partners by date LTV aggregate report
Daily activity LTV aggregate report
Geo LTV aggregate report
Geo (country) by date LTV aggregate report
|
Report name |
||||||
|---|---|---|---|---|---|---|
|
Field |
Description |
Partner (media source) |
Partner by date |
Daily |
Geo |
Geo by date |
|
Country |
Install country |
✓ |
✓ | |||
|
Date |
Attribution date |
✓ |
✓ |
|||
|
Agency/PMD (af_prt) |
Agency/partner name |
✓ |
✓ |
✓ |
✓ |
✓ |
|
Media Source (pid) |
Media source bringing the user (pid=media source) |
✓ |
✓ |
✓ |
✓ |
✓ |
|
Campaign |
Campaign name (c= campaign name) |
✓ |
✓ |
✓ |
✓ |
✓ |
|
Campaign ID |
Facebook campaign ID |
FB only |
FB only |
FB only |
FB only |
FB only |
|
Adgroup ID |
Facebook ad group ID |
FB only |
FB only |
FB only |
FB only |
FB only |
|
Adgroup Name |
Facebook ad group |
FB only |
FB only |
FB only |
FB only |
FB only |
|
Adset ID |
Facebook adset ID |
FB only |
FB only |
FB only |
FB only |
FB only |
|
Adset Name |
Facebook adset name |
FB only |
FB only |
FB only |
FB only |
FB only |
|
ARPU |
Average revenue per user |
✓ |
✓ |
✓ |
✓ |
|
|
Average eCPI |
Average eCPI |
✓ |
||||
|
Clicks |
Number of clicks |
✓ |
✓ |
✓ |
✓ |
✓ |
|
Conversion Rate |
Number of installs/number of clicks |
✓ |
✓ |
✓ |
✓ |
✓ |
|
CTR |
Click-through rate |
✓ |
✓ |
|||
|
{your event name}(Unique users) |
Number of unique users who performed the event |
✓ |
✓ |
✓ |
✓ |
|
|
{your event name} (Event counter) |
Event counter |
✓ |
✓ |
✓ |
✓ |
|
|
{your event name} (Sales in XXX) |
Event sales in XXX where XXX is the app-selected currency |
✓ |
✓ |
✓ |
✓ |
|
|
Impressions |
Number of impressions |
✓ |
✓ |
|||
|
Installs |
Number of installs |
✓ |
✓ |
✓ |
✓ |
✓ |
|
Loyal Users |
[default] User who opens the app more than 3 times |
✓ |
✓ |
✓ |
✓ |
✓ |
|
Loyal Users/Installs |
Loyal users rate |
✓ |
✓ |
|||
|
ROI |
Return on investment |
✓ |
✓ |
|||
|
Sessions |
|
✓ |
✓ |
✓ |
✓ |
✓ |
|
Total Cost |
- |
✓ |
✓ |
|||
|
Total revenue |
Total revenue generated from the media source and campaign |
✓ |
✓ |
✓ |
✓ |
|
|
Note: FB only columns are included when selecting Facebook as the media source |
||||||
Retargeting
- Retargeting reports consist of users who engaged with a retargeting campaign and performed a re-engagement or re-attribution
- In retargeting reports there is no distinction between organic and non-organic users.
| Report name | Grouped by |
|---|---|
| Partners (media sources) | Agency, media source, campaign |
| Partners by date | Date, agency, media source, campaign |
| Activity by date | Date, agency, media source, campaign |
| Country | Country, agency, media source, campaign |
| Country by date | Date, country, agency, media source, campaign |
| Field | Description | Partners | Daily | Partners by date | Geo by date | Geo |
|---|---|---|---|---|---|---|
| Date | Conversion date | ✓ | ✓ | |||
| Country | ✓ | ✓ | ✓ | |||
| Agency/PMD (af_prt) | Agency/partner name | ✓ | ✓ | ✓ | ✓ | ✓ |
| Media Source (pid) | ✓ | ✓ | ✓ | ✓ | ✓ | |
| Campaign (c) | ✓ | ✓ | ✓ | ✓ | ✓ | |
| Clicks | ✓ | ✓ | ✓ | ✓ | ✓ | |
| Conversions | ✓ | ✓ | ✓ | ✓ | ✓ | |
| Conversion Type | Re-attribution or re-engagement | ✓ | ✓ | ✓ | ✓ | ✓ |
| Conversion Rate | Conversions/clicks | ✓ | ✓ | ✓ | ✓ | ✓ |
| Sessions | ✓ | ✓ | ✓ | ✓ | ✓ | |
| Loyal Users | ✓ | ✓ | ✓ | ✓ | ✓ | |
| Loyal Users/Installs | ✓ | ✓ | ✓ | ✓ | ✓ | |
| Total Cost | ✓ | ✓ | ✓ | ✓ | ✓ | |
| Average eCPI | ✓ | ✓ | ||||
| Total Revenue | ✓ | ✓ | ✓ | ✓ | ✓ | |
| ROI | ✓ | ✓ | ✓ | ✓ | ✓ | |
| ARPU | ✓ | ✓ | ✓ | ✓ |
Blocked fraud Protect360
Blocked fraud reports provide details of events blocked by Protect360.
- The date range relates to the install date.
- The reports are available via Pull API.
| Report name |
|---|
| Partners (media sources) |
| Partners by date |
| Geo |
| Geo by date |
| Partner's campaign report |
Limitation: The blocking reason Bots displays even in cases where the reason should be app version or missing customer user id.