Skip to main content

Google Cloud Storage

Adapty UA's integration with Google Cloud Storage allows you to store user acquisition campaign data securely in one central location. You will be able to save your campaign performance data, attribution data, and user acquisition events to your Google Cloud Storage bucket as .csv files.
To set up this integration, you will need to follow a few simple steps in the Google Cloud Console and Adapty UA Dashboard.

note

Schedule

Adapty UA sends your data to Google Cloud Storage every 24h at 4:00 UTC.

Each file will contain data for the events created for the entire previous calendar day in UTC. For example, the data exported automatically at 4:00 UTC on March 8th will contain all the events created on March 7th from 00:00:00 to 23:59:59 in UTC.

How to set up Google Cloud storage integration​

Step 1. Create Google Cloud Storage credentials​

This guide will help you create the necessary credentials in your Google Cloud Platform Console.

In order for Adapty UA to upload raw data reports to your designated bucket, the service account's key is required, as well as write access to the corresponding bucket. By providing the service account's key and granting write access to the bucket, you allow Adapty UA to securely and efficiently transfer the raw data reports from its platform to your storage environment.

warning

Please note that we only support Service Account HMAC key authorization, means it's essential to ensure that your Service Account HMAC key has the "Storage Object Viewer", "Storage Legacy Bucket Writer" and "Storage Object Creator" roles added to it to enable proper access to Google Cloud Storage.

2.1. Create Service Account​

  1. Go to the IAM section of your Google Cloud account and choose the relevant project or create a new one
  1. Next, create a new service account for the Adapty UA by clicking on the "+ CREATE SERVICE ACCOUNT" button
  1. Fill out the fields in the first step, as access will be granted at a later stage. In order to read more details about this page read the documentation here
  1. To create and download a private JSON key, navigate to the KEYS section and click on the "ADD KEY" button
  1. In the DETAILS section, locate the Email value linked to the recently created service account and make a copy of it. This information will be necessary for the upcoming steps to authorize the account and allow it to write to the bucket

2.2. Configure Bucket Permissions​

  1. Go to the Google Cloud Storage's Buckets page and either select an existing bucket or create a new one to store the User Acquisition Data reports from Adapty UA
  2. Navigate to the PERMISSIONS section and select the option to GRANT ACCESS
  1. In the PERMISSIONS section, input the Email of the service account obtained in the fifth step mentioned earlier, then choose the Storage Object Creator role
  2. Finally, click on SAVE to apply the changes

  1. Remember to keep the name of the bucket for future reference

  2. After passing these steps have successfully completed the necessary setup steps in the Google Cloud Console! The final step involves entering the bucket's name and downloading the JSON file for use in Adapty UA

Step 2. Configure integration in Adapty UA​

  1. Go to Integrations -> Google Cloud Storage
  2. Turn on the Export install events to Google Cloud Storage toggle
  3. Fill out the required fields to build a connection between Google Cloud Storage and Adapty UA:
FieldDescription
Google Cloud service account key fileThe downloaded private JSON key file.
Google Cloud bucket nameThe name of the bucket in Google Cloud Storage where you want to store your data. It should be unique within the Google Cloud Storage environment and should not contain any spaces.
Folder inside the bucketThe name of the folder inside the bucket where you want to store your data. It should be unique within the bucket and can be used to organize your data. This field is optional to fill.

Manual data export​

In addition to the automatic event data export to Google Cloud Storage, Adapty UA also provides a manual file export functionality. With this feature, you can select a specific date for the user acquisition data and export it to your GCS bucket manually. This allows you to have greater control over the data you export and when you export it.