1. Hello World Journey

This guide walks you through building your very first DataSapien Journey end to end — from initialising the Mobile SDK in your app, to designing the Journey on the Orchestrator, to running it on a device.

By the end you will have a working "Hello, World" Journey that:

1. Collects a piece of MeData (the user's favourite colour) on the device.
2. Asks the user their name in a Question step.
3. Composes a personalised greeting in a Script step.
4. Displays the greeting on a Screen step.

The flow you'll build:

┌───────┐   ┌────────────────┐   ┌────────────────┐   ┌────────────┐   ┌──────────────────┐   ┌─────┐
│ Start │ → │     MeData     │ → │    Question    │ → │   Script   │ → │      Screen      │ → │ End │
└───────┘   └────────────────┘   └────────────────┘   └────────────┘   └──────────────────┘   └─────┘
              favorite_color       user_name            greeting        displays {{greeting}}

Step	What it does	JourneyContext after
MeData	Asks "What is your favourite colour?" (the question on the favorite_color MeData) and stores the answer in the on-device data vault.	favorite_color
Question	Asks "What's your name?" — answer kept only in the JourneyContext, not persisted as MeData.	+ user_name
Script	Reads favorite_color and user_name, builds a greeting string, writes it back.	+ greeting
Screen	Renders a Text component bound to {{greeting}}.	(unchanged)

Prerequisites

Before you start, make sure you have:

• An Orchestrator account and a set of configuration keys (auth URL, client ID, client secret, host URL, media URL). These are provided after registration — contact us if you do not have them yet.
• A mobile app project to embed the SDK into. You can use any existing app, or a fresh empty one. Detailed install guides per platform: iOS, Android, Flutter, React Native.
• Access to the Orchestrator web UI in your browser.
• About 30 minutes.

Concepts you'll meet

You'll touch a handful of concepts in this guide. Each one is explained briefly inline and linked to its full reference page:

• MeData — a piece of personal data collected and stored on-device.
• MeData Definition — the schema describing a MeData (its source, value type, etc.).
• Journey — a designed flow that orchestrates screens, data collection and logic on-device.
• Step — a single node in a Journey flow (MeData, Screen, Question, Script, Start, End).
• JourneyContext — the per-execution variable bag steps read from and write to.
• Audience — the target user group for a Journey. We'll use the built-in All Audience.