Google Cloud Platform (GCP)

Set up Google Cloud Storage (GCS) Integration

Note: This guide outlines a reference configuration; specific steps may vary due to provider updates or your organization's security policies. Please share feedback if you encounter any discrepancies that prevent a successful setup.

Set up Google Cloud Storage (GCS) Integration

To enable Open Loyalty to export data directly to your Google Cloud environment, you must create a specific Bucket and a Service Account with the appropriate write permissions.

Prerequisites

• A Google Cloud Platform account with administrative access.

• An active Project (or the ability to create a new one).

1. Create a New GCS Bucket

1

Log in to the Google Cloud Console.

2

Select an existing Project from the top dropdown menu, or create a New Project.

3

In the left-hand navigation menu, navigate to Storage → Cloud Storage → Buckets.

4

Click + Create

5

Configure the bucket with the following settings:

• Name your bucket: Enter a globally unique name (lowercase, no spaces).

  • Example: ol-data-export-bucket

• Location type: Select Region.

• Location: Choose the region closest to your operations.

• Default storage class: Select Standard.

• Access control: Select Uniform (Recommended).

6

Scroll down and click Create.

2. Create a Service Account

To allow Open Loyalty to send files to your bucket, a service account with a specific private key is required.

1

In the left-hand menu, navigate to IAM & Admin → Service Accounts.

2

Click + Create Service Account.

3

Service account details:

• Service account name: Enter a recognizable name (e.g., storage-uploader).

• Click Create and continue.

4

Grant this service account access to project:

• Click the Select role field.

• Search for and select: Storage → Storage Object Admin.

Note: This specific role is required as it allows uploading (writing) new objects to the bucket.

• Click Continue, then click Done.

3. Generate the JSON Key

1

In the Service Accounts list, click on the newly created service account (e.g., storage-uploader).

2

Navigate to the Keys tab.

3

Click Add key → Create new key.

4

Select JSON as the key type and click Create.

5

A .json key file will automatically download to your computer.

4. Submit Configuration to Open Loyalty

Once the configuration is complete, you must share the credentials with the Open Loyalty team.

Do not send the JSON file directly via email.

1

Upload the .json file (or paste its contents) to a secure file exchange platform (e.g., Bitwarden Send, Proton Drive, or 1Password).

2

Generate a secure link.

3

Send the link to the Open Loyalty team.