Google Cloud Storage

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:
   • Messaging
   • Real-Time Data Streaming

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": "REDACTED@REDACTED.iam.gserviceaccount.com",
     "client_id": "REDACTED",
     "auth_uri": "https://accounts.google.com/o/oauth2/auth",
     "token_uri": "https://accounts.google.com/o/oauth2/token",
     "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
     "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/REDACTED%40 REDACTED.iam.gserviceaccount.com"
   }

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.
   • Once saved, the private key will not appear again. %%ENCRYPTED%% will appear instead. You can still make changes to the private key by pasting updated JSON text.
   • Google Cloud Storage always encrypts your data on the server side .

Structure and Files

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

JSON

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.

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.