1. Home
  2. Marketers
  3. Cost
  4. Cost Manual Upload Process
  1. Home
  2. Marketers
  3. Cost Manual Upload Process

Cost Manual Upload Process

This feature is available only with paid Kochava accounts. Contact us to learn more.

Kochava provides a manual upload process for Media Partners that do not have an API.

WARNING: Any data uploaded via this process is permanent and cannot be edited or deleted. Please keep accurate records of uploads, so that duplicate data is not created by overlapping dates. Recommend uploading on a specific cadence like daily or Mon-Sun to ensure no duplicate data is created.


Cost Configuration User Interface

  1. Log in to Kochava.
  2. Select the desired Account.
  3. Select Cost > Configuration.

Creating a Manual Upload Configuration

NOTE: Only Media Partners with the upload icon Upload File icon are eligible for this process.

  1. Click + Add a Media Partner.
  2. Select the desired Media Partner.

NOTE: If you see the partner in the provided list, or in the Cost Configuration → Add a Media Partner list, Kochava has already performed the mapping required and data can be uploaded at any time. If you do not see the Media Partner on the list, Kochava will need to integrate the partner first. Contact your Client Success Manager to learn more.

  1. Enter the Configuration Name.
  2. SelectUpload File icon
    • This box will appear where you can drag and drop your CSV file to upload.
      CSV upload box
  3. Select the Time Zone.
  4. Select the desired Currency.
  5. Enter the desired email address for Notifications.

NOTE: By default, the current user’s email address who is setting up the configuration will automatically entered into the Notifications field.

  1. Click Save.

NOTE: Manual Upload files will need to be requested from the Media Partner’s UI or representative – and be in the CSV format with a single tab. If the file does not match Kochava’s column mapping the file needs to be edited or the upload will fail.

