ga4-export-fixer 0.3.2-dev.4 → 0.4.1-dev.0

package/README.md

@@ -32,6 +32,7 @@ The **ga4_events_enhanced** table comes with features such as these:
 - **Best available data at any time** – Combines daily (processed), fresh (360), and intraday exports so the most complete, accurate version of the data is always available
 - **Robust incremental updates** – Run on any schedule (daily, hourly, or custom)
 - **Flexible schema, better optimized for building data models** – Keeps the flexible structure of the original export while promoting key fields (e.g. `page_location`, `session_id`) to columns for better query performance; **partitioning and clustering** enabled
+- **AI agent ready** – Extensive table description and detailed column descriptions (including lineage, configuration context, and typical use examples) make the data understandable for both AI agents (e.g. BigQuery data agents) and humans
 - **Session-level identity resolution** – `user_id` resolved to the last authenticated value per session; `merged_user_id` coalesces it with `user_pseudo_id`
 - **Session traffic sources** – `session_first_traffic_source` and session-scoped `session_traffic_source_last_click` (adjusting for sessions that span midnight) computed automatically
 - **Landing page detection** – `landing_page` derived per session from the first page where `entrances > 0`
@@ -45,7 +46,6 @@ The **ga4_events_enhanced** table comes with features such as these:
 - **Selective date range re-processing** – Re-process a subset of data without a full table rebuild, using `incrementalStartOverride` and `incrementalEndOverride`
 - **Batch processing** – Process large GA4 exports in smaller batches using the `numberOfDaysToProcess` configuration setting
 - **Timezone-aware datetime** – `event_datetime` converted to a configurable IANA timezone
-- **Column descriptions** – Full column-level documentation included in the Dataform table configuration, reflecting the specific configuration used to build the table
 - **Zero dependencies** – The package has no external dependencies and will not add any additional packages to your Dataform repository
 
 ### Planned, Upcoming Features
@@ -78,7 +78,7 @@ Include the package in the package.json file in your Dataform repository.
 {
   "dependencies": {
     "@dataform/core": "3.0.42",
-    "ga4-export-fixer": "0.3.1"
+    "ga4-export-fixer": "0.4.0"
   }
 }
 ```

package/columns/tableAgentInstructions.json

@@ -130,7 +130,7 @@
         {"text": "For session metrics: GROUP BY session_id.", "dependsOn": ["session_id"]},
         {"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": "For traffic source analysis: use session_traffic_source_last_click.cross_channel_campaign.primary_channel_group for high-level traffic source information", "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.4",
+  "version": "0.4.1-dev.0",
   "description": "",
   "main": "index.js",
   "files": [