ga4-export-fixer 0.1.4-dev.1 → 0.1.4-dev.2

package/README.md

@@ -1,6 +1,6 @@
 # ga4-export-fixer
 
-Helpers and table definitions for processing GA4 (Google Analytics 4) BigQuery export data in **Dataform**.
+**ga4-export-fixer** is a **Dataform NPM package** that transforms raw GA4 BigQuery export data into a cleaner, more queryable incremental table. It combines daily and intraday exports so the best available version of each event is always in use, adds session-level fields like `session_id` and `landing_page`, promotes key event parameters to columns, and fixes known GA4 export issues — handling the boilerplate transformations that are otherwise tedious to include in every GA4 query.
 
 ## Installation
 
@@ -148,11 +148,12 @@ pre_operations {
 
 All fields are optional except `sourceTable`. Default values are applied automatically, so you only need to specify the fields you want to override.
 
-| Field | Type | Default | Description |
+| Field | Type | Default/Required | Description |
 |-------|------|---------|-------------|
 | `sourceTable` | Dataform ref() / string | **required** | Source GA4 export table. Use `ref()` in Dataform or a string in format `` `project.dataset.table` `` |
 | `self` | Dataform self() | **required for .SQLX deployment** | Reference to the table itself. Use `self()` in Dataform |
 | `incremental` | Dataform incremental() | **required for .SQLX deployment** | Switch between incremental and full refresh logic. Use `incremental()` in Dataform |
+| `dataformTableConfig` | object | **In JS deployment only** | Include your Dataform table configuration object for the JS deployment to override the default values and include new options. See: https://docs.cloud.google.com/dataform/docs/reference/dataform-core-reference#itableconfig |
 | `schemaLock` | string (YYYYMMDD) | `undefined` | Lock the table schema to a specific date. Must be a valid date >= `"20241009"` |
 | `timezone` | string | `'Etc/UTC'` | IANA timezone for event datetime (e.g. `'Europe/Helsinki'`) |
 | `customTimestampParam` | string | `undefined` | Name of a custom event parameter containing a JS timestamp in milliseconds (e.g. collected via `Date.now()`) |

package/constants.js

@@ -4,6 +4,8 @@ const constants = {
     DATE_RANGE_END_VARIABLE: 'date_range_end',
     DATE_COLUMN: 'event_date',
     DEFAULT_EVENTS_TABLE_NAME: 'ga4_events_enhanced',
+    TABLE_DESCRIPTION_SUFFIX: 'Created by the ga4-export-fixer package.',
+    TABLE_DESCRIPTION_DOCUMENTATION_LINK: 'See package documentation at https://github.com/tanelytics/ga4-export-fixer#readme',
 };
 
 module.exports = constants;

package/package.json

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

package/tables/ga4EventsEnhanced.js

@@ -376,11 +376,16 @@ const createEnhancedEventsTable = (dataformPublish, config) => {
 
     const tableDescription = `GA4 Events Enhanced 
 
-- Combines daily (processed) and intraday exports so the best available version of each event is always used. 
-- Key fields such as page_location and session_id are promoted to columns for faster queries. 
-- Supports incremental updates on any schedule. 
-
-Created by the ga4-export-fixer package.`;
+- Combines daily (processed) and intraday exports so the best available version of each event is always used.
+- Incremental updates: All data with "data_is_final" flag set to false is deleted and replaced with the latest available data on every run (supports any schedule: daily, hourly, or custom).
+- Keeps the flexible schema of the original export while promoting key fields (e.g. page_location, session_id) to columns for faster queries.
+- Partitioned by event_date and clustered for optimal query performance.
+- Event parameter handling: promote params to columns or exclude by name.
+- Session-level fields: landing_page, fixed user_id, and configurable session parameters.
+- Other improvements and refinements based on configuration
+
+${constants.TABLE_DESCRIPTION_SUFFIX}
+${constants.TABLE_DESCRIPTION_DOCUMENTATION_LINK}`;
 
     // the defaults for the dataform table config
     const defaultDataformTableConfig = {