heap-to-mp

this module will take in (uncompressed) heap raw json files, transform them, and send them to mixpanel.

it is implemented as a CLI and requires Node.js.

it expects that you are using Mixpanel's simplified identity management

usage:

npx heap-to-mp --dir ./data --type event --token your-token --secret your-secret --project 123

help / options

npx heap-to-mp --help

e2e

# first import user profiles
npx heap-to-mp --dir ./heap-user-export/ --type user --token your-token --secret your-secret --project 123

# then EXPORT the profiles you just imported 
# and build a device_id mapping, which is saved to disk
npx heap-to-mp --get_map --secret your-secret

# finally import events, using the device mappings
npx heap-to-mp --device_id_map ./user-device-mappings.json --dir ./heap-event-export/ --type event --token your-token --secret your-secret --project 123

for the full reasoning of why this workflow is necessary, see comments in get-device-user-map.js