> ## Documentation Index
> Fetch the complete documentation index at: https://help.airbridge.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<Danger>
  **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.
</Danger>

## Before you begin

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.

## Step 1: Connection setup

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 in Google Cloud Console

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 in Google Cloud Console

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 integration details in Airbridge

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 (`"`).

<Danger>
  **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.
</Danger>

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 the connection

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.

## Step 2: Select events to send

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.

<Info>
  **Note**

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

## Step 3: Select properties to send

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.

<Info>
  **Note**

  Required properties cannot be deselected.
</Info>

## Step 4: Review and add the connection

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.

## Check data sending status

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

| Page                                      | Location                                                                                | Information available                                                                         |
| ----------------------------------------- | --------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| Google Cloud Storage integration settings | Go to **\[Integrations]>\[Third-Party Integration]** and click **Google Cloud Storage** | - Status message per connection<br />- Number of events sent<br />- Number of properties sent |
| Google Cloud Storage connection summary   | Click a connection on the Google Cloud Storage integration settings page                | - Status message per data source<br />- Transfer path per data source                         |
| Integration Overview                      | Go to **\[Integrations]>\[Integration Overview]** and click **Google Cloud Storage**    | - Integration setup status<br />- Data transfer status                                        |

### Data sending status messages

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

| Status message | Description                                                     |
| -------------- | --------------------------------------------------------------- |
| Waiting        | Integration is set up and waiting for the first data transfer.  |
| Success        | The previous day's data was sent successfully.                  |
| Error          | Data transfer failed due to integration errors or other issues. |
| No Data        | Integration is active, but there's no data to send.             |

## Find your data in cloud storage

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.

<Danger>
  **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.
</Danger>

## Manage integration

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

### Edit Google Cloud Storage 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.

### Delete a Google Cloud Storage connection

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.

### Resolve integration errors

You can check integration setup status under **\[Integrations]>\[Integration Overview]** in the Airbridge dashboard. If an error occurs, see the [Check Integration Status](/en/guides/integration-overview#resolve-error) guide for resolution steps.

## Important notes

### Number of cloud storage integrations

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

### Editing a connection updates the folder path

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.

<link rel="alternate" hrefLang="en" href="https://help.airbridge.io/en/guides/google-cloud-storage" />

<link rel="alternate" hrefLang="ko" href="https://help.airbridge.io/ko/guides/google-cloud-storage" />