Pulling Reports


Feature Summary: The following document defines the process for creating reports within the Kochava Interface.

 

Available reports include the following:

  • Audience — This report provides a list of device IDs based on Analytics filters in CSV or JSON format.
  • 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, Kochava can dynamically convert all inbound events with a non-US dollar currency to a US dollar currency. Through the reporting features Kochava 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 Kochava.
  2. Select the desired Account and App.
  3. Select Audiences & Reports > Reports.
  4.  


Reports Interface Overview

The Reports interface displays all of the reports available to be run or customized. Reports can be quickly run with the default settings by clicking Run, or each report may be custom-built in order to suit a specific need by clicking Customize.

 

A. Click to run a report with the default settings.
B. Click to customize a report.
D. Click to update Report Columns.

 

Edit Report Columns:

The report default columns can be reordered or removed within the detail reports.

  1. Click Edit Report Columns.
  2. Select the Report Type:
    • Click
    • Event
    • Install
    • Reengagement

    NOTE: The Report Default Columns available depend on the report selected.

    NOTE: Columns may be reordered by dragging and dropping them into the desired order. Columns may be added by clicking on the “+” and removed by clicking on the “X”.

  3. Arrange the desired columns.
  4. Click Save.
  5.  

    A. Select the report type.
    B. Select, remove or arrange the desired report columns.


Running Default Reports

Reports can be easily run with the default settings and sent to the account email address and S3 bucket. Clicking Run will automatically generate a report with the default settings listed below:

 

General Settings
Report Name — Default Generated Report Name
Delivery Method — CSV
Timezone — Account Timezone
Frequency — One-time
Date Range — Last 7 days
Group By — Day
Recipient(s) — Account email address
Traffic
Traffic Options — Click, Install
Filters
Networks — All Networks
Campaigns — None
Trackers — None
Countries — None
Grouping
Grouping Options — Network, Campaign, Tracker
Custom S3 Bucket
Bucket Name — Account Setting
Bucket Region — Account Setting
AWS Access Key — Account Setting
AWS Secret Key — Account Setting


 

General Settings
Report Name — Default Generated Report Name
Delivery Method — CSV
Timezone — Account Timezone
Frequency — One-time
Date Range — Last 7 days
Group By — Day
Recipient(s) — Account email address
Traffic
Traffic Options — Click, Impression, Install
Filters
Networks — All Networks
Campaigns — None
Trackers — None
Countries — None
Grouping
Grouping Options — Network
Custom S3 Bucket
Bucket Name — Account Setting
Bucket Region — Account Setting
AWS Access Key — Account Setting
AWS Secret Key — Account Setting


 

General Settings
Report Name — Default Generated Report Name
Delivery Method — CSV
Timezone — UTC
Frequency — One-time
Recipient(s) — Account email address
Filters
Networks — All Networks
Countries — None
Grouping
Grouping Options — Network
Custom S3 Bucket
Bucket Name — Account Setting
Bucket Region — Account Setting
AWS Access Key — Account Setting
AWS Secret Key — Account Setting


 

General Settings
Report Name — Default Generated Report Name
Delivery Method — CSV
Timezone — UTC
Frequency — One-time
Recipient(s) — Account email address
Filters
Networks — All Networks
Countries — None
Grouping
Grouping Options — Network
Custom S3 Bucket
Bucket Name — Account Setting
Bucket Region — Account Setting
AWS Access Key — Account Setting
AWS Secret Key — Account Setting


 

General Settings
Report Name — Default Generated Report Name
Delivery Method — CSV
Timezone — Account Timezone
Frequency — One-time
Date Range — Last 7 days
Recipient(s) — Account email address
Traffic
Traffic Options — Click
Filters
Networks — All Networks
Campaigns — None
Trackers — None
Countries — None
Traffic Includes
Click — kochava_click_id, partner_click_id, click_date_utc, click_date_adjusted, click_status, click_matched_impression, click_matched_install, click_network, click_network_name, click_tracker, click_tracker_name, click_campaign, click_campaign,name, click_site, click_creative, clickgeo_country_code, clickgeo_country_name, clickgeo_city, click_device_id, click_ip, click_device_ver, click_device_ua, click_original_request, click_identifiers, click_identifiers_idfa, click_identifiers_android_id, click_identifiers_android_id_md5, click_identifiers_android_id_sha1, click_identifiers_adid, click_identifiers_custom, click_identifiers_waid, click_identifiers_ip, click_identifiers_email_0, click_identifiers_email_1, click_duplicate
Impression Detail — None
Geo Detail — None
Additional Options — None
Custom S3 Bucket
Bucket Name — Account Setting
Bucket Region — Account Setting
AWS Access Key — Account Setting
AWS Secret Key — Account Setting


 

