Google BigQuery Connection

What:  The Google BigQuery connection allows customers to synchronize data between Google BigQuery and BlueConic. The connection supports batch import and export. Data coming from BigQuery can be mapped to profile properties.

About BlueConic: BlueConic is a Customer Data Platform that harnesses the data required to power the recognition of an individual at each interaction, and then synchronizes their intent across the marketing ecosystem. Learn more about BlueConic.

Why: By retrieving data from BigQuery, you can enrich your customer data in BlueConic. This data can then be used to synchronize to other systems, for example for retargeting, recommendations or on-site or email personalizations.

Two ways to connect to Google BigQuery

BlueConic offers two ways to synchronize your data with Google BigQuery:

  • Use the instructions below to exchange profile data via batch import or export with Google BigQuery.
  • To export a large amount of data in real time to Google Cloud, or to stream BlueConic events, use the Google Cloud Pub/Sub connection and follow the use case instructions for exporting your data to Google BigQuery using a firehose connection.


Adding a Google BigQuery connection

  1. Click Connections in the Navigation bar.
  2. Click Add Connection.
  3. A pop-up window appears. Check the Show all box. Enter “BigQuery” in the Search bar.

    Click Google BigQuery connection.

  4. The Google BigQuery Connection page opens.

    You can expand or collapse metadata fields (favorite, labels, and description) by clicking the gray + or .

Configuring a Google BigQuery connection


You have the option to use an existing service account, or to create a new service account specifically for BlueConic access via Create service account.

Make sure to assign a BigQuery Data Viewer or Admin role to the service account you use. For existing accounts you can assign roles via a 'Permissions'.

To authenticate the BlueConic connection with Google BigQuery, you will need to generate a service account key in Google BigQuery.

  1. Open the Google Cloud Platform Console.
  2. Select the BigQuery project you want to connect to in the top header.
  3. Click the Products & services hamburger menu in the upper left corner.
  4. Click IAM & admin.
  5. Click Service Accounts.
  6. Click behind the account you want to use for BlueConic.
  7. Click Create Key.

  1. Click key type JSON.
  2. Click Create to download the private key file to your computer.

  1. In the BlueConic connection, click select from your computer and select the private key file.

  1. Click Save on the top right corner to save your authentication information.

Import goals

Click Add goal and select Import goal to to import data from Google BigQuery, you need to compose a query (or select an existing one) that will gather the data for BlueConic to import.

  1. Open Google BigQuery.
  2. Click Compose to compose your query.
  3. Click Save Query and provide a name.

In the BlueConic import goal you can now select this information

  1. Select the Google BigQuery Dataset that holds the query. Select the name of the query Table to import data from.
  2. Link identifiers between Google BigQuery and BlueConic to link data rows from the query to BlueConic profiles.

    Select a data field and a BlueConic profile property from the drop-down lists to link together (for example, the BlueConic profile identifier). Optional: Allow the connection to create new BlueConic profiles if no match is found.

  3. Map the Google BigQuery data you want to import into BlueConic.

    Select a data field from the drop-down list and select the BlueConic profile property it populates by entering a search term.

    Select how to import the data from the drop-down list:

    • Set
    • Set if empty
    • Add the data field to the list of existing values
    • Sum a number with the existing values (if the data field is a number)

    Click Save on the top right corner of the screen to save your import goal.

    Optional: In the left panel, click Add goal and then Import goal to create another Import goal.

Export goals

Click Add goal and select Export goal to export data to Google BigQuery. Follow the steps to configure the export goal.

  1. Select the BlueConic segment of profiles that you would like to export.
  2. Select the Google BigQuery Dataset and Table name where you want to store exported data. Choose whether you want to replace the table on every run, or if you want to add a partition to the table every run.
  3. Select the BlueConic data that you want to export by mapping profile properties to the fields of the Google BigQuery table.

    Click the BlueConic icon to open a drop down menu where you can select the type of information you want to export. Pick one of:

    • BlueConic profile identifier: The unique identifier for a profile
    • Associated segments: All segments, or a selection of one or more specific segments that the profile is associated with
    • Profile property: The value of a specific profile property
    • All viewed interactions (all time): The interactions that the profile has seen
    • Permission level: The permission level set in the profile
    • Text value: Enter any static text
  4. Select Add mapping or Add multiple mappings to add one or more mappings.
    Optional: In the left panel, select Add goal and then Export goal to create another Export goal.

Privacy management

Connections can be added to Objectives, allowing for privacy management of the information that is being picked up. A connection will only process the profiles of visitors who have consented to at least one of the objectives that the connection is linked to.