June Cloud Mode Integration
3 minute read
RudderStack lets you send your event data to June via 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 anidentifycall before making atrackorgroupcall.
A sample identify call is shown below:
rudderanalytics.identify("1hKOmRA4el9Z", {
name: "Alex Keener",
email: "alex@example.com"
})Property mapping
The following table lists the property mappings between RudderStack and June for the identify call:
| RudderStack property | Data type | June property |
|---|---|---|
userIdtraits.userIdtraits.idcontext.traits.userIdcontext.traits.idRequired | String | userId |
originalTimestamptimestampRequired | Timestamp in ISO 8601 format ( yyyy-MM-ddTHH:mm:ss.SSSZ) | timestamp |
anonymousId | String | anonymousId |
traitscontext.traits | Object | traits |
context | Object | context |
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 mapping
The following table lists the property mappings between RudderStack and June for the track call:
| RudderStack property | Data type | June property |
|---|---|---|
userIdtraits.userIdtraits.idcontext.traits.userIdcontext.traits.idRequired | String | userId |
eventRequired | String | event |
originalTimestamptimestampRequired | Timestamp in ISO 8601 format ( yyyy-MM-ddTHH:mm:ss.SSSZ) | timestamp |
anonymousId | String | anonymousId |
properties | Object | properties |
| String | context.groupId |
context | Object | context |
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 agroupcall to identify a company, it is recommended to pass thegroupIdin thetrackcall. It allows you to specify which company performed that specific event.
A sample group call is shown below:
rudderanalytics.group("23Np893Z6", {
name: "ABC company",
employees: 100,
Industry: "Video game publisher",
Founded: 1979
});Property mapping
The following table lists the property mappings between RudderStack and June for the group call:
| RudderStack property | Data type | June property |
|---|---|---|
userIdtraits.userIdtraits.idcontext.traits.userIdcontext.traits.id
| String | userId |
originalTimestamptimestampRequired | Timestamp in ISO 8601 format ( yyyy-MM-ddTHH:mm:ss.SSSZ) | timestamp |
groupIdtraits.groupIdRequired | String | groupId |
anonymousId | String | anonymousId |
traitscontext.traits | Object | traits |
context | Object | context |
Page
You can use the page call to record and send page views to June.
A sample page event:
rudderanalytics.page("Home");Property mapping
| RudderStack property | Data type | June property |
|---|---|---|
propertiesRequired | Object | properties |
userIdtraits.userIdtraits.idcontext.traits.userIdcontext.traits.id | String | userId |
timestamporiginalTimestamp | Timestamp in ISO 8601 format ( yyyy-MM-ddTHH:mm:ss.SSSZ) | timestamp |
anonymousId | String | anonymousId |
groupId | String | context.groupId |
context | Object | context |
FAQ
Can I make an identify or track call using anonymousId?
No, you cannot. June does not stitch identities together or support merging anonymous users. 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.