Skip to content

G2

G2 is a peer-to-peer review platform for business software and services where users can share real-time reviews.

Bruin supports G2 as a source for Ingestr assets, and you can use it to ingest data from G2 into your data warehouse.

In order to set up G2 connection, you need to add a configuration item in the .bruin.yml file and in asset file.

Follow the steps below to correctly set up G2 as a data source and run ingestion.

Configuration

Step 1: Add a connection to .bruin.yml file

To connect to G2, you need to add a configuration item to the connections section of the .bruin.yml file. This configuration must comply with the following schema:

yaml
    connections:
      g2:
        - name: "my-g2"
          api_token: "YOUR_G2_API_TOKEN"
  • api_token: the API token used for authentication with the G2 API v2

Step 2: Create an asset file for data ingestion

To ingest data from G2, you need to create an asset configuration file. This file defines the data flow from the source to the destination. Create a YAML file (e.g., g2_ingestion.yml) inside the assets folder and add the following content:

yaml
name: public.g2
type: ingestr
connection: postgres

parameters:
  source_connection: my-g2
  source_table: 'reviews'

  destination: postgres
  • name: The name of the asset.
  • type: Specifies the type of the asset. Set this to ingestr to use the ingestr data pipeline.
  • connection: This is the destination connection, which defines where the data should be stored. For example: postgres indicates that the ingested data will be stored in a Postgres database.
  • source_connection: The name of the G2 connection defined in .bruin.yml.
  • source_table: The name of the data table in G2 that you want to ingest. For example, reviews is the table of G2 that you want to ingest. You can find the available source tables in G2 here

Available Source Tables

TablePKInc KeyInc StrategyDetails
productsid-replaceBrowse all G2 products
my_productsid-replaceProducts owned by current account
vendorsidupdated_atmergeList of vendors
categoriesidupdated_atmergeList of categories
category_featuresidupdated_atmergeCategory product features grouped by category
product_featuresidupdated_atmergeProduct features grouped by product
buyer_intentid-replaceBuyer intent interactions per product
competitorsid-replaceCompetitors per product
discussionsid-replaceDiscussions per product
downloadsidupdated_atmergeDownloads per product
integration_reviewsidupdated_atmergeIntegration reviews per product
questionsidupdated_atmergeList of questions
reviewsidupdated_atmergeReviews per product
screenshotsidupdated_atmergeList of screenshots
videosidupdated_atmergeVideos per product

Step 3: Run asset to ingest data

bash
bruin run assets/g2_ingestion.yml

As a result of this command, Bruin will ingest data from the given G2 table into your Postgres database.