Manual Upload File Example
DateAppCampaign IDCampaign NamePlatformCountryImpressionsClicksInstallsSpend
05-05-2026Kochava Support Android Demo123456789ERtest_US-UK-DEiOSUS16377761462322.1
05-05-2026Kochava Support Android Demo123456789ERtest_US-UK-DEiOSUK982341981211.5
05-05-2026Kochava Support Android Demo123456789ERtest_US-UK-DEiOSDE754210654311.2
05-05-2026Kochava Support Android Demo987654321ABtest_US-CA-AUAndroidUS21054321823454.8
05-05-2026Kochava Support Android Demo987654321ABtest_US-CA-AUAndroidCA643120532110.9
05-05-2026Kochava Support Android Demo987654321ABtest_US-CA-AUAndroidAU521900410210.8
05-05-2026Kochava Support iOS Demo112233445BCtest_FR-ES-ITiOSFR891200784333.2
05-05-2026Kochava Support iOS Demo112233445BCtest_FR-ES-ITiOSES672300592022.4
05-05-2026Kochava Support iOS Demo112233445BCtest_FR-ES-ITiOSIT543100481011.7
05-05-2026Kochava Support iOS Demo556677889CDtest_JP-KR-SGAndroidJP12345601123045.1
05-05-2026Kochava Support iOS Demo556677889CDtest_JP-KR-SGAndroidKR987430876433.9
05-05-2026Kochava Support iOS Demo556677889CDtest_JP-KR-SGAndroidSG412300321011.1
05-06-2026Kochava Support Android Demo123456789ERtest_US-UK-DEiOSUS17012341500232.8
05-06-2026Kochava Support Android Demo123456789ERtest_US-UK-DEiOSUK10234501034121.9
05-06-2026Kochava Support Android Demo123456789ERtest_US-UK-DEiOSDE812300712011.3
05-06-2026Kochava Support Android Demo987654321ABtest_US-CA-AUAndroidUS22310001945065.2
05-06-2026Kochava Support Android Demo987654321ABtest_US-CA-AUAndroidCA710200613021.4
05-06-2026Kochava Support Android Demo987654321ABtest_US-CA-AUAndroidAU589000487011
05-06-2026Kochava Support iOS Demo112233445BCtest_FR-ES-ITiOSFR934500821043.6
05-06-2026Kochava Support iOS Demo112233445BCtest_FR-ES-ITiOSES701000634022.6
05-06-2026Kochava Support iOS Demo112233445BCtest_FR-ES-ITiOSIT578900510021.9
05-06-2026Kochava Support iOS Demo556677889CDtest_JP-KR-SGAndroidJP13120001198055.7
05-06-2026Kochava Support iOS Demo556677889CDtest_JP-KR-SGAndroidKR1043200912034.2
05-06-2026Kochava Support iOS Demo556677889CDtest_JP-KR-SGAndroidSG453100364011.3
05-07-2026Kochava Support Android Demo123456789ERtest_US-UK-DEiOSUS15890001401022
05-07-2026Kochava Support Android Demo123456789ERtest_US-UK-DEiOSUK945000920011.4
05-07-2026Kochava Support Android Demo123456789ERtest_US-UK-DEiOSDE723000620011.1
05-07-2026Kochava Support Android Demo987654321ABtest_US-CA-AUAndroidUS20500001780044.5
05-07-2026Kochava Support Android Demo987654321ABtest_US-CA-AUAndroidCA620000510010.8
05-07-2026Kochava Support Android Demo987654321ABtest_US-CA-AUAndroidAU503000390010.7
05-07-2026Kochava Support iOS Demo112233445BCtest_FR-ES-ITiOSFR870000760033
05-07-2026Kochava Support iOS Demo112233445BCtest_FR-ES-ITiOSES651000570022.2
05-07-2026Kochava Support iOS Demo112233445BCtest_FR-ES-ITiOSIT521000460011.6
05-07-2026Kochava Support iOS Demo556677889CDtest_JP-KR-SGAndroidJP11980001080044.9
05-07-2026Kochava Support iOS Demo556677889CDtest_JP-KR-SGAndroidKR960000840033.7
05-07-2026Kochava Support iOS Demo556677889CDtest_JP-KR-SGAndroidSG398000305011
05-08-2026Kochava Support Android Demo223344556EFtest_BR-MX-ARAndroidBR18450001640054.2
05-08-2026Kochava Support Android Demo223344556EFtest_BR-MX-ARAndroidMX1023000910021.8
05-08-2026Kochava Support Android Demo223344556EFtest_BR-MX-ARAndroidAR612000540011
05-08-2026Kochava Support iOS Demo334455667GHtest_IN-ID-PHiOSIN23410002010076.1
05-08-2026Kochava Support iOS Demo334455667GHtest_IN-ID-PHiOSID1120000980032.9
05-08-2026Kochava Support iOS Demo334455667GHtest_IN-ID-PHiOSPH734000630021.5
05-08-2026Kochava Support Android Demo123456789ERtest_US-UK-DEiOSUS17240001530032.9
05-08-2026Kochava Support Android Demo123456789ERtest_US-UK-DEiOSUK10560001060022
05-08-2026Kochava Support Android Demo123456789ERtest_US-UK-DEiOSDE841000740011.4
05-08-2026Kochava Support Android Demo987654321ABtest_US-CA-AUAndroidUS22780001990065.5
05-08-2026Kochava Support Android Demo987654321ABtest_US-CA-AUAndroidCA731000640021.6
05-08-2026Kochava Support Android Demo987654321ABtest_US-CA-AUAndroidAU601000500011.1

BEST PRACTICES: When working to integrate each Media Partner, Kochava requests the base report file, so that any subsequent reports used for upload will hopefully be the same and not require editing. However, the best practice is to verify the file to make sure the column headers match – in the event that the report was changed or is a different type.


Google Sheet Upload:

The manual upload process may also be completed utilizing Google Sheets.

NOTE: Files may contain multiple days, but only a single tab. Any additional tabs in the spreadsheet will be ignored. Date format must be mm-dd-yyyy. For example: 2-26-2022 must be formatted as 02-26-2022.

CAUTION: Any data uploaded via this process is permanent and cannot be edited or deleted. Please keep accurate records of uploads, so that duplicate data is not created by overlapping dates. Recommend uploading on a specific cadence like Mon-Sun to ensure no duplicate data.

  1. Open the desired Google Sheet.
  2. Click File > Share > Publish to web.
  3. Select to share the Entire Document.
  4. Select Comma-separated values (.csv) as the format.
  5. Click Publish.
  6. A pop-up message will be displayed stating “Are you sure you want to publish this selection?” Click OK.
  7. Copy the provided link and paste into the Kochava UI as shown above.

