Skip to main content

Kochava API Connector

Updated this week
Kochava logo landscape transparent PNG - StickPNG

Overview

The Kochava integration supports importing mobile attribution and SKAdNetwork data using custom and summary methods. It captures key performance data such as installs and SKAd installs, with support for multiple app GUIDs and traffic types. It consists of two jobs and uses Kochava’s API for authenticated data fetching.

Data handled by the integration:

Account & Campaign Data

  • Advertiser accounts and account IDs

  • App campaigns (iOS, Android)

  • Campaign objectives, start/end dates, budgets, and status (active, paused, completed)

  • Attribution windows and configuration

Creative & Ad Data

  • Creative metadata: ad ID, format, type

  • Associated campaign and ad group

  • Media assets (images, video, app store links)

  • Approval status and compliance

Performance Metrics

  • Installs and in-app events (registrations, purchases, upgrades)

  • Clicks, impressions, CTR

  • Cost, CPC, CPM, spend

  • Retention and engagement metrics

  • Lifetime value (LTV) tracking

Audience & Targeting

  • Device type and OS version

  • Geography (country, region)

  • App versions and SDK integration details

  • Retargeting and re-engagement segments

Metadata & Reference Tables

  • Account, campaign, ad group hierarchy

  • Creative type and ad format definitions

  • Device, OS, and geographic mappings

  • Event and conversion definitions

Granularity:

Data is broken down by Account, Campaign, Ad Group and Creative level.

Purpose:

  • Monitor mobile app campaigns (installs and in-app events)

  • Attribute installs and conversions to specific campaigns and creatives

  • Track retention, engagement, and LTV metrics

  • Optimise targeting, bidding, and creative performance

  • Build dashboards integrating mobile app campaign data with other paid channels

  • Perform historical audits and campaign analysis

Refresh Cadence:

Data is refreshed daily.

Update Modes:

Append (for data table), Refresh (for metadata)

For more information on this integration, please follow link here.


Data Feed: Kochava

Feed Details

Key

Value

Feed

kochava

Status

1 (active)

Job Label

Kochava - Installs Import, Kochava - SKAd Import

Lookback

5 days (installs), 30 days (SKAd)

First Run

02:00 (installs), 07:00 (SKAd)

Frequency

24h

Lookback Window

0


Jobs

1. Kochava - Installs Import

Field

Value

Type

data

Table

kochava_data_installs_primary

Description

Kochava - Installs Import

Update Mode

append

Create Target

true

Date Column

date_received

Priority

1

Options:

  • method: (hidden) custom

  • traffic: install

  • sql_kquery: (custom KQuery to select data)


2. Kochava - SKAd Import

Field

Value

Type

data

Table

kochava_data_skad

Description

Kochava - SKAd Import

Update Mode

append

Create Target

true

Date Column

bright_custom_date

Priority

1

Options:

  • method: (hidden) summary

  • traffic: (hidden) install,skadnetwork

  • file_date_field: (hidden) date_range_start_utc

  • traffic_grouping: (hidden) multiple dimensions

  • custom_sql_append: (hidden) bright_custom_date = date_range_start_utc


Connection Configuration

Key

Type

Description

api_key

text

Kochava API key from UI

app_guids

text

App GUID(s) for data retrieval


Dimensions

Name

Result Fields

Network Name [Kochava]

kochava_data_installs_primary.network_name

Device OS [Kochava]

kochava_data_installs_primary.device_os_name


📊 Base Metrics

Name

Formula

Installs [Kochava]

COUNT({kochava_data_installs_primary.install_id})

SK Installs [Kochava]

SUM({kochava_data_skad.sk_installs})


Composite Metrics

None defined.


Joins

No data source joins configured.

Did this answer your question?