Vero Cloud Mode Integration

Send events to Vero via RudderStack cloud mode.

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

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

Identify

The identify call lets you identify a user and associate them to their actions. It also lets you record any traits about them like their name, email, etc.

RudderStack sends the identify events to Vero via their users endpoint to create, update, and manage your user records and their subscription status.

A sample identify call is shown below:

rudderanalytics.identify("1hKOmRA4GRlm", {
  "email": "alex@example.com",
  "gender": "Male",
  "randomKey": "randomData"
})

Supported mappings

The following table lists the mapping of the RudderStack traits to the corresponding Vero properties:

RudderStack traitVero propertyPresence
userId or anonymousIdidRequired.
emailemailOptional
traitsdataOptional
context.os.namechannels.platformOptional
context.device.tokenchannels.addressOptional
context.device.namechannels.deviceOptional
context.timezonetimezoneOptional
context.localelocaleOptional
context.userAgentuserAgentOptional
info
email is an optional field. However, if it is absent, Vero will not be able to send any emails to the user, so it is recommended to have this trait in the event.
info
If userId is absent, RudderStack maps anonymousId to Vero’s id field to create or update the user.
success
You can add or update user records as required as these are the custom properties.

Track

The track call lets you capture user events along with the properties associated with them.

RudderStack sends the track events to Vero via their events/track endpoint to track events for a specific user based on the actions they take. If a user profile does not exist, Vero will create one.

A sample track event is as shown:

rudderanalytics.track("Product Viewed", {
  SKU: "P001",
  "revenue": 77.6,
  "currency": "USD",
  "review_id": "R1619"
})
info
Vero does not differentiate between the upper or lower case letters, spaces, and underscores in the event names. For example, Vero matches the Purchased Item, purchased item, and purchased_item as the same event.

Supported mappings

The following table lists the mapping of the RudderStack properties to the corresponding Vero properties:

RudderStack propertyVero propertyPresence
userId/anonymousIdidentity.idRequired
eventevent_nameRequired
emailidentity.emailOptional
propertiesdataOptional

Unsubscribing and resubscribing users

RudderStack supports unsubscribing and resubscribing users in Vero by passing the userId in the track call:

rudderanalytics.track("unsubscribe", {
  userId: "1hKOmRA4el9Zt1WSfVJIVo4GRlm"
})

Page

The page call lets you record your website’s page views with any additional relevant information about the viewed page.

RudderStack sends the page events to Vero via their events/track endpoint.

A sample page call is shown below:

rudderanalytics.page(
  "Cart",
  "Cart Viewed", {
    path: "/best-seller/1",
    referrer: "https://www.google.com/search?q=estore+bestseller",
    search: "estore bestseller",
    title: "The best sellers offered by EStore",
    url: "https://www.estore.com/best-seller/1"
  }
);

Screen

The screen call lets you record whenever your user views their mobile screen, with any additional relevant information about the screen.

RudderStack sends the screen events to Vero via their events/track endpoint.

A sample screen call sent via the Android SDK is as shown:

MainApplication.rudderClient.screen(
    "Home Screen",
    RudderProperty().putValue("prop_key", "prop_value")
)

Alias

RudderStack sends the alias events to Vero via their users/reidentify endpoint to change a user’s identifier (id).

A sample alias call is shown below:

rudderanalytics.alias("userId", "previousId");

Supported mappings

The following table lists the mapping of the RudderStack properties to the corresponding Vero properties:

RudderStack propertyVero propertyPresence
userIdnew_idRequired
previousIdidRequired

Adding and removing tags

RudderStack supports adding and removing tags to all identify, track, page, and screen calls by passing them via the integrations object. An example snippet is shown below:

rudderanalytics.identify(
  "1hKOmRA4GRlm", {
    email: "alex@example.com"
  }, {
    integrations: {
      Vero: {
        tags: {
          add: ["tag1", "tag2"],
          remove: ["tag3"]
        }
      }
    }
  }
);

You can then view the updated tags associated with that user in the Vero dashboard:

User tags in Vero dashboard

Questions? Contact us by email or on Slack