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

# Integrate with Google Analytics

> Set up Google Analytics tracking on your Readdy website to monitor visitor behavior, traffic sources, and performance metrics

Google Analytics is a powerful, free web analytics tool that helps you understand your website visitors and their behavior. By integrating it with your Readdy website, you can track page views, user demographics, traffic sources, and much more.

<Info>
  Google Analytics provides valuable insights that can help you improve your website's performance and better understand your audience.
</Info>

## Why Use Google Analytics?

* **Track visitor behavior**: See which pages are most popular
* **Understand your audience**: Learn about visitor demographics and interests
* **Monitor traffic sources**: Discover how visitors find your website
* **Measure conversions**: Track goals and important user actions
* **Free and comprehensive**: Industry-standard analytics at no cost

## If you're new to Google Analytics (GA)

<Steps>
  <Step title="Step 1: Start Setup">
    Go to the [Google Analytics platform](https://analytics.google.com) and click **"Start measuring"** to begin setup.

    <Frame>
      <img src="https://mintcdn.com/readdy/7CjKFJLvlZkkuEbB/images/ga-start-measuring.png?fit=max&auto=format&n=7CjKFJLvlZkkuEbB&q=85&s=e082c118b2be65e36e53e687de5cc2fc" width="1280" height="735" data-path="images/ga-start-measuring.png" />
    </Frame>
  </Step>

  <Step title="Step 2: Configure Account">
    Follow the setup steps to configure your GA account.

    <Frame>
      <img src="https://mintcdn.com/readdy/7CjKFJLvlZkkuEbB/images/ga-account-setup.png?fit=max&auto=format&n=7CjKFJLvlZkkuEbB&q=85&s=6de13d93d1c8a157b9382d59729d66f2" width="1280" height="734" data-path="images/ga-account-setup.png" />
    </Frame>
  </Step>

  <Step title="Step 3: Select Platform">
    When you reach "Data Collection", select **"Web"** as your platform type.

    <Info>
      Note: Readdy currently only supports website projects.
    </Info>

    <Frame>
      <img src="https://mintcdn.com/readdy/7CjKFJLvlZkkuEbB/images/ga-select-web.png?fit=max&auto=format&n=7CjKFJLvlZkkuEbB&q=85&s=a9b3c648685827ba648823b9f02b690f" width="3456" height="1984" data-path="images/ga-select-web.png" />
    </Frame>
  </Step>

  <Step title="Step 4: Set Up Data Stream">
    Enter your **published domain** and give your Data Stream a name. Then click **"Create and Continue"**.

    <Frame caption="Make sure your project domain is successfully published.">
      <img src="https://mintcdn.com/readdy/7CjKFJLvlZkkuEbB/images/ga-domain-setup.png?fit=max&auto=format&n=7CjKFJLvlZkkuEbB&q=85&s=73c7a8701891d83c3d0701f20a0bdd32" width="1280" height="681" data-path="images/ga-domain-setup.png" />
    </Frame>

    <br />

    <Frame caption="Enter your domain and stream name.">
      <img src="https://mintcdn.com/readdy/7CjKFJLvlZkkuEbB/images/ga-stream-name.png?fit=max&auto=format&n=7CjKFJLvlZkkuEbB&q=85&s=ec85015fda3d34b55e6a8e7300548771" width="3456" height="1842" data-path="images/ga-stream-name.png" />
    </Frame>
  </Step>

  <Step title="Step 5: Connect to Readdy">
    A popup will appear with your Google tag. Copy the code and paste it into the input field in Readdy. Click **"Connect"** to generate a new version. Don't forget to re-publish your domain afterwards.

    <Frame caption="Copy code">
      <img src="https://mintcdn.com/readdy/7CjKFJLvlZkkuEbB/images/ga-copy-code.png?fit=max&auto=format&n=7CjKFJLvlZkkuEbB&q=85&s=b00a0c8216b6ca535ca4a56a53ce0acf" width="1280" height="681" data-path="images/ga-copy-code.png" />
    </Frame>

    <br />

    <Frame caption="Paste code">
      <img src="https://mintcdn.com/readdy/7CjKFJLvlZkkuEbB/images/ga-paste-code.png?fit=max&auto=format&n=7CjKFJLvlZkkuEbB&q=85&s=067c615e2d2e2650fef765d8f04f423f" width="1280" height="800" data-path="images/ga-paste-code.png" />
    </Frame>

    <br />

    <Frame caption="Re-publish your site">
      <img src="https://mintcdn.com/readdy/7CjKFJLvlZkkuEbB/images/ga-republish.png?fit=max&auto=format&n=7CjKFJLvlZkkuEbB&q=85&s=ed5a8f01e36115237b4acff701f1c99f" width="1280" height="680" data-path="images/ga-republish.png" />
    </Frame>
  </Step>

  <Step title="Step 6: Test Connection">
    Back in GA, click **"Test installation"** to check if the connection is working.

    <Frame caption="Test installation in GA">
      <img src="https://mintcdn.com/readdy/7CjKFJLvlZkkuEbB/images/ga-test-installation.png?fit=max&auto=format&n=7CjKFJLvlZkkuEbB&q=85&s=62f0e76ab729f090e409543921b18fd3" width="1280" height="682" data-path="images/ga-test-installation.png" />
    </Frame>

    <br />

    <Frame caption="🎉 Successfully connected to Google Analytics">
      <img src="https://mintcdn.com/readdy/7CjKFJLvlZkkuEbB/images/ga-success.png?fit=max&auto=format&n=7CjKFJLvlZkkuEbB&q=85&s=fe9109105574d01a9eb5f9be1295734c" width="1280" height="790" data-path="images/ga-success.png" />
    </Frame>
  </Step>

  <Step title="Step 7: View Reports">
    Once connected, GA will start collecting user data from your site. You can view reports under the **"Reports"** tab later.

    <Frame>
      <img src="https://mintcdn.com/readdy/7CjKFJLvlZkkuEbB/images/ga-reports.png?fit=max&auto=format&n=7CjKFJLvlZkkuEbB&q=85&s=4fba36cee4f5d20066b49f8300695e20" width="1280" height="710" data-path="images/ga-reports.png" />
    </Frame>
  </Step>
</Steps>

## If you already have a Data Stream in GA

<Steps>
  <Step title="Step 1: Access Admin Panel">
    Log into GA, go to your property's **Admin panel**.

    <Frame>
      <img src="https://mintcdn.com/readdy/7CjKFJLvlZkkuEbB/images/ga-admin-panel.png?fit=max&auto=format&n=7CjKFJLvlZkkuEbB&q=85&s=4699a28116d8d928b494cce448323630" width="1280" height="709" data-path="images/ga-admin-panel.png" />
    </Frame>
  </Step>

  <Step title="Step 2: Navigate to Data Streams">
    Under **Property Settings** > **Data collection and modification**, select **"Data Streams"**.

    <Frame>
      <img src="https://mintcdn.com/readdy/7CjKFJLvlZkkuEbB/images/ga-data-streams.png?fit=max&auto=format&n=7CjKFJLvlZkkuEbB&q=85&s=bca1d27d73f1cf540b1428573b7fe49e" width="1280" height="708" data-path="images/ga-data-streams.png" />
    </Frame>
  </Step>

  <Step title="Step 3: Choose Data Stream">
    **If you already have a Web Data Stream**, select it.

    <Frame>
      <img src="https://mintcdn.com/readdy/7CjKFJLvlZkkuEbB/images/ga-select-stream.png?fit=max&auto=format&n=7CjKFJLvlZkkuEbB&q=85&s=9da05d6acabb669f8260a73038811d82" width="1280" height="709" data-path="images/ga-select-stream.png" />
    </Frame>

    **If no existing Data Stream is available**, click **"Web"** to create one. Follow the steps from Step 4 to Step 6 in the "New to GA" section.

    <Frame>
      <img src="https://mintcdn.com/readdy/7CjKFJLvlZkkuEbB/images/ga-create-web-stream.png?fit=max&auto=format&n=7CjKFJLvlZkkuEbB&q=85&s=05f22d15be990311b8d56a6158d5ea8c" width="1280" height="709" data-path="images/ga-create-web-stream.png" />
    </Frame>
  </Step>

  <Step title="Step 4: Access Google Tag">
    In the Google tag section, click **"View tag instructions"**.

    <Frame>
      <img src="https://mintcdn.com/readdy/7CjKFJLvlZkkuEbB/images/ga-view-tag-instructions.png?fit=max&auto=format&n=7CjKFJLvlZkkuEbB&q=85&s=d2be926a8fa7589f0b2c43fbe18c92dc" width="1280" height="708" data-path="images/ga-view-tag-instructions.png" />
    </Frame>
  </Step>

  <Step title="Step 5: Get the Code">
    Switch to the **"Install manually"** tab and copy the Google code.

    <Frame>
      <img src="https://mintcdn.com/readdy/7CjKFJLvlZkkuEbB/images/ga-install-manually.png?fit=max&auto=format&n=7CjKFJLvlZkkuEbB&q=85&s=95312c98a79f478561fcfdf6a3959d02" width="1280" height="809" data-path="images/ga-install-manually.png" />
    </Frame>
  </Step>

  <Step title="Step 6: Connect to Readdy">
    Go back to Readdy, paste the code into the input field, and click **"Connect"**. A new version connected to GA will be created.

    <Warning>
      Remember to re-publish your site so GA can start tracking your user data.

      <Frame>
        <img src="https://mintcdn.com/readdy/7CjKFJLvlZkkuEbB/images/ga-republish-warning.png?fit=max&auto=format&n=7CjKFJLvlZkkuEbB&q=85&s=b84d06a178fbd5c7e7777bd99a6e4387" width="1280" height="800" data-path="images/ga-republish-warning.png" />
      </Frame>
    </Warning>
  </Step>
</Steps>

## After Integration

### Viewing Your Analytics Data

<Tip>
  Once connected, Google Analytics will start collecting user data from your site. You can view comprehensive reports under the **"Reports"** tab in your GA dashboard.
</Tip>

### What You Can Track

* **Real-time visitors**: See who's on your site right now
* **Page views**: Most and least popular pages
* **User demographics**: Age, location, and interests
* **Traffic sources**: Search engines, social media, direct visits
* **User behavior**: How visitors navigate through your site

## Troubleshooting

<Accordion title="Analytics Not Working?">
  **Common solutions:**

  1. **Check if you republished**: Analytics won't work until you republish your site after connecting
  2. **Verify the code**: Make sure you copied the complete Google tag code
  3. **Wait for data**: It can take 24-48 hours for data to appear in GA
  4. **Test installation**: Use the "Test installation" feature in Google Analytics
  5. **Check domain**: Ensure your domain is correctly published and accessible

  If issues persist, contact our support team for assistance.
</Accordion>

<Accordion title="Multiple Websites Setup">
  If you have multiple websites, you can:

  1. **Create separate data streams** for each domain in the same GA property
  2. **Use different GA properties** for completely separate tracking
  3. **Set up cross-domain tracking** if the sites are related

  Choose the approach that best fits your analytics needs.
</Accordion>