ga4-export-fixer 0.5.2-dev.1 → 0.5.2-dev.3

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.1",
+  "version": "0.5.2-dev.3",
   "description": "",
   "main": "index.js",
   "files": [

package/tables/ga4EventsEnhanced/index.js

@@ -225,8 +225,11 @@ const _generateEnhancedEventsSQL = (mergedConfig) => {
             // ecommerce
             ecommerce: helpers.fixEcommerceStruct('ecommerce'),
             items: 'items',
-            // unique row id for item list attribution join
-            _event_row_id: itemListAttribution ? 'row_number() over()' : undefined,
+            // unique row id for item list attribution join.
+            // row_number() over() breaks hash collisions for batched events with identical data.
+            // Non-determinism is safe: colliding rows have identical items (to_json_string(items) is in the hash),
+            // so swapping row numbers between them produces the same final result.
+            _event_row_id: itemListAttribution ? `farm_fingerprint(concat(user_pseudo_id, cast(event_timestamp as string), event_name, to_json_string(items), cast(row_number() over() as string)))` : 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'),