Update to Google Analytics by Loopthink

{
  "description": "Set up Google Analytics by Loopthink or work out why it returns no data. Use when the user has just added the app, asks what it can do, gets a \"connect it at …\" message, or cannot find one of their GA4 properties.",
  "included_files": [],
  "name": "get-started",
  "skill_md_contents": "---\nname: get-started\ndescription: Set up Google Analytics by Loopthink or work out why it returns no data. Use when the user has just added the app, asks what it can do, gets a \"connect it at …\" message, or cannot find one of their GA4 properties.\n---\n\n# Get started with Google Analytics by Loopthink\n\nThe app reads the GA4 properties the user connected in Loopthink, and only the\nones their member group was granted. The tools are always the same:\n\n- `connection_status`: whether Google Analytics is connected, and the link to connect it\n- `ga4_list_properties`: the properties the user can query\n- `ga4_report`: a report on one property\n- `ga4_realtime_report`: what is happening on one property right now\n- `ga4_metadata`: the dimensions and metrics one property offers\n\n## 1. Find out what is connected\n\nCall `connection_status`.\n\n- **`connected: true`.** Call `ga4_list_properties` and pass the `propertyId`\n  exactly as returned to the other tools.\n- **`connected: false`.** Give the user the `connectUrl` and continue with step 2.\n\n## 2. Connect Google Analytics\n\nSend the user to the link. Do not try to do it for them: it needs a Google\nsign-in in their browser.\n\n1. Sign in to Loopthink and add Google Analytics.\n2. Sign in with the Google account that has access to the GA4 properties.\n3. Pick the properties the app may read.\n\nThen ask the question again. The tools do not change, so nothing needs\nrefreshing or reconnecting in ChatGPT.\n\n## 3. A property is missing\n\n- It was not picked when Google Analytics was connected: an admin adds it on\n  the server in the Loopthink web app.\n- The person's member group was not granted it: an admin grants it.\n- The Google account behind the connection cannot see it. Universal Analytics\n  properties are not supported, only GA4.\n\n## Notes for answering\n\n- Use GA4 API names: metrics such as `sessions`, `totalUsers`, `conversions`,\n  dimensions such as `date`, `landingPage`, `sessionDefaultChannelGroup`.\n  When unsure whether a name exists, call `ga4_metadata` first.\n- The app is read-only: it cannot change events, conversions or settings.\n"
}