ga4-export-fixer 0.5.2-dev.0 → 0.5.2-dev.2

package/README.md

@@ -74,49 +74,57 @@ The goal of the package is to **speed up development** when building data models
   Nullifies placeholder <code>transaction_id</code>; corrects <code>purchase_revenue</code> bugs
 </td>
 <td valign="top">
-  <b>⚙️ Event Parameter Handling</b><br>
-  Promote event params to columns; include or exclude by name
+  <b>🏷️ Item List Attribution</b><br>
+  Attributes <code>item_list_name</code>, <code>item_list_id</code>, and <code>item_list_index</code> from item selection events to downstream ecommerce events
 </td>
 </tr>
 <tr>
+<td valign="top">
+  <b>⚙️ Event Parameter Handling</b><br>
+  Promote event params to columns; include or exclude by name
+</td>
 <td valign="top">
   <b>📊 Session Parameters</b><br>
   Promote selected event parameters as <code>session_params</code>
 </td>
+</tr>
+<tr>
 <td valign="top">
   <b>⏱️ Custom Timestamp</b><br>
   Use a custom event parameter as primary timestamp with automatic fallback
 </td>
-</tr>
-<tr>
 <td valign="top">
   <b>🔒 Schema Lock</b><br>
   Lock table schema to a specific GA4 export date to prevent schema drift
 </td>
+</tr>
+<tr>
 <td valign="top">
   <b>✅ Data Freshness Tracking</b><br>
   <code>data_is_final</code> flag and <code>export_type</code> label on every row
 </td>
-</tr>
-<tr>
 <td valign="top">
   <b>🔃 Selective Re-processing</b><br>
   Re-process a date range without full table rebuild using <code>incrementalStartOverride</code> and <code>incrementalEndOverride</code>
 </td>
+</tr>
+<tr>
 <td valign="top">
   <b>📑 Batch Processing</b><br>
   Process large exports in smaller batches via <code>numberOfDaysToProcess</code>
 </td>
-</tr>
-<tr>
 <td valign="top">
   <b>🕐 Timezone-Aware Datetime</b><br>
   <code>event_datetime</code> converted to a configurable IANA timezone
 </td>
+</tr>
+<tr>
 <td valign="top">
   <b>🛡️ Zero Dependencies</b><br>
   No additional external dependencies added to your Dataform repository
 </td>
+<td valign="top">
+</td>
 </tr>
 </table>
 
@@ -125,7 +133,6 @@ The goal of the package is to **speed up development** when building data models
 Features under consideration for future releases:
 
 - Web and app specific default configurations
-- Ecommerce item list attribution
 - Custom channel grouping
 - Data enrichment (item-level, session-level, event-level)
 - Custom processing steps (additional CTEs)
@@ -239,6 +246,10 @@ const config = {
   dataIsFinal: {
     detectionMethod: 'EXPORT_TYPE',
   },
+  // attribute item lists to downstream ecommerce events within the same session
+  itemListAttribution: {
+    lookbackType: 'SESSION',
+  },
 };
 
 ga4EventsEnhanced.createTable(publish, config);

package/package.json

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

package/tables/ga4EventsEnhanced/index.js

@@ -226,7 +226,7 @@ const _generateEnhancedEventsSQL = (mergedConfig) => {
             ecommerce: helpers.fixEcommerceStruct('ecommerce'),
             items: 'items',
             // unique row id for item list attribution join
-            _event_row_id: itemListAttribution ? 'row_number() over()' : undefined,
+            _event_row_id: itemListAttribution ? `farm_fingerprint(concat(user_pseudo_id, cast(event_timestamp as string), event_name, to_json_string(items)))` : undefined,
             // flag if the data is "final" and is not expected to change anymore
             data_is_final: helpers.isFinalData(mergedConfig.dataIsFinal.detectionMethod, mergedConfig.dataIsFinal.dayThreshold),
             export_type: helpers.getGa4ExportType('_table_suffix'),
@@ -275,13 +275,13 @@ ${excludedEventsSQL}`,
             name: 'item_list_data',
             columns: {
                 '_event_row_id': '_event_row_id',
-                '[sql]items': `array_agg(
+                'items': `array_agg(
       (select as struct item.* replace(
         coalesce(if(${passthroughEvents}, item.item_list_name, _item_list_attr.item_list_name), '(not set)') as item_list_name,
         coalesce(if(${passthroughEvents}, item.item_list_id, _item_list_attr.item_list_id), '(not set)') as item_list_id,
         coalesce(if(${passthroughEvents}, item.item_list_index, _item_list_attr.item_list_index)) as item_list_index
       ))
-    ) as items`,
+    )`,
             },
             from: `(select _event_row_id, event_name, item, ${attrExpr} as _item_list_attr from event_data, unnest(items) as item where event_name in (${ecommerceFilter}))`,
             groupBy: ['_event_row_id'],