NOTE: After saving a new manual upload configuration or new file upload, please wait a few minutes for Kochava’s system to upload the file and display the new status.


Uploading Additional Files:

To add additional files after the initial upload:

  1. Click on the Configuration Edit () button.
  2. Click Upload New File.
  3. Follow the procedures from the upload process above.

NOTE: Some configuration values will persist from the original upload, but others may need to be entered again before clicking Save.


Daily Cost Data Ingestion

This option is designed for ongoing, day-to-day cost reporting through a CSV file upload.

  1. Click on the Configuration Edit () button for the desired media partner.
  2. Select Upload Daily Data.
  1. Select specific Date.
  2. Drag and drop a date-specific CSV file (format: YYYY-MM-DD.csv)
  3. Once uploaded, the file is automatically queued and scheduled for processing.

Historical Data Ingestion (Backfill)

This option is designed for media partners that have historical cost data that needs to be backfilled.

  1. Click on the Configuration Edit () button for the desired media partner.
  2. Select Upload Backfill Data.
  3. Drag and drop a date-specific CSV file (format: YYYY-MM-DD.csv)
Manual Upload File Example
DateAppCampaign IDCampaign NamePlatformCountryImpressionsClicksInstallsSpend
05-05-2026Kochava Support Android Demo123456789ERtest_US-UK-DEiOSUS16377761462322.1
05-05-2026Kochava Support Android Demo123456789ERtest_US-UK-DEiOSUK982341981211.5
05-05-2026Kochava Support Android Demo123456789ERtest_US-UK-DEiOSDE754210654311.2
05-05-2026Kochava Support Android Demo987654321ABtest_US-CA-AUAndroidUS21054321823454.8
05-05-2026Kochava Support Android Demo987654321ABtest_US-CA-AUAndroidCA643120532110.9
05-05-2026Kochava Support Android Demo987654321ABtest_US-CA-AUAndroidAU521900410210.8
05-05-2026Kochava Support iOS Demo112233445BCtest_FR-ES-ITiOSFR891200784333.2
05-05-2026Kochava Support iOS Demo112233445BCtest_FR-ES-ITiOSES672300592022.4
05-05-2026Kochava Support iOS Demo112233445BCtest_FR-ES-ITiOSIT543100481011.7
05-05-2026Kochava Support iOS Demo556677889CDtest_JP-KR-SGAndroidJP12345601123045.1
05-05-2026Kochava Support iOS Demo556677889CDtest_JP-KR-SGAndroidKR987430876433.9
05-05-2026Kochava Support iOS Demo556677889CDtest_JP-KR-SGAndroidSG412300321011.1
05-06-2026Kochava Support Android Demo123456789ERtest_US-UK-DEiOSUS17012341500232.8
05-06-2026Kochava Support Android Demo123456789ERtest_US-UK-DEiOSUK10234501034121.9
05-06-2026Kochava Support Android Demo123456789ERtest_US-UK-DEiOSDE812300712011.3
05-06-2026Kochava Support Android Demo987654321ABtest_US-CA-AUAndroidUS22310001945065.2
05-06-2026Kochava Support Android Demo987654321ABtest_US-CA-AUAndroidCA710200613021.4
05-06-2026Kochava Support Android Demo987654321ABtest_US-CA-AUAndroidAU589000487011
05-06-2026Kochava Support iOS Demo112233445BCtest_FR-ES-ITiOSFR934500821043.6
05-06-2026Kochava Support iOS Demo112233445BCtest_FR-ES-ITiOSES701000634022.6
05-06-2026Kochava Support iOS Demo112233445BCtest_FR-ES-ITiOSIT578900510021.9
05-06-2026Kochava Support iOS Demo556677889CDtest_JP-KR-SGAndroidJP13120001198055.7
05-06-2026Kochava Support iOS Demo556677889CDtest_JP-KR-SGAndroidKR1043200912034.2
05-06-2026Kochava Support iOS Demo556677889CDtest_JP-KR-SGAndroidSG453100364011.3
05-07-2026Kochava Support Android Demo123456789ERtest_US-UK-DEiOSUS15890001401022
05-07-2026Kochava Support Android Demo123456789ERtest_US-UK-DEiOSUK945000920011.4
05-07-2026Kochava Support Android Demo123456789ERtest_US-UK-DEiOSDE723000620011.1
05-07-2026Kochava Support Android Demo987654321ABtest_US-CA-AUAndroidUS20500001780044.5
05-07-2026Kochava Support Android Demo987654321ABtest_US-CA-AUAndroidCA620000510010.8
05-07-2026Kochava Support Android Demo987654321ABtest_US-CA-AUAndroidAU503000390010.7
05-07-2026Kochava Support iOS Demo112233445BCtest_FR-ES-ITiOSFR870000760033
05-07-2026Kochava Support iOS Demo112233445BCtest_FR-ES-ITiOSES651000570022.2
05-07-2026Kochava Support iOS Demo112233445BCtest_FR-ES-ITiOSIT521000460011.6
05-07-2026Kochava Support iOS Demo556677889CDtest_JP-KR-SGAndroidJP11980001080044.9
05-07-2026Kochava Support iOS Demo556677889CDtest_JP-KR-SGAndroidKR960000840033.7
05-07-2026Kochava Support iOS Demo556677889CDtest_JP-KR-SGAndroidSG398000305011
05-08-2026Kochava Support Android Demo223344556EFtest_BR-MX-ARAndroidBR18450001640054.2
05-08-2026Kochava Support Android Demo223344556EFtest_BR-MX-ARAndroidMX1023000910021.8
05-08-2026Kochava Support Android Demo223344556EFtest_BR-MX-ARAndroidAR612000540011
05-08-2026Kochava Support iOS Demo334455667GHtest_IN-ID-PHiOSIN23410002010076.1
05-08-2026Kochava Support iOS Demo334455667GHtest_IN-ID-PHiOSID1120000980032.9
05-08-2026Kochava Support iOS Demo334455667GHtest_IN-ID-PHiOSPH734000630021.5
05-08-2026Kochava Support Android Demo123456789ERtest_US-UK-DEiOSUS17240001530032.9
05-08-2026Kochava Support Android Demo123456789ERtest_US-UK-DEiOSUK10560001060022
05-08-2026Kochava Support Android Demo123456789ERtest_US-UK-DEiOSDE841000740011.4
05-08-2026Kochava Support Android Demo987654321ABtest_US-CA-AUAndroidUS22780001990065.5
05-08-2026Kochava Support Android Demo987654321ABtest_US-CA-AUAndroidCA731000640021.6
05-08-2026Kochava Support Android Demo987654321ABtest_US-CA-AUAndroidAU601000500011.1

