RudderStack lets you send your event data to June via the cloud mode.

Find the open-source transformer code for this destination in the GitHub repository.

Identify

You can use the identify call to create a new user or update an existing user's details in June. RudderStack sends the identify call to June using their identify API.

Make sure that you make an identify call before making a track or group call.

A sample identify call is shown below:

rudderanalytics.identify("1hKOmRA4el9Z", {
name: "Alex Keener",
email: "alex@example.com"
})

Property mappings

The following table lists the property mappings between RudderStack and June for the identify call:

RudderStack propertyJune propertyData typePresence
userId/traits.userId/traits.id/context.traits.userId/context.traits.iduserIdStringRequired
originalTimestamp/timestamptimestampDateTime (ISO 8601 date format yyyy-MM-ddTHH:mm:ss.SSSZ)Required
traits/context.traitstraitsObjectOptional

Track

The track call lets you capture user events along with the properties associated with them. RudderStack sends the track call to June using their track API.

A sample track call is shown below:

// groupId using properties object
rudderanalytics.track("Product Reviewed", {
review_id: "12345",
product_id: "123",
rating: 3.0,
review_body: "Average product, expected much more.",
groupId: "5H7ASAIEQO",
});
// groupId using context.externalId array
rudderanalytics.track(
"Product Reviewed", {
review_id: "12345",
product_id: "123",
rating: 3.0,
review_body: "Average product, expected much more.",
}, {
externalId: [{
type: "juneGroupId",
id: "5H7ASAIEQO",
}, ],
}
);

Property mappings

The following table lists the property mappings between RudderStack and June for the track call:

RudderStack propertyJune propertyData typePresence
userId/traits.userId/traits.id/context.traits.userId/context.traits.iduserIdStringRequired
eventeventStringRequired
originalTimestamp/timestamptimestampDateTime (ISO 8601 date format yyyy-MM-ddTHH:mm:ss.SSSZ)Required
propertiespropertiesObjectOptional
  • If context.externalId.id (when context.externalId.type = juneGroupId) is present.
  • Otherwise, properties.groupId.
context.groupIdStringOptional

Group

You can use the group call to create a new company or update an existing company's details in June. Refer to the June documentation for more information.

If you are using a group call to identify a company, it is recommended to pass the groupId in the track call. It allows you to specify which company performed that specific event. For more information, refer to the June documentation.

A sample group call is shown below:

rudderanalytics.group("23Np893Z6", {
name: "ABC company",
employees: 100,
Industry: "Video game publisher",
Founded: 1979
});

Property mappings

The following table lists the property mappings between RudderStack and June for the group call:

RudderStack propertyJune propertyData typePresence
userId/traits.userId/traits.id/context.traits.userId/context.traits.iduserIdString
  • Required for creating a company.
  • Optional for updating the company details.
originalTimestamp/timestamptimestampDateTime (ISO 8601 date format yyyy-MM-ddTHH:mm:ss.SSSZ)Required
groupId/traits.groupIdgroupIdStringRequired
traits/context.traitstraitsObjectOptional

FAQ

Can I make an identify or track call using anonymousId?

No, you can't. June does not stitch identities together or support merging anonymous users. Rather, it is best used to measure user activation and retention when the user is logged in.

My user is created as Unknown in June dashboard. What might be the reason?

June categorizes a user as Unknown if the firstName, lastName, name, username, or email is not present in the traits object of the identify call.


Contact us

For more information on the topics covered on this page, email us or start a conversation in our Slack community.

On this page