General Settings
Report Name — Default Generated Report Name
Delivery Method — CSV
Timezone — Account Timezone
Frequency — One-time
Date Range — Last 7 days
Recipient(s) — Account email address
Traffic
Traffic Options — influencer_click
Filters
Networks — All Networks
Custom S3 Bucket
Bucket Name — Account Setting
Bucket Region — Account Setting
AWS Access Key — Account Setting
AWS Secret Key — Account Setting


 

General Settings
Report Name — Default Generated Report Name
Delivery Method — CSV
Timezone — Account Timezone
Frequency — One-time
Date Range — Last 7 days
Recipient(s) — Account email address
Traffic
Traffic Options — Cost
Custom S3 Bucket
Bucket Name — Account Setting
Bucket Region — Account Setting
AWS Access Key — Account Setting
AWS Secret Key — Account Setting


 

General Settings
Report Name — Default Generated Report Name
Delivery Method — CSV
Timezone — Account Timezone
Frequency — One-time
Date Range — Last 7 days
Recipient(s) — Account email address
Traffic
Traffic Options — fractional
Filters
Networks — All Networks
Custom S3 Bucket
Bucket Name — Account Setting
Bucket Region — Account Setting
AWS Access Key — Account Setting
AWS Secret Key — Account Setting


 

General Settings
Report Name — Default Generated Report Name
Delivery Method — CSV
Timezone — Account Timezone
Frequency — One-time
Date Range — Last 7 days
Recipient(s) — Account email address
Traffic
Traffic Options — influencer_imp
Custom S3 Bucket
Bucket Name — Account Setting
Bucket Region — Account Setting
AWS Access Key — Account Setting
AWS Secret Key — Account Setting


 

General Settings
Report Name — Default Generated Report Name
Delivery Method — CSV
Timezone — Account Timezone
Frequency — One-time
Date Range — Last 7 days
Recipient(s) — Account email address
Traffic
Traffic Options — install
Filters
Networks — All Networks
Campaigns — None
Trackers — None
Countries — None
Traffic Includes
Install — install_matched_on, install_matched_by, install_status, install_impression_date_utc, install_impression_date_adjusted, install_click_date_utc, install_click_date_adjusted, install_click_date_utc, install_click_date_adjusted, install_date_utc, install_date_adjusted, kochava_click_id, partner_click_id, install_kochava_device_id, attribution_tracker, attribution_tracker_name, attribution_network, attribution_network_name, attribution_campaign, attribution_campaign_name, attribution_site, attribution_creative, installgeo_country_code, installgeo_country_name, installgeo_city, install_original_request, install_price, install_devices_ids, install_devices_idfa, isntall_devices_android_id, install_devices_adid, install_devices_custom, install_devices_waid, install_devices_email_0, install_devices_email_1, install_devices_ip, install_device_version, install_device_ua
Click Detail — None
Impression Detail — None
GEO Detail — None
Additional Options — None
Custom S3 Bucket
Bucket Name — Account Setting
Bucket Region — Account Setting
AWS Access Key — Account Setting
AWS Secret Key — Account Setting


 

General Settings
Report Name — Default Generated Report Name
Delivery Method — CSV
Timezone — Account Timezone
Frequency — One-time
Date Range — Last 7 days
Recipient(s) — Account email address
Traffic
Traffic Options — impression
Filters
Networks — All Networks
Campaigns — None
Trackers — None
Countries — None
Traffic Includes
Additional Options — None
Custom S3 Bucket
Bucket Name — Account Setting
Bucket Region — Account Setting
AWS Access Key — Account Setting
AWS Secret Key — Account Setting


 

