{
  "name": "3Hi GA4 AI-assistant channel template",
  "version": "2026-10",
  "setupInTheGa4Interface": [
    "In GA4, open Admin, then Data display, then Channel groups.",
    "Copy the Default channel group (or create a new channel group) and name it \"Channels with AI assistants\".",
    "Add a new channel called \"AI assistants\".",
    "Set its condition to: Source matches regex, and paste the pattern below.",
    "Drag \"AI assistants\" above \"Referral\" so AI traffic is classified first, then save.",
    "In reports, switch the primary dimension to your new channel group. It applies to past data too."
  ],
  "channel": {
    "displayName": "AI assistants",
    "condition": {
      "dimension": "Source",
      "matchType": "matches regex",
      "value": ".*(chatgpt\\.com|chat\\.openai\\.com|perplexity\\.ai|gemini\\.google\\.com|claude\\.ai|copilot\\.microsoft\\.com|meta\\.ai|you\\.com|poe\\.com).*"
    },
    "placeAbove": "Referral"
  },
  "forDevelopers": {
    "note": "Shape follows the GA4 Admin API ChannelGroup resource. Check field names against the current Admin API reference before using it programmatically.",
    "channelGroup": {
      "displayName": "Channels with AI assistants",
      "description": "Default channels plus an \"AI assistants\" channel placed above Referral.",
      "groupingRule": [
        {
          "displayName": "AI assistants",
          "expression": {
            "orGroup": {
              "filterExpressions": [
                {
                  "filter": {
                    "fieldName": "eachScopeSource",
                    "stringFilter": {
                      "matchType": "FULL_REGEXP",
                      "value": ".*(chatgpt\\.com|chat\\.openai\\.com|perplexity\\.ai|gemini\\.google\\.com|claude\\.ai|copilot\\.microsoft\\.com|meta\\.ai|you\\.com|poe\\.com).*"
                    }
                  }
                }
              ]
            }
          }
        }
      ]
    }
  },
  "alsoDo": [
    "Add \"An AI assistant (ChatGPT, Gemini, Claude, Perplexity…)\" as an answer to your signup form's \"How did you hear about us?\" field. Analytics alone undercounts AI-influenced signups."
  ]
}