Pulling Reports

Feature Summary: The following document defines the process for creating reports within the Free App Analytics Interface.


Available reports include the following:

  • Detail Reports — These reports provide a row-level accounting of actions such as clicks or events within campaigns.
  • Optimization — These reports provide a more in-depth insight into high performing metrics and the metrics that are under-performing.
  • Specialized Reports — These reports provide more in-depth insight into marketing performance. New reports will be added periodically.
  • Summary Reports — These reports provide a summary accounting of unique clicks, duplicate clicks, installs and reengagement events segmented by campaign or network.


NOTE: If Currency Normalization has been enabled at the app level, Free App Analytics can dynamically convert all inbound events with a non-US dollar currency to a US dollar currency. Through the reporting features Free App Analytics offers, primarily purchase events, advertisers will see the details of the original currency which was provided along with the original amount. The converted total amount can be viewed within the dimension_sum column.

Navigating to Reports Interface

  1. Log in to Free App Analytics .
  2. Select the desired app.
  3. Select App Tools>Reports.

Reports Interface Overview

The Reports interface displays all of the reports that have been run for the corresponding app. Reports can be organized by type or frequency.


Reports Section:

The Reports section displays all of the reports that have been generated, are currently being processed, or are Scheduled/Recurring reports. Reports that have been successfully generated or are scheduled are indicated with green. Reports that are being processed are indicated with blue.

You can filter reports by selecting the desired values within Report Type, Report Frequency and Traffic Type menus.

NOTE: If you receive an error that there are no reports matching your search criteria, broaden your search criteria.


A. Click to Add a Report
B. Click to update the Default Report Columns

General information about each report is displayed including the Report Type, Date and Title.


A. Report Title
B. Report Type
C. Report Expand Button
D. Reports being Processed
E. Reports being Queued
F. Processed Reports

Click the expand button on any report to see additional information including Delivery Format, Delivery Method, Time Zone, Recipient(s), Traffic Options, Traffic Grouping and Traffic.



Delete a Report:

  1. Click Report Tools>Delete Report.

Creating a New Report

NOTE: Depending on the type of report that is selected, different options may or may not be available.

NOTE: Detail Reports that exceed 5.0 gigabytes in size will be compressed to enable accelerated download.

  1. Select the Report Type.


Click Report
Click MTA Report
Cost Report (FAA Limited)
Event Report
Fractional Report
Impression MTA Report
Install Report
Matched Impression Report
Reengagement Report
Insight Report
Campaign Summary Report
Network Summary Report
Retention Standard
Retention Windowed
Time Zone
Repeat Daily
Repeat Weekly
Repeat Monthly
Delivery Method
Custom S3 Bucket
Influencer Click
Restated Cost
Influencer Impressions
Network Spend
Network Spend Restated
Traffic Includes
Install Detail
Click Detail
Impressions Details
GEO Detail
Additional Options
Traffic Verification
Custom Parameter


NOTE: Within the grouping feature, information may be grouped by Custom Parameter (i.e., cp_0). Custom Parameters are setup during campaign creation. For more information about using custom parameters, contact your Client Success Managers.

NOTE: If adding network_restated_cost in a summary report, the below will need to be selected:

  • Time_zone must be set to UTC.
  • Traffic grouping can only be set to “network”.
  1. Enter a Report Name.
  2. Select the Time Zone. (set to user default)
  3. Select Report Frequency:
    1. One-Time
    2. Scheduled/Recurring
  4. Select Date Range. (Last 7 days by default)
  5. Select Delivery Format:
    1. CSV
    2. JSON
  6. Enter Email. (set to user default)
  7. NOTE: If utilizing a S3 Bucket, no email address is needed and may be removed.

  8. Select any Report Specific Options.
  9. Enter S3 Bucket settings. (optional, see below for details)
  10. Click Submit.

NOTE: The image below illustrates the settings associated with the Install report. The available settings will be different depending on the report selected.


A. This section provides the ability to update general report options.
B. S3 Bucket Settings.
C. This section provides the ability to add or remove Traffic Options.
D. This section provides the ability to include or exclude Networks, Trackers or Countries from a report.
E. The Traffic Includes section provides the ability to refine, add, remove and reorganize the report data to best suit your needs.
F. Data categories can be drug and dropped to reorganize within Traffic Includes section.

Audience Export Report

The Audience Export report provides a list of audience device IDs in either CSV or JSON format based upon audience filter setup with Analytics. Audience Export reports can be setup as a onetime report or repeatedly on a daily, weekly or monthly basis.

  1. Create an Analytics Filter. For more information about creating an Analytics Filter, refer to our Analytics Page Tools support documentation.
  2. Enter a Report Name.
  3. Select Report Type>Audience Export.
  4. Select a Time Zone.
  5. Select a Report Frequency:
    • One Time
    • Scheduled/Recurring
  6. Select the Repeat frequency:
    • Daily
    • Weekly:
      • Monday
      • Tuesday
      • Wednesday
      • Thursday
      • Friday
      • Saturday
      • Sunday
    • Monthly:
      • On 1 through 28
      • NOTE: The number selected will determine the date of the start and end date (e.g., Start date of the 28th day of the previous month and end date of the 28th day of the current month).

  7. Select the Delivery Format:
    • CSV
    • JSON
  8. Enter a delivery Email.
  9. Enter Custom S3 Bucket information. Refer to the Custom S3 Bucket Settings section below. (optional)
  10. Select a Filter Set.
  11. Click Submit.


A. Custom S3 Bucket Fields.

Custom S3 Bucket Settings

Reports can be sent to a designated customer S3 bucket. The S3 Bucket settings can be setup for the selected app on the Edit App page. For more information about setting up a Custom S3 Bucket for an app, refer to our Create/Edit Apps support documentation.

NOTE: If the S3 Bucket settings have been entered in the Edit App page, the settings may be modified for the report being created/edited within the reports interface.

  1. Enter the Bucket Name.
  2. Enter the Bucket Region.
  3. Enter the AWS Access Key.
  4. Enter the AWS Secret Key.



Example of S3 Bucket Permissions:


If a status code: 403 is received when sending reports to an S3 bucket, the following can be completed fix to the error. Starting in November 2018 while creating a new S3 bucket a setting called Block new public ACLs and uploading public objects. was available. While Amazon has labeled this option as recommended, enabling this option will reports from Kochava as the reports are uploaded as public.

NOTE: If this setting is unchecked, the S3 bucket will not be public, the correct access key, secret key and permissions are still required.

  1. Log in to AWS.
  2. Select Permissions>Public Access Settings.
  3. Uncheck Block new public ACLs and uploading public objects.
  4. Click Save.


A. Uncheck “Block new public ACLs and uploading public objects”.

Default Report Columns

The columns within the Install, Event and Click reports can be configured as needed to suit the needs of the user. Options can be added, removed or rearranged. Once a custom configuration has been created that configuration may be saved for future use.


  1. Click Default Report Columns.
  2. Select the Report Type.
  3. Add/Remove Parameters. (optional)
  4. Rearrange Parameters. (optional)
  5. Click Save.

NOTE: Once the default custom configuration settings have been established for a report type, those configurations will be persisted to that report type within the UI and may also be accessed using the API.


A. Select Report Type
B. Select and arrange the parameters

Reports Available to Networks

The following reports are available for network access:

  • Click Detail Report
  • Install Detail Report
  • Network Summary Report

Frequently Asked Questions


Last Modified: Apr 2, 2019 at 9:46 am