> ## Documentation Index
> Fetch the complete documentation index at: https://docs.segmentstream.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SegmentStream AI Prerequisites

> Prepare your Google Cloud project and GA4 BigQuery export so you are ready to connect to SegmentStream AI when access is granted.

This guide describes the steps you need to complete **before** you can connect to SegmentStream AI. By following these steps now, you will be ready to get started as soon as access is granted to you.

## Overview

To use SegmentStream AI, you need:

1. A Google Cloud project with BigQuery enabled and billing set up.
2. A GA4 BigQuery export configured to send event data to your BigQuery project.

## Step 1. Prepare your Google Cloud project

Follow the steps below to make sure your Google Cloud project is ready.

### 1.1 Create a Google Cloud Platform account

BigQuery is a part of Google Cloud Platform. To use BigQuery you need to have a Google Cloud Platform account.

<Steps>
  <Step title="Navigate to Google Cloud Platform">
    Go to the [Google Cloud Platform page](https://cloud.google.com/) and click **Get started for free**.

    <img src="https://mintcdn.com/segmentstream/ZFr6pt66noWB70nu/images/gcp-get-started.png?fit=max&auto=format&n=ZFr6pt66noWB70nu&q=85&s=c4af58952c9d8f77e8312c2efc92fd2c" alt="Google Cloud Platform get started" width="2392" height="1396" data-path="images/gcp-get-started.png" />
  </Step>

  <Step title="Log in to your Google Account">
    Log in to your Google Account.
  </Step>

  <Step title="Complete registration">
    Fill in the registration form. Provide valid payment details — it's important, as you need an account with an active payment method to use BigQuery.
  </Step>
</Steps>

### 1.2 Set up a billing account

To use BigQuery you need an active billing account so that you'll be able to use Google Cloud Platform resources.

Free Tier Google Cloud accounts don't support some BigQuery services which are required.

#### Upgrading a Free Tier account

Go to the [main page of your Google Cloud Platform](https://console.cloud.google.com/) project and click **ACTIVATE FULL ACCOUNT**.

<img src="https://mintcdn.com/segmentstream/ZFr6pt66noWB70nu/images/gcp-activate-full-account.png?fit=max&auto=format&n=ZFr6pt66noWB70nu&q=85&s=c15cf18540659cd5c9cec1453919103e" alt="Activate full account" width="2880" height="1368" data-path="images/gcp-activate-full-account.png" />

More information on upgrading your account can be found [here](https://cloud.google.com/free/docs/gcp-free-tier#how-to-upgrade).

#### Checking billing account status

If you don't have an **ACTIVATE FULL ACCOUNT** button on the main project page, check that you have an active billing account with a valid payment method:

<Steps>
  <Step title="Go to billing">
    Go to the [Google Cloud Platform Billing page](https://console.cloud.google.com/billing).
  </Step>

  <Step title="Check billing accounts">
    Check that you have at least one billing account with active status.

    <img src="https://mintcdn.com/segmentstream/ZFr6pt66noWB70nu/images/gcp-billing-accounts.png?fit=max&auto=format&n=ZFr6pt66noWB70nu&q=85&s=233a8f886d4db7fdedf293936f8e2d97" alt="Billing accounts" width="1999" height="751" data-path="images/gcp-billing-accounts.png" />
  </Step>

  <Step title="Link billing to project">
    Click on **MY PROJECTS**, and confirm that the billing account is linked to your project. If it isn't linked, click the "more icon" then **Change billing** to link an active billing account.

    <img src="https://mintcdn.com/segmentstream/ZFr6pt66noWB70nu/images/gcp-billing-my-projects.png?fit=max&auto=format&n=ZFr6pt66noWB70nu&q=85&s=a1a383e829f113a013c464abfa880824" alt="Billing my projects" width="2388" height="1040" data-path="images/gcp-billing-my-projects.png" />
  </Step>

  <Step title="Verify account status">
    Click on the account name and follow instructions to set the status to active if it is different.

    <img src="https://mintcdn.com/segmentstream/ZFr6pt66noWB70nu/images/gcp-billing-account-status.png?fit=max&auto=format&n=ZFr6pt66noWB70nu&q=85&s=adf9900362886761ad4d63b30f460364" alt="Billing account status" width="1999" height="930" data-path="images/gcp-billing-account-status.png" />
  </Step>

  <Step title="Validate payment info">
    Validate your payment info (1) and check that you don't have any critical (red) billing health check issues (2).

    <img src="https://mintcdn.com/segmentstream/ZFr6pt66noWB70nu/images/gcp-billing-health-check.png?fit=max&auto=format&n=ZFr6pt66noWB70nu&q=85&s=b8232f0b083124328e12e58c86eac9af" alt="Billing health check" width="1999" height="918" data-path="images/gcp-billing-health-check.png" />
  </Step>
</Steps>

If you experience an issue with setting up a billing account [consult the documentation on billing accounts](https://cloud.google.com/billing/docs/how-to/manage-billing-account).

### 1.3 Create a Google Cloud project

<Steps>
  <Step title="Navigate to Manage resources">
    Navigate to the [Manage resources](https://console.cloud.google.com/cloud-resource-manager?walkthrough_id=resource-manager--create-project) page in the Google Cloud console.
  </Step>

  <Step title="Select organisation">
    On the **Select organisation** drop-down list at the top of the page, select the organisation resource in which you want to create a project. If you are a free trial user, skip this step, as this list does not appear.
  </Step>

  <Step title="Create the project">
    Click **Create Project**. In the **New Project** window that appears, enter a project name and select a billing account as applicable.
  </Step>

  <Step title="Set parent organisation">
    Enter the parent organisation or folder resource in the Location box. That resource will be the hierarchical parent of the new project. If No organisation is an option, you can select it to create your new project as the top level of its own resource hierarchy.
  </Step>

  <Step title="Finish creation">
    When you're finished entering new project details, click **Create**.
  </Step>
</Steps>

## Step 2. Set up GA4 BigQuery export

Once your Google Cloud project is ready, you need to link your Google Analytics 4 property to BigQuery so that event data is exported automatically.

### 2.1 Link your GA4 property to BigQuery

This process must be completed by a user with **Owner** access to the Google Cloud project. The Owner role is assigned to the user who created the project, but you can also grant this permission through the [Google Cloud Project IAM](https://console.cloud.google.com/iam-admin/iam) page.

<Steps>
  <Step title="Select your GA4 property">
    Go to [Google Analytics 4](https://analytics.google.com/) and select the property where your data is collected.
  </Step>

  <Step title="Open Admin settings">
    Click on the **Admin** button.
  </Step>

  <Step title="Navigate to BigQuery links">
    In the **Product Links** section, click **BigQuery links**.

    <img src="https://mintcdn.com/segmentstream/8dSgvo9-hrckH6OT/images/ga4-bigquery-links-page.png?fit=max&auto=format&n=8dSgvo9-hrckH6OT&q=85&s=e5f514519fe194c19a1c325a41745f2b" alt="GA4 BigQuery links page" width="2389" height="2098" data-path="images/ga4-bigquery-links-page.png" />
  </Step>

  <Step title="Configure the BigQuery link">
    1. Click **Link** > **Choose a BigQuery project**.
    2. Select the BigQuery project you created in Step 1.
    3. Select the **Data location** that matches your business's region.
    4. Enable both the **Daily** and **Streaming** export types.
    5. Make sure no events are excluded.
    6. Click **Submit**.

           <img src="https://mintcdn.com/segmentstream/00kzL-5hE2xz3Tg1/images/ga4-bigquery-streaming-export.png?fit=max&auto=format&n=00kzL-5hE2xz3Tg1&q=85&s=be6e29c93070d2b820fee3b3664ca0ee" alt="GA4 BigQuery link setup" width="2118" height="2044" data-path="images/ga4-bigquery-streaming-export.png" />
  </Step>
</Steps>

<Info>
  We recommend enabling both the **Daily** and **Streaming (best-effort)** export types. The daily export provides a complete dataset once per day, while the streaming export ensures near real-time data availability.
</Info>

### 2.2 Verify the export

Once the GA4 BigQuery link is set up, data should start flowing to your BigQuery project within 24 hours. You can verify this by checking your BigQuery project for newly created GA4 event tables.

## What's next

Once you have completed the steps above, your environment is fully prepared. When you receive access to SegmentStream AI, you will be able to connect right away without any additional setup on the Google Cloud or GA4 side.