Data Restatement & Resync Mechanisms

To account for late-arriving data or corrections to previously reported spend, the system supports comprehensive data restatement.

Standard Daily Restatement (≤ 7-Day Window)

  • The system supports automatic cost data restatement for a maximum of 7 days from the current date.
  • If updates are available within this rolling 7-day window, users simply re-upload the respective YYYY-MM-DD.csv file. The system will automatically detect the file and sync the updated data.

Extended Restatement (> 7-Day Window)

  • For data corrections falling outside the standard 7-day window, automatic syncing is disabled to protect historical data integrity.
  • You must explicitly utilize the “Daily Resync” action in the portal after uploading the updated dated file to force the restatement.
  1. Click on the Configuration Edit () button for the desired media partner.
  2. Select Daily Resync Range

Max 90 days. The backend will reprocess the original CSV files for each date.

Status View Resync Initiation

  • Alternatively, you can trigger targeted resyncs directly from the Processing Status View:

Observability & System Monitoring

To ensure data fidelity and provide transparency, the connector portal includes a robust observability layer for customers and account managers.

  • File-Level Tracking: Every uploaded file (both daily and backfill) is tracked with an explicit state: Pending, Processing, Success, or Failed.
  • Error Logging: In the event of a Failed status, the UI exposes detailed error descriptions, enabling users to quickly identify and remediate formatting or data discrepancies before attempting a re-upload.

Updated on May 7, 2026

Was this article helpful?