Connect this destination to export audience membership as CSV files, for use in a bucket you control.

This destination writes to your Google Cloud Storage bucket and is a good fit when you want to:

Use a file export rather than a paid-media or messaging API
Have a GCS bucket and a service account that can write to it

This maps to GrowthLoop Audiences:

Use it for	Audiences
Dropping audience CSVs in a Google Cloud Storage bucket	✓

If Google provisioned a public bucket for Ad Manager audience lists, use Google Ad Manager 360 instead.

Prerequisites

Make sure you have:

A Google Cloud Storage bucket.
A service account with the Editor role on that bucket, and its key saved as a JSON file.

If you already have the JSON key, skip to Set up Google Cloud Storage as a destination.

Create a service account

The service account needs permission to manage the bucket. See Google's service account instructions. Assign the Editor role (one of Google Cloud's Basic Roles).

We recommend creating a new service account for GrowthLoop.

Create a JSON key

JSON keys let GrowthLoop use the service account. Save the file in a secure place. The key is not recoverable. If you lose it, create another. You can have up to 10 keys per service account.

You need administrative privilege over keys for the bucket. If you get a permissions error, ask your Google Cloud administrator to grant key creation access or create the key and send you the JSON.

In Google Cloud, search for your bucket name in the Search bar. If the dropdown says No results, press Enter. The bucket still appears on the next screen.

Select the bucket.

Click Permissions.

Find the service account with storage privileges. Service accounts include gserviceaccount in the Principal column. Copy that name.

Search for Service Accounts and open that page.

Open the service account that matches the name you copied.

Open Keys. Click Add Key → Create New Key.

Select JSON and click Create. The key file downloads to your computer.

Set up Google Cloud Storage as a destination

In GrowthLoop, click the Destinations tab on the left sidebar.
Click New Destination in the upper right corner.
Search for GCS under Buckets and click Add GCS.

Enter the required information, then click Create.

Field	Description
Destination Name	Name this destination in GrowthLoop. Use a name so your team recognizes its purpose, like "Google Cloud Storage Exports".
Sync Frequency	Set the default export frequency (for example, hourly or daily). You can override this setting for individual exports.
Bucket	The name of your Google Cloud Storage bucket.
Credentials	The entire contents of your service account JSON key file.
Columns to Export	Dataset columns to include by default. Use the column names from your warehouse. If you leave this blank, GrowthLoop exports all columns.

GrowthLoop validates the connection. Google Cloud Storage then appears in your list of connected destinations.

Export to Google Cloud Storage

From within GrowthLoop, export from an audience. See Export an audience if you need more information on these steps.

After building or selecting an audience, click Export, then search for your GCS destination.

Configure the export

Setting	Audience export
Export Type	Export All Records writes every audience member on each run. Export Updates (Deltas) writes only members added since the last export.
Personalization Fields	Extra columns for this export. By default, GrowthLoop sends the destination Columns to Export. You can also map custom attributes from the audience.

Export behavior

This is what GrowthLoop writes when you export an audience.

Behavior	What happens
What GrowthLoop writes	CSV files in a folder for that audience in your GCS bucket. Direction is GrowthLoop → Google Cloud Storage.
When it runs	GrowthLoop sends the export as a batch on the next successful run. An export that starts Now runs within about 15 minutes.
Delivery	A folder unique to the audience. That folder contains an individual CSV file for each audience member.
Export All Records	Each run writes a file for every current audience member.
Export Updates (Deltas)	Each run writes files only for new audience members.
Columns to Export	If you set this on the destination, GrowthLoop limits the files to those columns unless you add personalization fields.

Confirm the export was successful

When the run finishes, confirm you can use the data in Google Cloud Storage.

Audience export: Open your Google Cloud Storage bucket, find the folder for that audience, and look up the CSV files inside.

In GrowthLoop, review counts on the audience Exports tab. See Export an audience for more information.

Congrats on successfully exporting to Google Cloud Storage!

Troubleshooting

These are the issues we see most often. You can always email us at [email protected] for help.

Problem	Cause	Resolution
Connection fails to validate	The JSON key is incomplete, or the service account cannot write to the bucket	Paste the entire JSON key. Confirm the service account has the Editor role on the bucket
You cannot create a JSON key	Your user cannot manage keys	Ask a Google Cloud administrator to grant key access or create the key for you
Expected columns are missing	Columns to Export or Personalization Fields omit those columns	Add the columns on the destination or on the export
The files are missing in GCS	You are looking at the bucket root	Open the folder unique to the audience