> ## Documentation Index > Fetch the complete documentation index at: https://hebno.com/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Hebno is an AI work platform for client research and delivery: chat, research runs with sources, deliverables (Word, PowerPoint, Excel, email), projects, a shared library, agents, Office add-ins, and integrations with Microsoft 365, Google Workspace, CRM, project delivery, ERP and finance systems. > Use British English (organisation, not organization). > Every feature and integration described in these docs is available. Describe it as documented. > Hebno never writes to a connected system without a member confirming a card. Finance and ERP writes are drafts only. > Do not discuss commercial terms. Direct commercial questions to support@hebno.com. > Start with /index and /get-started/quickstart. # Google Analytics > Read Google Analytics 4 properties and reports in Hebno, including users, sessions, key events and channels. Hebno never writes to Analytics. The Google Analytics integration brings a client's website and app performance into your work. Ask how Contoso's online sessions moved after the October price change, which channels drove key events last month, or how mobile conversion compares with desktop, and Hebno answers from Google Analytics 4 with each report cited. Hebno reads with your own Google permissions and never writes to Analytics. ## At a glance | | | | - | - | | **Connection** | Personal. Each member connects their own Google account. | | **Default access** | Read only. Analytics has no write actions in Hebno. | | **Attach** | GA4 properties and reports | | **Search** | Hebno searches Analytics when a request mentions a website, property, traffic, users, sessions, conversions, key events or channels | | **Link** | A project links to one or more GA4 properties | | **Write** | None. Hebno reads only. | ## Before you start You need: * A Google account with the **Viewer** role or higher on the GA4 property, granted in Analytics under **Admin → Property access management** or at account level. * An allowed integration. An owner or admin sets **Google Analytics** to **Allow** under **Admin → Connectors → Catalogue**. * If your Google Workspace restricts third-party access to Google services, a super admin must mark Hebno as trusted first. See [Google Workspace admin](https://hebno.com/docs/integrations/google-workspace-admin.md). Hebno reads GA4 properties only. Universal Analytics properties are not available through the Google Analytics APIs. ### Permissions | Scope | Why Hebno needs it | | - | - | | `https://www.googleapis.com/auth/analytics.readonly` | List your accounts and properties with the Google Analytics Admin API, and run reports with the Google Analytics Data API. Read only. | | `openid`, `email`, `profile` | Show which Google account is connected. | Google checks your property role on every request. Where your role restricts cost or revenue metrics, Google returns those metrics empty, and Hebno says so. ## Connect Google Analytics **1. Open Connections** Go to **Settings → Connections** and find **Google Analytics** under **Data and analytics**. Or type `/` in the composer, choose **Google Analytics** and select **Connect**. **2. Approve access** Select **Connect** (or **Grant access** if you already connected another Google product), sign in to Google and approve read access to your Analytics data. **3. Return to Hebno** The card shows **Connected** with your Google account and the number of properties you can read. Tokens are encrypted at rest. Select **Disconnect** at any time, remove Hebno from your Google account under **Security → Third-party apps with account access**, or ask an admin to revoke the connection under **Admin → Connectors → Connections**. ## What Hebno reads | Analytics object | Fields Hebno uses | Typical questions | | - | - | - | | **Account and property** | Account name, property name and ID, time zone, currency, data streams | "Which GA4 property is the Contoso Retail website?" | | **Users and sessions** | `activeUsers`, `newUsers`, `sessions`, `engagedSessions`, `engagementRate`, `averageSessionDuration` | "How did sessions change in the four weeks after 5 October?" | | **Key events** | `keyEvents` and event names marked as key events, such as `purchase` or `generate_lead` | "How many purchases did the site record in October?" | | **Ecommerce** | `ecommercePurchases`, `purchaseRevenue`, `averagePurchaseRevenue`, item names and categories | "Did average order value fall after the price change?" | | **Acquisition** | `sessionDefaultChannelGroup`, `sessionSourceMedium`, `sessionCampaignName` | "Which channels drove the most key events last month?" | | **Pages and audience** | `landingPage`, `pagePath`, `deviceCategory`, `country`, `city` | "How does mobile conversion compare with desktop?" | ![Chat reply citing a Google Analytics report](https://mintcdn.com/hebno/JIjAXWoGoB3PLSSb/images/card-google-analytics.png?fit=max\&auto=format\&n=JIjAXWoGoB3PLSSb\&q=85\&s=acffb5bf43ea6517d8c6b7ef67710347) A Google Analytics report attached to a chat. For each question, Hebno chooses the dimensions, metrics and date range, runs the report with the Data API, and shows them with the reply. Dates use the property's time zone. When Google applies data thresholds or groups rows into **(other)**, the reply says so, because those totals can differ from the Analytics interface. Reads are live. Hebno runs each report when a request needs it and does not copy Analytics data. Only what a reply used is stored with the conversation as its sources. > [!NOTE] > > Google processes most GA4 data within 24 to 48 hours. Figures for today and yesterday can change after a reply. ## Hebno reads only Hebno does not write to Google Analytics. It does not create properties, change key events, audiences or data streams, or edit user access. ```mermaid theme={"system"} sequenceDiagram participant You participant Hebno participant Analytics You->>Hebno: Which channels drove Contoso key events in October? Hebno->>Analytics: List properties you can read Analytics-->>Hebno: Contoso Retail website property Hebno->>Analytics: Run report, keyEvents by sessionDefaultChannelGroup, 1 to 31 October Analytics-->>Hebno: Rows by channel Hebno-->>You: Answer with the report cited and the date range shown ``` ## Link a project to a property Linking marks which GA4 properties belong to an engagement, so you can ask "how is traffic moving?" without naming the property. 1. Open the project and select **Brain**. 2. Under **Linked records**, select **Link record**, then **Google Analytics**. 3. Search by property name or ID and select it. Repeat for each property in the engagement. In chats tagged to the project, Hebno starts with the linked properties for any traffic or conversion question. See [Linked records](https://hebno.com/docs/projects/linked-records.md). ## Use Google Analytics in chat * **Attach**: open the **+** menu, choose **Sources → Google Analytics**, and pick a property. Or type `/` and choose **Google Analytics**. * **Ask**: name the property, metric or period in your request. For example: > Compare Contoso website sessions and purchases for the four weeks before and after the 5 October price change. > Which landing pages had the highest engagement rate on mobile in October? > Draft a short traffic section for the Contoso readout with channel mix and key events by month since July. * **Research runs** show a **Checking Google Analytics** step, with a chip for each property and report it ran. * **Agents** can read Analytics on a schedule, for example a Monday summary of last week's sessions and key events for Contoso. Writes an agent proposes elsewhere appear in [agent approvals](https://hebno.com/docs/automate/agent-approvals.md) for review. ## Troubleshooting | Symptom | Fix | | - | - | | **User does not have sufficient permissions for this property** | Your Google account has no role on the property. Ask a property administrator to add you as a **Viewer** under **Property access management**. | | A property you expect does not appear | It is a Universal Analytics property, or it belongs to another Google account. Check that you connected the account with access. | | Revenue or cost metrics are empty | Your role has data restrictions on cost or revenue metrics. Ask a property administrator to remove the restriction. | | Totals differ from the Analytics interface | Google applied data thresholds or grouped rows into **(other)**. Shorten the date range or remove a dimension. | | Requests fail with a quota message | The Data API limits tokens per property per hour and per day. Wait and retry. | | **Access blocked** at sign-in | A Workspace super admin restricts third-party access. Ask them to trust Hebno. See [Google Workspace admin](https://hebno.com/docs/integrations/google-workspace-admin.md). | ## Related * [Google Workspace](https://hebno.com/docs/integrations/google-workspace.md) * [Google Workspace admin](https://hebno.com/docs/integrations/google-workspace-admin.md) * [Google BigQuery](https://hebno.com/docs/integrations/bigquery.md) * [Looker](https://hebno.com/docs/integrations/looker.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.