> ## 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

## 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>
