Infinario Destination

Segment makes it easy to send your data to Infinario (and lots of other destinations). Once you've tracked your data through our open source libraries we'll translate and route your data to Infinario in the format they understand. Learn more about how to use Infinario with Segment.

Getting Started

  • Create a free account and project at https://cloud.infinario.com/ if you haven’t done so already
  • Find your Exponea Project Token in the Project overview screen visible after choosing your project
  • Toggle Exponea on in your Segment destinations, using the Project Token from the previous step

Exponea supports the identify, track, page, screen and alias methods, there is also partial support for the group method.


Common restrictions

User traits and event properties cannot contain characters . and $ in the trait/property keys. That means "currency": "$" is OK, but "^.^": "kitty" is not. The total amount of user trait keys is limited to 255. The same limit also applies for the total amount of property keys for each event type, and the total amount of event types.

Aside from these restrictions, Exponea supports any JSON-serializable data as a trait/property value. However, objects are unpractical to use in the Exponea analytic module, therefore we unpack the first level of an object as properties for your convenience. For example, "address": {"country": "UK", "city": "London"} is stored as properties "address_country": "UK" and "address_city": "London".

Identify

This call ensures the existence and updates the properties of a user (player/customer) in Exponea. The userId is mapped to Exponea registered ID, whereas the anonymousId is mapped to Exponea cookie ID. Properties of a user with special usage in Exponea can be found in the Players guide.

Track

Tracks an event of any type, including any desired properties of that event. Most of the Segment call’s context will be added as extra properties.

It is advised to reserve the campaign event type for events generated automatically by the Exponea campaign module. If you track your mobile app payments as the event type hard_purchase, you will be able to use the automated payment validation.

Page

Tracks an event of type page_visit, it is currently also used to keep track of sessions. The first page call in a session creates a session_start event, then after a certain time of inactivity, the session_end event is created with the duration of the session.

Screen

Tracks an event of type screen_visit, it is currently also used to keep track of Exponea sessions, the same way the page call does.

Alias

The alias call can be used to merge two user indentities and their data to one. The previousId field should always contain a previously used anonymousId, as merging users by specifying two userId‘s is currently not supported. Note that users are also merged when any call specifies both a userId and an anonymousId, which previously belonged to two separate users.

Group

This call is currently only supported partially. Whenever a user is assigned to a group, the properties of this group and the group ID is added to the user’s properties. This means there is no support for the user being in multiple groups.


Please consult the Exponea guides to see what can you do with the data you tracked.


Personas

You can send computed traits and audiences generated through Segment Personas to this destination as a user property. To learn more about Personas, reach out for a demo.

For user-property destinations, an identify call will be sent to the destination for each user being added and removed. The property name will be the snake_cased version of the audience name you provide with a true/false value. For example, when a user first completes an order in the last 30 days, we will send an identify call with the property order_completed_last_30days: true, and when this user no longer satisfies we will set that value to false.

When the audience is first created an identify call is sent for every user in the audience. Subsequent syncs will only send updates for those users which were added or removed since the last sync.

Settings

Segment lets you change these destination settings via your Segment dashboard without having to touch any code.

Project Token

Your Exponea Project Token


If you have any questions or see anywhere we can improve our documentation, please let us know or kick off a conversation in the Segment Community!