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

# Google Analytics

> Connect Google Analytics properties to retailQ

## Installation

We use the Google Analytics BigQuery connector to get access to events tracked by GA4. This gives you detailed access to how your site performs and how your customers interact with it.

Analytics events are only available to us from the date you install the connector.

<Note>
  You will need admin permissions for the Google Analytics property to install
  this connector.
</Note>

<Steps>
  <Step>
    Log in to your [Google Analytics account](https://analytics.google.com).
  </Step>

  <Step>
    [Click
    here](https://analytics.google.com/analytics/web/#/?pagename=admin-integrations-big-query\&utm_source=gahc\&utm_medium=dlinks)
    or navigate to 'Admin' > 'Product Links' > 'BigQuery Links' in the left-hand
    menu.

    <Frame>
      <img src="https://mintcdn.com/retailq/oR3d0Xqo6nYQey07/images/integrations/google-analytics/bigquery-menu.png?fit=max&auto=format&n=oR3d0Xqo6nYQey07&q=85&s=dc6fbf41e18ce4c03b14987a59c2a2b4" alt="Image showing the location of the 'BigQuery Links' menu item" width="2940" height="1600" data-path="images/integrations/google-analytics/bigquery-menu.png" />
    </Frame>
  </Step>

  <Step>
    Click '**Link**'

    <Frame>
      <img src="https://mintcdn.com/retailq/oR3d0Xqo6nYQey07/images/integrations/google-analytics/link-highlight.png?fit=max&auto=format&n=oR3d0Xqo6nYQey07&q=85&s=fb107fb04b1e0764a683b04144ba1349" alt="Image highlighting the location of the link button on the page" width="2238" height="580" data-path="images/integrations/google-analytics/link-highlight.png" />
    </Frame>
  </Step>

  <Step>
    Click '**Choose a BigQuery project**'

    <Frame>
      <img src="https://mintcdn.com/retailq/oR3d0Xqo6nYQey07/images/integrations/google-analytics/create-link.png?fit=max&auto=format&n=oR3d0Xqo6nYQey07&q=85&s=cb716939ba8316c729a40211c84b6914" alt="Image highlighting the location of the 'Choose a BigQuery project' button on the page" width="2352" height="1090" data-path="images/integrations/google-analytics/create-link.png" />
    </Frame>
  </Step>

  <Step>
    Click '**Specify by project ID**'

    <Frame>
      <img src="https://mintcdn.com/retailq/oR3d0Xqo6nYQey07/images/integrations/google-analytics/specify-by-id.png?fit=max&auto=format&n=oR3d0Xqo6nYQey07&q=85&s=42f46cd03f58bc3954ed4d305305ea32" alt="Image highlighting the location of the 'Specify by project ID' button on the page" width="2352" height="128" data-path="images/integrations/google-analytics/specify-by-id.png" />
    </Frame>
  </Step>

  <Step>
    Enter `retailq-ga4-connector` in the 'Bigquery project ID' field, and then click '**Confirm**'

    <Frame>
      <img src="https://mintcdn.com/retailq/oR3d0Xqo6nYQey07/images/integrations/google-analytics/bigquery-id-dialog.png?fit=max&auto=format&n=oR3d0Xqo6nYQey07&q=85&s=ec1fdeadbb41be0eceb42edd6d1ab1db" alt="Image showing the setup dialog completed with the retailq-ga4-connector project ID" width="1222" height="580" data-path="images/integrations/google-analytics/bigquery-id-dialog.png" />
    </Frame>
  </Step>

  <Step>
    Ensure 'Data location' is set to '**United States (us)**'. Click '**Next**'.

    <Frame>
      <img src="https://mintcdn.com/retailq/oR3d0Xqo6nYQey07/images/integrations/google-analytics/data-location.png?fit=max&auto=format&n=oR3d0Xqo6nYQey07&q=85&s=11a26866c56dbbfda62310817fe5dc49" alt="Image highlighting the location of the 'Data location' field on the page" width="2348" height="1376" data-path="images/integrations/google-analytics/data-location.png" />
    </Frame>
  </Step>

  <Step>
    In the 'Event Data' section, select '**Daily**' and '**Streaming (best-effort)**'. In the 'User Data' section, select '**Daily**'. Click '**Next**'.

    <Frame>
      <img src="https://mintcdn.com/retailq/oR3d0Xqo6nYQey07/images/integrations/google-analytics/data-options.png?fit=max&auto=format&n=oR3d0Xqo6nYQey07&q=85&s=af336605b311984ee3d6160b948095e5" alt="Image highlighting the location of the 'Data location' field on the page" width="2322" height="1596" data-path="images/integrations/google-analytics/data-options.png" />
    </Frame>

    <Note>
      Google Analytics should not contain PII data. It does include any PII data by default, and Google policies mandate that you should not send any PII data to GA4 via custom events or dimensions.
    </Note>
  </Step>

  <Step>
    Click '**Submit**'. After a short delay, you should see confirmation that the link was created.

    <Frame>
      <img src="https://mintcdn.com/retailq/oR3d0Xqo6nYQey07/images/integrations/google-analytics/success.png?fit=max&auto=format&n=oR3d0Xqo6nYQey07&q=85&s=98eeeede19298387da04406e5083b6ee" alt="Successfully created the link" width="2352" height="792" data-path="images/integrations/google-analytics/success.png" />
    </Frame>
  </Step>
</Steps>

It will take at least 24 hours for Google to start streaming data to retailQ, so if you don't see your data after 36 hours, please [contact support](/support).

## Troubleshooting

<AccordionGroup>
  <Accordion title="I have over 1 million daily events.">
    Even if you have over 1 million daily events, we should receive most of them. Google sends events during the day, which are unlimited. It also sends events at the end of each day, which is limited to 1 million events if you have not upgraded to a GA360 plan.

    If you see a warning that you will exceed the events threshold, [contact support](/support) and we can advise you.
  </Accordion>

  <Accordion title="I already have a BigQuery connection and cannot add more.">
    We can use a different, less accurate and less granular method to load your data. Please [contact support](/support) and we can advise you, or connect to your existing BigQuery dataset directly.
  </Accordion>
</AccordionGroup>