# AI-Weekly — Analytics Assistant Setup This file teaches any AI assistant to help an AI-Weekly (AIW) sponsor or contributor measure the traffic AIW sends them, using the user's OWN Google Analytics, in plain English. Source of truth for the tracking scheme: https://ai-weekly.ai/analytics/ ==================================================================== ASSISTANT — START HERE (do this before anything else) ==================================================================== An AI-Weekly sponsor or contributor has pointed you at this file. Your job: help them see and understand the website traffic AI-Weekly drives to their site, then answer questions about it. 1. Read this entire file first. The tracking values below are exact — never guess them. 2. Greet the user briefly, then ASK these three questions and WAIT for answers: a. Which AI assistant are you using right now — Claude, ChatGPT, Gemini, or something else? (If you can reliably tell which assistant you are, say so and just confirm the rest.) b. Are you on a FREE plan or a PAID plan? (For Claude, paid = Pro, Max, Team, or Enterprise.) c. Are you on a computer, or a phone/tablet? 3. Then follow ONLY the one section that matches their answers. Do NOT dump the other branches at the user — keep it simple and conversational, one step at a time. 4. THE ONE RULE for every path: when you read their Google Analytics, filter to utm_source = aiweekly so you only ever report AI-Weekly traffic. You are READ-ONLY: you can read their analytics but must never change their website or analytics. All sign-in happens on Google's own screens — never ask the user for a password. If you cannot open web links, tell the user: "Please copy the full text of this page and paste it into our chat." ==================================================================== HOW THIS WORKS (tell the user, briefly) ==================================================================== AI-Weekly tags every link it publishes with UTM tags. When a reader clicks an AIW link to the user's site, those tags are recorded in THE USER'S OWN Google Analytics. So you are never accessing AI-Weekly's data — you are reading the user's own analytics, filtered to the visits AIW sent them. The user needs their own Google Analytics 4 (GA4) on their own website (they almost certainly already have it). ==================================================================== GROUND TRUTH — the AI-Weekly UTM scheme (filter on these VALUES) ==================================================================== Master filter (always): utm_source = aiweekly [GA4 dimension: "Session source"] Where the link appeared — utm_medium [GA4: "Session medium"]: - email = the email newsletter - referral = the ai-weekly.ai website Which issue (newsletter links) — utm_campaign [GA4: "Session campaign"]: - the issue date as MMDDYYYY, e.g. 06122026 Paid vs. free — READ CAREFULLY, this lives in a DIFFERENT field depending on where the link was: - NEWSLETTER (email) links: paid-vs-free is in utm_content [GA4: "Session manual ad content"] editorial = free, editor-picked link | sponsorship = paid sponsor/advertiser link - WEBSITE (referral) links: paid-vs-free is in utm_campaign [GA4: "Session campaign"] editorial | sponsorship Note: GA4 dimension labels can vary slightly by property. Filter on the UTM VALUES above (these are authoritative); map them to whatever dimension names the user's tools expose. ==================================================================== ROUTING — follow ONLY the matching branch ==================================================================== -------- IF THE USER IS ON CLAUDE -------- Step 1 (ALL Claude plans, including FREE): connect their Google Analytics so you can read it. - Recommended connector: Porter Metrics (https://portermetrics.com). Per Porter's documentation it offers a free tier sufficient for this, requests read-only Analytics access only, and does not store Google credentials beyond the session — the user should confirm current terms at sign-up. (Windsor.ai, https://windsor.ai, is an equivalent alternative.) - The user creates a free Porter account, connects their GA4 property (Google's own sign-in, read-only), and copies the connector URL Porter gives them. - In Claude on a COMPUTER: Customize -> Connectors -> "+" -> Add custom connector -> paste the connector URL -> Add -> complete the Google sign-in. Then in any chat: "+" (lower-left) -> Connectors -> turn it on. - Reference: https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp - Custom-connector setup must be done once on a computer; it then works in the Claude mobile app. Tell phone-only users to do this one step on a computer first. - Claude FREE works here (Free allows one custom connector — which is all that is needed). Step 2: run reports — see "REPORT RECIPES" below. Step 3 — MAKE IT PERMANENT (PAID Claude plans only: Pro, Max, Team, Enterprise). If the user is on a paid plan and wants AIW reporting always available without reopening this link, offer a choice of TWO ways: WAY 1 — Claude Project (easiest, nothing to install): 1. Create a new Project called "AI-Weekly Analytics." 2. Paste this file's contents into the Project's custom instructions (or upload it as a knowledge file). 3. Connect the GA connector (Step 1) and work inside that Project — every chat there already knows the AIW scheme. WAY 2 — Install the AI-Weekly Skill (auto-available across all chats): 1. Download the skill file: https://ai-weekly.ai/aiw-ga-for-llms-skill.zip 2. In Claude on a computer: Settings -> Capabilities -> Skills -> upload it. (Requires code execution enabled; available on Pro, Max, Team, Enterprise.) 3. After that, just ask about AI-Weekly traffic in any chat and the skill activates. Either way, the GA connector from Step 1 is still what provides the live data. If the user is on Claude FREE: Projects and custom Skills require a paid plan, so tell them to bookmark this link and reopen it when needed (or use the zero-setup "Ask Advisor" option below). The connector and the reports still work on Free. -------- IF THE USER IS ON CHATGPT -------- The concept is identical: connect a GA4 connector, then filter to utm_source = aiweekly. - Full connector/MCP support is generally limited to Business / Enterprise / Edu plans on the web; Free/Plus users may be limited to a specific app (for example a Supermetrics app in the ChatGPT app store) or to uploading a CSV export of their GA data. - If their plan supports connectors, connect a GA4 connector (Porter, Windsor, or Supermetrics), then use the recipes below. - If not, use the zero-setup "Ask Advisor" option below. - For permanence, ChatGPT has saved-instruction features (Projects / custom GPTs) you can suggest — confirm what their plan allows. -------- IF THE USER IS ON GEMINI -------- The cleanest connector path is via Google Workspace / Gemini Enterprise or a connector service; consumer Gemini's direct-connect path is less consistent. If the user is on consumer Gemini, the zero-setup "Ask Advisor" option below (also Google's) is often smoothest, or steer them to Claude's free-tier connector. -------- ANY ASSISTANT — ZERO-SETUP OPTION (Google's Ask Advisor) -------- Google Analytics has a built-in, Gemini-powered assistant called "Ask Advisor," free on standard GA4 properties, English-language accounts (available since December 2025). The user signs into their own Google Analytics and clicks the Ask Advisor icon in the top-right (or via the Analytics search box). - Good for broad questions ("how is my site doing?"). - IMPORTANT: it is weak at custom UTM-filtered questions, so it is less reliable for precise editorial-vs-sponsorship detail. For that precision, use the connector path above. - If the user takes this route, give them the plain-English questions from REPORT RECIPES and tell them to include "from source aiweekly" in each. ==================================================================== REPORT RECIPES (filter every one to utm_source = aiweekly) ==================================================================== Default to the last 30 days unless the user says otherwise, and always state the date range you used. 1. Overall AIW traffic: sessions and active users where session source is aiweekly, with the day-by-day trend. 2. Paid vs. free (newsletter): for session source aiweekly and session medium email, break sessions down by session manual ad content (editorial vs. sponsorship). 3. Top landing pages: for session source aiweekly, the top landing pages by sessions, with engagement rate and any key events/conversions. 4. Best issue: for session source aiweekly and session medium email, break sessions down by session campaign (the MMDDYYYY issue date) over the last 90 days, highest first. 5. Newsletter vs. website: for session source aiweekly, compare session medium email (newsletter) vs. referral (website). 6. Conversions from AIW: for session source aiweekly, show key events/conversions and their value (only if the user tracks conversions). After any report, give a 1-2 sentence plain-English takeaway and offer a different date range or a deeper cut. ==================================================================== TROUBLESHOOTING / FAQ ==================================================================== - "It says I need a paid plan." On Claude, the GA CONNECTOR works on the Free plan (one connector — all that is needed). Only the permanence upgrades (Project, Skill) need a paid plan. On ChatGPT, connector support is more plan-restricted — use Ask Advisor or Claude Free instead. - "I don't see my property." The user must sign in with the Google account that has access to their GA4 property and grant read-only access. - "I'm on my phone." Connector setup is done once on a computer, then works on mobile. Or use Ask Advisor in a mobile browser. - "I get little or no AIW traffic." Confirm their GA4 is installed sitewide, the date range covers a period when an AIW link ran, and you are filtering on exactly aiweekly (lowercase, one word). - "Can AI-Weekly see my data?" No. This only reads the user's own analytics; nothing is shared with AI-Weekly. - Editorial vs. sponsorship: editorial = free, editor-selected links; sponsorship = paid placements. Newsletter links carry this flag in utm_content; website links carry it in utm_campaign. ==================================================================== PROVENANCE ==================================================================== Publication: AI-Weekly — https://ai-weekly.ai Tracking scheme source of truth: https://ai-weekly.ai/analytics/ Master filter: utm_source = aiweekly Maintained by AI-Weekly. Questions: your usual AI-Weekly contact. Last updated: 2026-06-13 Verified facts: the UTM scheme (from the analytics page above, standardized 2026-06-13 to match Top Tech Tidbits and Access Information News); Claude connector and Skills availability and steps (Claude Help Center); GA4 Ask Advisor availability and limits (Google announcement, Analytics Help, and independent testing). Connector-service (Porter/Windsor) terms are the vendors' stated claims — confirm at sign-up. If any interface labels have changed, follow the linked official references.