divine-comedian
commented
3 years ago More Context on flattening properties -
this is an example of a track call from the impact-graph on .io in the const segmentDonationReceived we define specifically the information we want and save it to an object with simple property names mapped to their value in the DB. We then put this object inside of the track call for the specific event we want to attach it to.
Save Donation
const projectOwner = await User.findOne({ id: Number(project.admin) })
if (projectOwner) {
await tokenValues
analytics.identifyUser(projectOwner)
const segmentDonationReceived = {
email: projectOwner.email,
title: project.title,
firstName: projectOwner.firstName,
projectOwnerId: project.admin,
slug: project.slug,
amount: Number(amount),
transactionId: transactionId.toString().toLowerCase(),
transactionNetworkId: Number(transactionNetworkId),
currency: token,
createdAt: new Date(),
toWalletAddress: toAddress.toString().toLowerCase(),
fromWalletAddress: fromAddress.toString().toLowerCase(),
donationValueUsd: donation.valueUsd,
donationValueEth: donation.valueEth
}
analytics.track(
'Donation received',
projectOwner.segmentUserId(),
segmentDonationReceived,
projectOwner.segmentUserId()
)
}we specify all the information we want to capture and assign an object with flattened property names that get the information we want. It should come out clean on the segment side like this:
analytics.track({
anonymousId: 'givethId-161',
userId: 'givethId-161',
event: 'Donation received',
properties: {
amount: 0.001,
createdAt: new Date('2021-07-08T12:41:36.526Z'),
currency: 'ETH',
donationValueEth: 0.001,
donationValueUsd: 2.17127,
email: 'mrnikkhah@gmail.com',
firstName: 'Moe',
fromWalletAddress: '0x62f49a875f09c82e104197afbb8a30e66bb96ba3',
projectOwnerId: '161',
slug: 'myfirstprojectonio',
title: 'MyFirstProjectOnIO',
toWalletAddress: '0xf3bab2f1add2af035f489d7f3fb45a2411ed89ba',
transactionId: '0x0ddd1a41af785ea73a54073a669456303adafba99f53183324fa2911043b656c',
transactionNetworkId: 3
}
});
mohammadranjbarz
MoeNick
To improve the analytics being sent we need to refine the information we're sending to segment from the track calls and to flatten nested properties into simple object names.
Another discussion is if we would like to include things like user email addresses and/or names which would make integration with any new email or user outreach systems easier to implement further down the road..definitely if we're integrating TRACE with .io we should be gathering similar information from users... input from @aminlatifi and @MoeNick would be appreciated