Overview

Properties can either be set by sources, as native source properties, or can be computed by journy.io as computed properties. Both [types of] properties will eventually be the field names that are mapped against destination fields. The values of these mapped fields (for each account and user) will eventually be synchronised to the matching users and accounts in each active destination.

Native Source Properties

Source properties can automatically be defined and set by a connection (source), if it has the option "Add events and update properties for contacts" selected in the source definition.

The other option is to create it from your SaaS Platform or website, through the Upsert API call.

Adding a Source Property in the journy.io UI

Here's what you need to do step by step:

  • Go to the properties menu

  • Press the [ + ] button in the upper right corner and select "Add source property".

  • Give a name to that property. If you try entering special characters or space, journy.io will either not react or enter an underscore character ('_') instead.

  • Press the "Add" button.

You'll see the property in the list.

Computed Properties

Computed properties are properties that are computed by journy.io, upon changes in account and user journeys. This is core building block for contextual and behavioural intelligence in journy.io.

Adding a computed property in the journy.io UI

Here's what you need to do step by step:

  • Go to the properties menu

  • Press the [ + ] button in the upper right corner and select "Add computed property".

  • Select the topic of the computed property you want to create:

    • Event-related computed properties are calculations based on events and their metadata.

    • User-/Account-related computed properties are calculations related to the relationship between users and accounts. E.g. 'AmountOfAdminUsers' could return a number representing the amount of admins in an account.

  • Give a name to that property. If you try entering special characters or space, journy.io will either not react or enter an underscore character ('_') instead.

  • Select Category, Topic, Function and additional fields for the chosen function.

  • Press the "Add" button.

You'll see the new computed property in the list, and in the 360 customer view, along with all other (native and computed) properties.

Here's a list of popular computed properties:

  • Event-related

    • Counters and occurrences

    • Period over period increase/decrease

    • Daily/Weekly/Month averages

    • First/Last seen dates

    • Count/Sum/Average metadata values

    • First/Last seen metadata values

    • Most frequent metadata values

    • Min/Max metadata values

  • Relationship-based

    • Nr of users with any given user-/account-relationship conditions.

    • % of total users with any given user-/account-relationship conditions.

⚠️ Important note on relationship-based computed properties!

While journy.io comes with relationship conditions in its condition builder, relationship-based computed properties are indispensable when sync'ing downstream ecosystem apps in a B2B environment. If this feature would not exist, the amount of work for creating and maintaining multi-account-multi-user B2B relationship metrics would simply be an incredible burden on the product team.

Deleting a Property

Here's what you need to do step by step:

  • Go to the properties menu

  • Hoover over the property you want to delete, and press the trash icon.

  • Enter confirm and press "Remove" button.

  • Your property is gone from the list, and will not be defined anymore, until a source adds it (as source property only!).

How to set journey properties in JS

You can set journy.io journey properties by a fix set of JS calls, right from within your website or application.

Here's a list of available calls at your disposal:

  • You can use the following script to identify a journy by email.

    journy("identify", { email: "[email protected]" });

  • You can use the following script to trigger an event by tag string.

    journy("event", { name: "download ebook 15" });

  • You can use the following script to set user properties.

    journy("properties", { first_name: "john", last_name: "Doe", age: 27, phone: "+1 606 404040" })

You can find the full API description in: https://developers.journy.io/#section/Frontend


Tip: journy.io offers free onboarding! 🚀

Go to the Onboarding Page and book your 60 minute spot!

Did this answer your question?