General Settings
Report Name — Default Generated Report Name
Delivery Method — CSV
Timezone — Account Timezone
Frequency — One-time
Date Range — Last 7 days
Recipient(s) — Account email address
Traffic
Traffic Options — reengagement
Filters
Networks — All Networks
Campaigns — None
Trackers — None
Countries — None
Traffic Includes
Reengagement — kochava_click_id, kochava_device_id, reengage_event_date_utc, reengage_event_date_adjusted, reengage_click_month, reengage_click_date_utc, reengage_click_date_adjusted, reengage_event_name, reengage_status, reengage_network, reengage_network_name, reengage_tracker, reengage_tracker_name, reengage_campaign, reengage_campaign_name, reengage_site, reengage_creative, reengage_country_code, reengage_ip, reengage_device_ver, reengage_device_id, reengage_original_request, reengage_matched_impression, reengage_matched_install, reengage_identifiers, reengage_duplicate, click_original_request, reengagegeo_continent_code, reengagegeo_country_code, reengagegeo_country_code3, reengagegeo_country_name, reengagegeo_region, reengagegeo_postal_code, reengagegeo_dma_code, reengagegeo_city, reengagegeo_area_code, reengagegeo_longitude, reengagegeo_latitude
Additional Options — None
Custom S3 Bucket
Bucket Name — Account Setting
Bucket Region — Account Setting
AWS Access Key — Account Setting
AWS Secret Key — Account Setting


 

General Settings
Report Name — Default Generated Report Name
Delivery Method — CSV
Timezone — Account Timezone
Frequency — One-time
Date Range — Last 7 days
Recipient(s) — Account email address
Traffic
Traffic Options — cost_restated
Custom S3 Bucket
Bucket Name — Account Setting
Bucket Region — Account Setting
AWS Access Key — Account Setting
AWS Secret Key — Account Setting


 

General Settings
Report Name — Default Generated Report Name
Delivery Method — CSV
Timezone — Account Timezone
Frequency — One-time
Date Range — Last 7 days
Recipient(s) — Account email address
Traffic
Traffic Options — reengagement_imp
Filters
Networks — All Networks
Campaigns — None
Trackers — None
Countries — None
Traffic Includes
Reengagement Impression — kochava_device_id, reengagement_event_date_utc, reengagment_event-date_adjusted, reengage_imp_month, reengage_imp_date_utc, reenage_imp_date_adjusted, reengage_event_name, reengage_status, reengage_network, reengage_tracker, reengage_site, reengage_creative, reengage_country_code, reengage_ip, reengage_device_ver, reengage_device_id, reengage_original_request, reengage_matched_install, reengage_identifiers, imp_original_request
Additional Options — None
Custom S3 Bucket
Bucket Name — Account Setting
Bucket Region — Account Setting
AWS Access Key — Account Setting
AWS Secret Key — Account Setting


 

General Settings
Report Name — Default Generated Report Name
Delivery Method — CSV
Timezone — Account Timezone
Frequency — One-time
Date Range — Last 7 days
Recipient(s) — Account email address
Traffic
Traffic Options — cost_restated
Custom S3 Bucket
Bucket Name — Account Setting
Bucket Region — Account Setting
AWS Access Key — Account Setting
AWS Secret Key — Account Setting


 

General Settings
Report Name — Default Generated Report Name
Delivery Method — CSV
Timezone — Account Timezone
Frequency — Scheduled/Recurring
Repeat — Weekly — Current Week Day
Recipient(s) — Account email address
Filters
Networks — All Networks
Trackers — None
Custom S3 Bucket
Bucket Name — Account Setting
Bucket Region — Account Setting
AWS Access Key — Account Setting
AWS Secret Key — Account Setting



Creating a Customized 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
Event Report
Fractional Report
Impression MTA Report
Install Report
Matched Impression Report
Reengagement Report
Restated Cost
Restated Cost (Advanced)
Insight Report
Campaign Summary Report
Network Summary Report
Retention Standard
Retention Windowed
Time Zone
Frequency
One-Time
Schedule/
Recurring
Repeat Daily
Repeat Weekly
Repeat Monthly
Format
CSV
JSON
Delivery Method
Email
Custom S3 Bucket
Traffic
Click
Influencer Click
Cost
Restated Cost
Advanced Restated Cost
Install
Event
Fractional
Influencer Impressions
Impressions
Reengagement
Trafficverif
Network Spend
Network Spend Restated
Filters
Networks
Campaigns
Trackers
Countries
Events
Traffic Includes
Click
Event
Install Detail
Click Detail
Impressions Details
GEO Detail
Additional Options
Install
Traffic Verification
Reengagement
Include Tracker ID
Grouping
Network
Campaign
Tracker
Site
Creative
Country
DMA
State
City
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. This section provides the ability to add or remove Traffic Options.
C. This section provides the ability to include or exclude Networks, Trackers or Countries from a report.
D. The Traffic Includes section provides the ability to refine, add, remove and reorganize the report data to best suit your needs.
E. S3 Bucket Settings.


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


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: Jul 11, 2019 at 1:13 pm