Activity Transformations

What is an activity transformation?

An activity transformation is the SQL query that transforms your source data to define your activity. The activity transformation must meet two requirements:

  • Each record corresponds to a customer completing the activity
  • It follows a defined structure (11 columns) so that it is compatible with, and can be added to, the Activity Stream

Narrator uses the activity transformation to add activities to the Activity Stream. The activity transformation becomes the definition that will be used to define a customer concept (activity) across your company. Once you create a transformation, everyone at your company will be able to use the same shared definition for this activity.


How To: Create an Activity Transformation

Watch this step-by-step tutorial to add your first activity transformation

Columns in an Activity Transformation

The SQL query transforms the source data to generate the following 10 columns:




Unique ID for the activity record


Timestamp in UTC for when the activity occurred


(for identity resolution) The anonymous customer id that is generated by the source system of this activity


Unique identifier for the customer that is used to identify them across all company touchpoints (typically an email address)


Name of the activity (ex. 'completed_order')


Activity specific feature 1


Activity specific feature 2


Activity specific feature 3


Revenue or cost associated with the activity (this must be tracked in the same currency for all activities*)


URL link associated with the activity (ex. link to the Shopify Order)

*The revenue_impact currency formatting can be set within company settings


Explore the transformation library for examples by data source.


Still have questions?

Our data team is here to help! Here are a couple ways to get in touch...

πŸ’¬ Chat us from within Narrator

πŸ’Œ Email us at [email protected]

πŸ—“ Or schedule a 15 minute meeting with our data team

What’s Next

Watch this step-by-step tutorial to create your first activity transformation

Did this page help you?