Google Cloud Storage


This integration is maintained by Airship. Please contact Airship for support.

Google Cloud Storage is a secure, cloud-based storage service. The process below explains how to route events from Airship Real-Time Data StreamingA service that delivers engagement events in real time via the Data Streaming API or an Airship partner integration. into a Google Cloud Storage bucket.

GCS Integration Requirements

This integration requires these accounts:

  1. GCS
  2. Airship — Must include both:

Creating a GCS Bucket

  1. Log in to the Google Cloud Platform console.

  2. Create a bucket by following Google’s provided process described here.

  3. Create a JSON Formatted Private Key via the UI following the steps described here.

  4. Download the private key and open the file. You will paste the private key in the next step.

    This is an example of a JSON-formatted private key. REDACTED appears where sensitive information would normally appear.

      "type": "service_account",
      "project_id": "REDACTED",
      "private_key_id": "REDACTED",
      "private_key": "-----BEGIN PRIVATE KEY-----\nREDACTED\n-----END PRIVATE KEY-----\n",
      "client_email": "",
      "client_id": "REDACTED",
      "auth_uri": "",
      "token_uri": "",
      "auth_provider_x509_cert_url": "",
      "client_x509_cert_url": ""

Configuring the GCS Integration

You will need your bucket name and JSON-formatted private key.

In Airship:

  1. Go to Settings » Project Configuration and click Manage for Real-Time Data Streaming.
  2. Under Real-Time Data Streaming, select Google Cloud Storage. Previously configured integrations are listed under Enabled Integrations.
  3. Follow the onscreen instructions to configure the integration. You have the option to compress your data to save on storage space.

Structure and Files

Your bucket’s directory structure and files will be named using the following patterns:

appKey + “/” + integrationId + “/JSON/” + year + “_” + month + “_” + day + “/” + year + “_” + month + “_” + day + “_” + hour + “_” + minute + “_” + second + “.json”

There will be one file generated per hour, assuming a relevant event occurred within that hour.


File size maximum is 15 GB. If the volume of events for an app results in a file exceeding 15 GB, you may instead see multiple files.

Use Cases

Once you have set up your Google Cloud Storage integration, your Airship data will be directed into your storage bucket once per hour. From there, how you use the data is up to you, but some potential ideas are:

  • Output files with user-level send and open information, and import these files into your CRM system.
  • Combine output data with Google Big Query to perform detailed analysis of your users.

Be sure to regularly audit your Airship Google Cloud bucket. Real-Time Data Streaming outputs large amounts of data, which can lead to expensive Google Cloud bills if not managed appropriately.