CSV uploads to cloud storage

You can automatically export your raw user data to cloud storage with Adjust’s CSV uploads. Simply use your dashboard to select the events and define the data points you want to send.

Once you are set up, you will receive hourly CSV uploads to your storage bucket. You can use this raw data to build your own database, analyze your users the way you want, or recall data instantly, without ever having to request Adjust logs.


Use this link to share the video. For instructions on setting up CSV uploads, select your storage provider below. Or, read on for general information and FAQs about Adjust’s CSV uploads.

Format your CSV definition

Your CSV definition determines how your data appears in your CSV files. Each value you enter here will be used to create a column.

A CSV definition consists of 3 elements:

  • Constants: these are static values that will appear—exactly as you enter them—in every row of the resulting CSV file; these are useful for, e.g., internal app IDs.
    • Enter encased in quotation marks: "my constant"
  • Callback parameters (custom app user data): these can be the names of any callback parameters you defined in the Adjust SDK upon integration.
    • Enter encased in square brackets: [callback_parameter]
  • Adjust placeholders: these are dynamic and will be replaced with user data. See the Adjust placeholders page for a complete list of placeholder names.
    • Enter encased in curly brackets: {placeholder}

Arrange constants, callback parameters, and Adjust placeholders to build fully customized export reporting. Simply confirm that each value is separated by a comma, and we will parse your list (from left to right) to create a table.

Any constant, callback parameter or placeholder names must not contain the following special characters (as they are used for parsing): , " [ ] { }.

An example CSV definition would be:

"My app is great",{gps_adid},[user_id],{installed_at},{event_name},[item_number],{reporting_revenue}

This would create a CSV output like this:

"My app is great"{gps_adid}[user_id]{installed_at}{event_name}[item_number]{reporting_revenue}
My app is great25646300-2du4-27sj-e51n-18t84n20000k110492016-04-04T23:16UTCLevel4Complete  
My app is great38400000-8cf0-11bd-b23e-10b96e40000d
My app is great84857208-3if4-36if-e05s-02y77p29411g517592016-12-04T13:54UTCpurchase500coins010$20.00
My app is great84729047-2wf4-94gq-x31k-36u43y849000g200532016-06-01T08:25UTCSign up

Change your storage provider in Adjust

If you want Adjust to upload your CSV files to a different storage provider, follow these steps:

In the Adjust dashboard:

  1. Navigate to your apps and select your app options caret ( ^ ).
  2. Select All Settings > Raw Data Exports > CSV Upload.
  3. Select your new storage provider from the dropdown menu.
  4. Enter your credentials for your new storage provider.
  5. Optional: Edit your events for export and CSV definition.
  6. Select Save.
Adjust can only upload CSV data files to one cloud storage provider at a time. If you change storage providers, Adjust will no longer send CSV uploads to your previous provider.

Set up CSV uploads for subscription events

With CSV uploads, you can automatically export your subscription event raw user data to cloud storage on an hourly basis.

To get set up, add the subscription placeholders you want to include to your CSV definition. Read more about formatting your CSV definition.

In the Adjust dashboard:

  1. Navigate to your app and select your app options caret ( ^ ).
  2. Select All Settings > Raw Data Export > CSV Upload.
  3. Select your preferred upload option.
  4. Select your subscription events from Events for Export.
  5. Enter your updated CSV definition.
  6. Select SAVE.
If you already have Amazon S3 or Google Cloud Storage set up in the Dashboard, when your track subscription with Adjust you automatically receive CSV uploads for your subscription events. You still need to add subscription-related placeholders to your CSV definition to see these specific data points.


How will my CSV file be named?

How often will I receive CSV uploads?