Set up cloud storage uploads

You can automatically export your raw user data to Amazon S3 or Google Cloud Storage as CSV files. Once you are set up, you can use this data to build your own database, perform detailed analysis, or recall data instantly without ever having to request Adjust logs.

Before you begin

Here's what you need to know before getting started.

Requirements

Choose your storage provider

  1. Access the cloud storage upload setup from your app card or from the Data management tab of your app setup.
    • (Admin, Editor, or Custom Editor permissions only) To set up cloud storage upload from the app card, under AppView, select All apps. Find your app and select Cloud storage upload.
    • To set up cloud storage upload from the Data management tab of your app setup, under AppView, select All apps. Select your app, and then select the Data management tab. Under Cloud storage upload, select Set up cloud storage.
  2. In the Storage provider list, select your cloud storage provider, and provide the following details:
    • Amazon S3 - Access key ID, Secret access key, Bucket name
    • Google Cloud Storage - Service Account Key credential file (JSON file created in the Google Cloud Console), Bucket name

Choose data to send

Under Sending data, choose the data and events that you want to send to your storage provider.

  1. Manage whether to continue or stop receiving cloud storage uploads using the Live and Pause controls.
  2. Under Triggers you can choose the events that you want Adjust to send data to your bucket for. You can select from all available activities, and any events you have set up for your app.

Available triggers

Format CSV definition

Under Format your CSV, determine how data appears in your CSV files. Each value you enter here will be used to create a column in the CSV file. Arrange constants, callback parameters, and Adjust placeholders to build fully customized export reporting. Your CSV format 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. Constants are useful for including important data to help with analysis, for example internal app IDs. "Null" is not allowed.
  • Parameters: These are for custom app user data, and can be the names of any callback parameters you defined in the Adjust SDK upon integration.
  • Placeholders: These are dynamic and will be replaced with user data. See the Adjust placeholders page for a complete list of placeholder names.

The values you enter should not contain the following special characters as they are used for parsing: , " [ ] { }.

Once you save your cloud storage settings in Adjust and set it to Active, Adjust uploads CSV data files to your storage bucket every hour on the hour.