Pass a known customer into an experience

Send a customer you already know into an experience, through your customer-account sign-in or, with OmniLab's help, with no sign-in screen.

2 min read

Add one parameter to the experience address: fci, carrying the identifier your own system uses for that person. It's how a scanned loyalty card, or a tap inside your app, skips the anonymous start.

When to use it

  • A kiosk in-store: a member scans their loyalty card, and the kiosk adds the scanned value to the address.
  • Your mobile app: the app knows who's signed in, and passes them through.
  • A personalised email or link: a message to a known contact opens the experience for that contact.

When you don't know who the visitor is yet, let them sign in inside the experience instead: see About customer accounts.

The address

https://play.lindenhall.example/<campaign-public-link>?fci=<your-identifier-for-the-customer>

Use whatever your own system identifies that person by, such as a loyalty card number, a member ID or a CRM contact ID.

What it does

SetupWhat the visitor sees
Customer accounts connectedThe experience skips the anonymous start and opens your customer-account sign-in
Customer accounts connected, plus a recognition integration for the campaignThe identifier signs the customer in on its own: no sign-in screen

A recognition integration is set up by OmniLab for each campaign. Ask your Customer Success Manager before you plan a kiosk or app journey that depends on an instant start.

If the visitor comes back without being signed in, a dialog they can't close says their account couldn't be found.

Test the unrecognised case on purpose

A value that isn't recognised never falls back to an anonymous session. Pass a made-up identifier, or scan a card that shouldn't work, and check what a customer sees when their card is mistyped, expired or from another programme. On a kiosk, that's the difference between a clear message and a dead screen.

For your developer

  • fci forces a signed-in session, whatever the visitor's previous session was.
  • Once signed in, the visitor's participation is attributed to that contact.
  • fci keeps applying as the visitor moves through the experience.

Reword the account-not-found dialog

The dialog's default title is "Wrong Identity". Its text says "We couldn't find your user. Please close the page and try again." A kiosk visitor can't close the page. Tell them to try the kiosk again, or to ask a member of staff.

In each campaign that receives fci, follow Change the wording. Open the Global group. Edit fci.identity.error.title and fci.identity.error.description.

Next steps

On this page