Overview
Everything you configure in Extole is a component. A campaign is a component, and so is an integration, a reward, or a rule. Every component works the same way. It has a name and a description that say what it does, one or more types that say what kind of component it is, and settings that you change to fit your program. When you know how to work with one component, you know how to work with all of them.The Components You Start From
These are the components you meet first. Each one stands on its own in your account.Campaigns
What your participants see and do: who takes part, what they do, and what they earn.
Integrations
Connections to external systems, which send events to Extole or receive them from it.
Extensions
Capabilities you add to the account, such as monitors, jobs, and the events your site and apps send.
Account Settings
Settings for the whole account, such as your company name, logo, fonts, and colors. Your programs and campaigns use them.
Components Inside Components
You configure a component largely by choosing the components inside it. A campaign shows the shape:Components Reference Components
A component can also reference a component that it does not hold. A business event shows how. Its Triggered By setting references a trigger event, and that trigger event belongs to another component, such as the JavaScript SDK extension. A trigger event describes an event that arrives from outside the campaign, such as theconversion event your website sends. A business event is what the campaign records when that event qualifies.
Where Components Come From
You add a component by copying one that exists. A copy can come from two sources:- Your account. Any component your account already has.
- A library or another account. A library is an account that exists to share its components, such as Extole’s own components or a partner’s integration. The other account grants your account access to its components, and your account subscribes to them. Once your account subscribes, those components appear among the ones you can copy.
Working with Components
You work with every component in four steps:- Find the component. Look at what your account has, or at what you can add to it. A component’s types tell you what kind of component it is and where it fits.
- Read what it says about itself. A component has a description, and so does each of its settings. The description is the documentation for that component.
- Configure its settings. Set a value, choose a component to place inside it, or choose a component for it to reference.
- Validate the result. Preview the change or test it in a draft before you publish.
All three work with the same components, so a change you make in one appears in the others.
Upgrading Components
A component copied from a library can be upgraded. When the library’s component gets a new version, you can bring your copy to that version. An upgrade keeps your settings: the values you set, the components you placed inside the component, and the components it references. An upgrade replaces everything else. A component can also be changed beneath its settings, in the elements that carry out its behavior. An upgrade does not keep that kind of change, so you make it again after each upgrade. Change a component through its settings whenever you can. When a component has no setting for what you need, look for another component that offers it before you change one beneath its settings.From Configuration to Runtime
A component exists in three forms.Build
Extole builds a component each time you save it. The build works out every value that configuration alone can decide:- A fixed value stays as it is.
- A setting you have not changed takes the value of the component it was copied from.
- An expression that depends on other settings is worked out, and the built component holds the result.
Runtime
At runtime, the built component responds to events. The same built component serves every person, and it works out the remaining values for each one. A greeting that includes a person’s first name shows the difference. The component holds the expression. The built component still holds it, because no person is known yet. The running component works it out for each person who arrives. Nothing changes at runtime until you change the configuration. A change becomes a new built component, and your participants reach it when you publish.Which Form to Look At
What Components Do at Runtime
At runtime, Extole works with events and people, and your components decide what happens to each event.- An event arrives from your site, your app, your servers, a file, or an integration. Extole finds or creates the profile of the person it belongs to.
- Targeting finds the business events this event can start and chooses the campaign that applies to this person. Your audiences and rules decide which campaign that is and whether the event qualifies.
- Extole records the business event in the person’s journey.
- The business event’s actions run: show an experience, send an email, call a webhook, or earn a reward.
