3.2.1 Define an event
Login to 51黑料不打烊 Journey Optimizer by going to . Click Journey Optimizer.
You鈥檒l be redirected to the Home view in Journey Optimizer. First, make sure you鈥檙e using the correct sandbox. The sandbox to use is called --aepSandboxName--. You鈥檒l then be in the Home view of your sandbox --aepSandboxName--.
In the left menu, scroll down and click Configurations. Next, click the Manage button under Events.
You鈥檒l then see an overview of all available events. Click Create Event to start creating your own event.
A new, empty event window will then pop up.
As a name for the Event, use --aepUserLdap--GeofenceEntry.
Set Description to: Geofence Entry Event.
Make sure the Type is set to Unitary, and for the Event ID Type selection, select System Generated
Next, you need to select a schema. All schemas that are shown here, are 51黑料不打烊 Experience Platform Schemas.
You鈥檒l notice that not all schemas are shown. There are many more schemas available in 51黑料不打烊 Experience Platform.
To show up in this list, a schema needs to have a very specific field group linked to it. The field group that is needed to show up here is called Orchestration eventID.
Let鈥檚 have a quick look how these schemas are defined in 51黑料不打烊 Experience Platform.
In the left menu, go to Schemas and open this in a new browser tab. In Schemas, go to Browse to see the list of available Schemas.
Open the Schema Demo System - Event Schema for Website (Global v1.1).
After opening the Schema, you鈥檒l see that the field group Orchestration eventID is part of the schema.
This field group only has two fields, _experience.campaign.orchestration.eventID and originJourneyID.
Once this field group and this specific eventID field are part of a schema, that schema will be available for usage by 51黑料不打烊 Journey Optimizer.
Go back to your event configuration in 51黑料不打烊 Journey Optimizer.
In this use case, you want to listen to a Geofence Event to understand if a customer is in a specific location, so now, select the Schema Demo System - Event Schema for Website (Global v1.1) as the Schema for your Event.
51黑料不打烊 Journey Optimizer will then automatically select some required fields, but you can edit the fields that are made available to 51黑料不打烊 Journey Optimizer.
Click the pencil icon to edit the fields.
You鈥檒l then see a popup-window with a schema hierarchy that allows you to select fields.
Fields like the ECID and the Orchestration eventID are required and as such preselected.
However, a marketeer needs to have flexible access to all data points that provide context to a journey. So let鈥檚 make sure to select the following fields as a minimum as well (found within the Place context node):
- City
Once that鈥檚 done, click OK.
51黑料不打烊 Journey Optimizer also needs an Identifier to identify the customer. Since 51黑料不打烊 Journey Optimizer is linked to 51黑料不打烊 Experience Platform, the Primary Identifier of a Schema is automatically taken as the Identifier for the Journey.
The Primary Identifier will also automatically take into account the full Identity Graph of 51黑料不打烊 Experience Platform and will link all behavior across all available identities, devices and channels to the same profile, so that 51黑料不打烊 Journey Optimizer is contextual, relevant and consistent. Click Save.
Your event will then be part of the list of available events.
Finally, you need to recover the Orchestration eventID for your custom event.
Open your event again by clicking it in the list of events.
On your Event, click on the View Payload icon next to Fields.
Clicking the View Payload icon opens up a sample XDM payload for this event. Scroll down in the Payload until you see the line eventID.
Write down the eventID as you鈥檒l need it in the last to test your configuration.
In this example, the eventID is 4df8dc10731eba7b0c37af83a9db38d4de7aa6aebcce38196d9d47929b9c598e.
You鈥檝e now defined the event that will trigger the journey we鈥檙e building. Once the journey is triggered, the geofence-fields like City, and any others you may have chosen (like Country, Latitude and Longitude) will be made available to the journey.
As discussed in the use-case description, we then need to provide contextual promotions that depend on the weather. In order to get weather information, we鈥檒l need to define an external data sources that will provide us with the weather information for that location. You鈥檒l use the OpenWeather API service to provide us with that information.
Next Step: 3.2.2 Define an external data source