Skip to main content

BigQuery: Connection guide

How to connect BigQuery data to Funnel with a data request, including project access and SQL query details.

How to get these dimensions and metrics in your workspace?

What do you need?

Submit a data request. See Request new data in Funnel.

  • Business or Enterprise plan

  • Include the following information in your data request: + Data source origin (for example, Shopify Orders or Internal Enrollment) + Project name (the Google Cloud project where your database or dataset is hosted) + Full explicit SQL query for the data you want to import — avoid SELECT *

Grant Funnel access to your database

To allow Funnel to connect and retrieve data from your database, grant access to our service account:

​

  • Service Account:funnel-customs-account@funnel-customs.iam.gserviceaccount.com

  • Required Role:BigQuery Job User (includes the bigquery.jobs.create permission)

​

If your system requires IP allow listing, reach out via support.

​

This will allow Funnel to securely connect to and query your database.

​

Share access details securely

Once access has been granted, share the following information via your data request:

​

  • Confirmation that the Funnel service account has access

  • The SQL query you’d like to run

  • Any additional connection or authentication details (if applicable)

​

You can securely provide these details by visiting your data request Status page and selecting Add Credentials for your request.

​

Example SQL query:

SELECT campaign_id, campaign_name FROM `dataset.table`

Avoid using SELECT * — specifying only the required fields ensures better performance and clarity.

​

Confirmation and testing

Once we’ve received your details and verified access, our team will:

​

  1. Test the connection to your database

    ​

  2. Validate your query and data structure

    ​

  3. Set up your data request

​

Each SQL query you provide will be treated as its own data source within Funnel. If you require multiple datasets, submit a separate query for each one.

​

Helpful resources

Did this answer your question?