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 Streaming into a Google Cloud Storage bucket.


Google Cloud Platform Console

  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": ""


  1. Go to Settings » Project Configuration and click Manage for Real-Time Data Streaming.

  2. Under Real-Time Data Streaming, click Google Cloud Storage.


    Previously configured integrations are listed under Enabled Integrations.

  3. Configure a new Google Cloud Storage integration:

    • Enter a user-friendly name and description.
    • Enter the Bucket Name for the bucket you created in the Google Cloud Platform setup steps above.
    • Paste the JSON-formatted private key in to the Private key in JSON format field.

      Once saved, the private key will not appear again. %%ENCRYPTED%% will appear instead. You can still make changes to the private key by pasting the updated JSON text in to the field.

    • Check the box for gzip if you would like your data compressed to save on storage space.
    • Select the event types that you want to send to Google Cloud Storage.
  4. Click Save.

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.