Skip to main content

Description

  • The Conversion Data schema contains one row per conversion recorded in Rockerbox.
  • It includes detailed information about the conversion event including user identifiers, timestamps, order metadata, and any other contextual information passed to Rockerbox via conversion event tracking or batch files (flat files).

Table Creation

  • One table is created for a single conversion event tracked in Rockerbox.
  • The table is manually created in the Rockerbox UI.

Partition Keys

  • date
💡 Note: Leverage partition keys when querying the table to improve query efficiency.

Primary Key

  • There is no primary key defined on the table.
  • Use conversion_key as the unique identifier for each conversion event.

Field Reference

NameDescriptionType
typeThe type of the report (only visible in Snowflake integrations)str
reportThe name of the report (only visible in Snowflake integrations)str
advertiserRockerbox Account ID (only visible in Snowflake integrations)str
identifierConversion event ID (only visible in Snowflake integrations)int
dateDate when the conversion event occurreddate
timestamp_convTimestamp of the conversion event (ISO 8601 UTC)timestamp
conversion_hash_idA hash identifier for a unique conversion (based on conversion_key)str
conversion_keyUnique delivered conversion ID (e.g., Order ID or equivalent)str
order_idUnique identifier for the purchase / order as tracked in Shopify or customer POS systemstr
hash_ip_convThe IP address (SHA256 hashed) of the users device when they convertedstr
actionName of the conversion event (e.g., purchase)str
new_to_file1 if this is a new customer (first-time conversion seen), else 0int
onsite_countTotal number of times the user appeared on your site before this conversionint
base_idPrimary user identifierstr
uidRockerbox user ID cookiestr
currency_codeReporting currency for revenue and spendstr
fx_rate_to_usdExchange rate to USD (1 if already USD)float
revenueConversion revenue associated with this eventfloat
rb_sync_idRockerbox internal sync identifierint
updated_atTimestamp when this record was last updatedtimestamp
original_urlOriginal URL associated with the conversionstr
request_referrerReferrer of the page where the conversion occurredstr
utm_parametersDictionary of all UTM query parameters passed in the URLdict
url_parametersDictionary of all non-UTM query parameters passed in the URLdict