• English
  • 中文
  • 日本語

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.

How will my CSV file be named?

Adjust uses the following naming convention for CSV files:

  • appToken: Your app token
  • timestamp: The start of the hour (CSV uploads are hourly)
  • hash: A unique hash created from the CSV definition. When you change your CSV definition a new hash and thus new files will be created.
  • partToken: A unique, randomly-generated alphanumeric string

How often will I receive CSV uploads?

Adjust uploads CSV data files to your storage bucket every hour on the hour.

How do I change my storage provider for CSV uploads on 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

Note: Adjust can only upload CSV data files to 1 cloud storage provider at a time. If you change storage providers, Adjust will no longer send CSV uploads to your previous provider.

How do I format my 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 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:54UTCpurcahse500coins010$20.00
My app is great84729047-2wf4-94gq-x31k-36u43y849000g200532016-06-01T08:25UTCSign up