Google Cloud Storage

Airbridge supports Google Cloud Storage (GCS) integration. Once set up, you can access raw event data collected by Airbridge SDKs and tracking links in Google Cloud Storage. You can select specific events and properties to send to Google Cloud Storage, and data collected the previous day is sent daily around 7:00 PM UTC.

Attention

For connections created or modified after May 28, 2026, ${VERSION} in the folder path is fixed at 3.0. Existing connections keep their current version as long as you don't change them.

You need permissions to create service accounts, keys, and buckets in Google Cloud Console.

Google Cloud Storage integration takes 4 steps.

1. Connection setup: Enter integration details and test the connection.

2. Event selection: Choose events to send to Google Cloud Storage.

3. Property selection: Choose properties for those events.

4. Review and add: Review your selections and add the connection.

To create a connection, find the following information in Google Cloud Console.

• Client email

• Private key

• Bucket name

Create a service account in Google Cloud Console and download the JSON file to find the client email and private key. The bucket name is set when you create the bucket.

Create a service account and download the JSON file to get the client email and private key.

1. Sign in to Google Cloud Console and select [IAM & Admin].

2. In [Service Accounts], click Create service account.

3. Create the service account.

4. Under the service account's [Actions], click Manage keys.

5. In [Add key], click Create new key and download the file in JSON format. The downloaded JSON file contains the client email (client_email) and private key (private_key).

Create a bucket to receive data from Airbridge and grant access to the service account.

1. In Google Cloud Console, click the navigation menu icon and select [Cloud Storage]>[Buckets].

2. Click Create or Create bucket.

3. Create the bucket. The bucket name is used the same way in the Airbridge dashboard.

4. In the bucket details, go to [Permissions] and click Grant access.

5. In [Add principals], enter the client_email value from the downloaded JSON file as a new principal, without the quotation marks (").

6. Click [Select a role] and assign the role of the newly added principal as [Cloud Storage]>[Storage Object Admin], then save. 

Enter the integration details you got from Google Cloud Console into the Airbridge dashboard.

1. In the Airbridge dashboard, go to [Integrations]>[Third-party Integration] and click Google Cloud Storage.

2. Click Add connection.

3. Enter the client_email value from the downloaded JSON file into [Client Email], and the private_key value into [Private Key], without the quotation marks (").

   Attention

   The private key must include everything from -----BEGIN PRIVATE KEY-----\n to -----END PRIVATE KEY-----\n. If any part is missing, the integration won't work.

4. Enter the bucket name you found in the Google Cloud Console.

5. Choose CSV or Parquet as the integration format and click Submit.

Test whether the information you entered can connect to Google Cloud Storage.

1. In the Airbridge dashboard, click Test connection.

2. If the test succeeds, click Next in the bottom right to move to event selection.

If the test fails, check the information you entered and try again. If you leave the page before completing the test, you'll need to restart the entire integration process.

Select events to send to Google Cloud Storage. You can only select events that Airbridge has collected at least once.

1. Select events from app, web, tracking link categories.

2. Click Next in the bottom right.

Note

Events newly collected after you create the connection won't be sent until you add them manually.

Select properties to send to Google Cloud Storage for the events you chose.

1. Select properties by category.

2. Click Next in the bottom right.

Note

Required properties cannot be deselected.

Review your selected events and properties, then add the connection.

1. Review [Events to send] and [Properties to send]. To make changes, click Edit on the right.

2. Under [Data transfer status], check the transfer status by data source.

3. Click Save connection in the bottom right to create the connection.

You can check data sending status on the following pages in the Airbridge dashboard.

See the table below for the specific meaning of each status message.

Airbridge always sends the previous day's data based on the app's time zone around 7:00 PM UTC. Once you complete the Google Cloud Storage integration, data is delivered to the following paths in your bucket starting the next day.

• App events:

  ${YOUR-BUCKET-NAME}/${YOUR-APP-NAME}/app/${VERSION}/date=${year}-${month}-${day}/

• Web events:

  ${YOUR-BUCKET-NAME}/${YOUR-APP-NAME}/web/${VERSION}/date=${year}-${month}-${day}/

• Tracking link events:

  ${YOUR-BUCKET-NAME}/${YOUR-APP-NAME}/tracking-link/${VERSION}/date=${year}-${month}-${day}/

Sent files contain only the properties you selected. Property changes can reorder columns in the file, so always use column names to identify data.

Attention

For connections created or modified after May 28, 2026, ${VERSION} in the folder path is fixed at 3.0. Existing connections keep their current version as long as you don't change them.

Refer to the sections below to edit or delete your integration.

If your Google Cloud Storage integration details change, follow these steps to update them.

1. In the Airbridge dashboard, go to [Integrations]>[Third-party Integration] and click Google Cloud Storage.

2. Click the connection you want to update.

3. Click the field you want to edit and enter the new value.

4. When done, click Save.

If you change the client email, private key, bucket name, or integration format, you need to test the connection again.

1. In the Airbridge dashboard, go to [Integrations]>[Third-party Integration] and click Google Cloud Storage.

2. Click the delete icon for the connection you want to remove.

3. Enter the confirmation phrase and click Delete.

Deleting a connection stops data transfer immediately. However, data already sent to Google Cloud Storage stays in your bucket.

You can check integration setup status under [Integrations]>[Integration Overview] in the Airbridge dashboard. If an error occurs, see the Check Integration Status guide for resolution steps.

Airbridge supports one cloud storage integration by default. Integrating with more than one storage requires additional charges.

Editing the connection details such as events or properties updates the ${VERSION} in your Google Cloud Storage path to 3.0. Once updated, data can no longer be retrieved from the previous folder path. Check with your internal Google Cloud Storage administrator before switching to the 3.0 path.