ga4-export-fixer 0.3.2-dev.2 → 0.3.2-dev.3

package/columns/columnDescriptions.json

@@ -208,7 +208,9 @@
                     "campaign_id": "Cross-channel campaign ID",
                     "source_platform": "Cross-channel source platform",
                     "source": "Cross-channel source",
-                    "medium": "Cross-channel medium"
+                    "medium": "Cross-channel medium",
+                    "primary_channel_group": "Custom primary channel group for the session's last non-direct click",
+                    "default_channel_group": "Default channel group for the session's last non-direct click"
                 }
             },
             "sa360_campaign": {

package/columns/columnTypicalUse.json

@@ -13,7 +13,7 @@
     "event_params": "Nested array of event parameters. Unnest with CROSS JOIN UNNEST(event_params) to access individual parameter values",
     "session_params": "Session-scoped parameters. Unnest with CROSS JOIN UNNEST(session_params) to access session-level parameter values",
     "ecommerce": "Transaction and revenue data. Filter to purchase or refund events (WHERE event_name = 'purchase') for ecommerce reporting",
-    "items": "Product-level data array. Unnest with CROSS JOIN UNNEST(items) for item-level analysis in ecommerce reports",
+    "items": "Product-level data array. Unnest with CROSS JOIN UNNEST(items) for item-level analysis. For product revenue and units sold, filter to event_name = 'purchase' and use item_revenue and quantity. Use item_category to filter or group by product category",
     "collected_traffic_source": "Event-level UTM parameters and click identifiers. For session-level attribution, prefer session_first_traffic_source instead",
     "session_first_traffic_source": "First-touch traffic source for the session. Use for session-level acquisition and campaign reporting",
     "session_traffic_source_last_click": "Google-attributed session traffic source. Use for last-click attribution analysis across Google Ads and manual channels",

package/columns/tableAgentInstructions.json

@@ -22,9 +22,14 @@
         },
         {
             "terms": ["revenue", "sales", "purchase revenue", "total revenue"],
-            "sql": "SUM(ecommerce.purchase_revenue) WHERE event_name = 'purchase'",
+            "sql": "SUM(ecommerce.purchase_revenue) WHERE event_name = 'purchase' for transaction-level. For product-level revenue: SUM(items.item_revenue) after CROSS JOIN UNNEST(items) WHERE event_name = 'purchase'",
             "dependsOn": ["ecommerce"]
         },
+        {
+            "terms": ["products", "items", "product revenue", "item revenue", "product sales", "items sold"],
+            "sql": "CROSS JOIN UNNEST(items) to access product-level data. Use items.item_name, items.item_category for identification, items.item_revenue for revenue, items.quantity for units sold. Filter to event_name = 'purchase' for sold products",
+            "dependsOn": ["items"]
+        },
         {
             "terms": ["page URL", "page location", "URL", "current page"],
             "sql": "page_location (full URL) or page.hostname, page.path, page.query (parsed components)",
@@ -36,9 +41,9 @@
             "dependsOn": ["landing_page"]
         },
         {
-            "terms": ["traffic source", "channel", "medium", "campaign", "source", "UTM"],
-            "sql": "collected_traffic_source (event-level), session_first_traffic_source (session first-touch), session_traffic_source_last_click (session last-click attribution)",
-            "dependsOn": ["collected_traffic_source", "session_first_traffic_source"]
+            "terms": ["traffic source", "channel", "channel group", "source of traffic"],
+            "sql": "session_traffic_source_last_click.cross_channel_campaign.primary_channel_group for top-level channel grouping. session_traffic_source_last_click.cross_channel_campaign.source, session_traffic_source_last_click.cross_channel_campaign.medium, and session_traffic_source_last_click.cross_channel_campaign.campaign_name for detailed source/medium/campaign analysis.",
+            "dependsOn": ["session_traffic_source_last_click"]
         },
         {
             "terms": ["device type", "device category", "device", "mobile vs desktop"],
@@ -84,13 +89,18 @@
         },
         {
             "field": "ecommerce.purchase_revenue",
-            "note": "Revenue per transaction. Filter to event_name = 'purchase' before aggregating.",
+            "note": "Transaction-level revenue. Filter to event_name = 'purchase' before aggregating.",
             "dependsOn": ["ecommerce"]
         },
         {
-            "field": "session_first_traffic_source",
-            "note": "Session acquisition source. Use .manual_source and .manual_medium for UTM data.",
-            "dependsOn": ["session_first_traffic_source"]
+            "field": "items",
+            "note": "Product-level data (nested array). CROSS JOIN UNNEST(items) to access item_name, item_category, item_revenue, quantity. Filter to event_name = 'purchase' for sold products.",
+            "dependsOn": ["items"]
+        },
+        {
+            "field": "session_traffic_source_last_click",
+            "note": "Primary field for traffic source analysis. Use .cross_channel_campaign.primary_channel_group for channel grouping. When asked about popular traffic sources, default to channel group unless specified otherwise.",
+            "dependsOn": ["session_traffic_source_last_click"]
         },
         {
             "field": "device.category",
@@ -118,8 +128,9 @@
         {"text": "Use event_name to select specific event types (e.g. WHERE event_name = 'page_view').", "dependsOn": []},
         {"text": "For user counts: COUNT(DISTINCT user_pseudo_id) for device-level, COUNT(DISTINCT merged_user_id) for cross-device.", "dependsOn": []},
         {"text": "For session metrics: GROUP BY session_id.", "dependsOn": ["session_id"]},
-        {"text": "For ecommerce revenue: filter WHERE event_name = 'purchase' before aggregating ecommerce.purchase_revenue.", "dependsOn": ["ecommerce"]},
-        {"text": "For traffic source analysis: use session_first_traffic_source for first-touch, session_traffic_source_last_click for last-click attribution.", "dependsOn": ["session_first_traffic_source"]},
+        {"text": "For transaction-level ecommerce revenue: filter WHERE event_name = 'purchase' before aggregating ecommerce.purchase_revenue.", "dependsOn": ["ecommerce"]},
+        {"text": "For product-level analysis: CROSS JOIN UNNEST(items) WHERE event_name = 'purchase'. Use items.item_revenue for product revenue, items.quantity for units sold, items.item_category for product categories.", "dependsOn": ["items"]},
+        {"text": "For traffic source analysis: use session_traffic_source_last_click.cross_channel_campaign.primary_channel_group for channel grouping. When asked about popular traffic sources, default to channel group unless specified otherwise. For detailed attribution: session_traffic_source_last_click (last non-direct click), session_first_traffic_source (last click without non-direct attribution), collected_traffic_source (event-level data).", "dependsOn": ["session_traffic_source_last_click"]},
         {"text": "Nested arrays (event_params, items): use CROSS JOIN UNNEST(...) to access individual values.", "dependsOn": []},
         {"text": "Use data_is_final = true to exclude data that may still change in future refreshes.", "dependsOn": []}
     ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ga4-export-fixer",
-  "version": "0.3.2-dev.2",
+  "version": "0.3.2-dev.3",
   "description": "",
   "main": "index.js",
   "files": [