Configuring the events
In our scenario, we need to receive an event each time a person enters the Marlton hotel and the restaurant. The technical user needs to configure the two events we want the system to listen to in our journey.
For additional information on event configuration, refer to About events .
- In the top menu, click the Events tab and click Add to create a new event.
- We enter the name with no spaces or special characters: "LobbyBeacon".
- We then select the schema and define the payload expected for this event. We select the fields needed from the XDM normalized model. We need the Experience Cloud ID to identify the person in the Real-time Customer Profile database: "endUserIDs > _experience > mcid > id".We also need the registration token to send push messages: "_experience > campaign > message > profile > pushNotificationTokens > token"An ID is automatically generated for this event. This ID is stored in the eventID field ("_experience > campaign > orchestration > eventID"). The system pushing the event should not generate an ID, it should use the one available in the payload preview. In our use case, this ID is used to identify the beacon location. Each time a person walks near the lobby beacon, an event will be sent containing this specific event ID. The same principle applies to the restaurant beacon events. This allows the system to know which beacon triggered the event sending.The list of fields varies from one schema to another. According to the schema definition, some fields may be mandatory and pre-selected.
- We need to select a namespace. A namespace is preselected based on schema properties. You can keep the one preselected. For more information on namespaces, see Selecting the namespace .
- A key is preselected based on schema properties and the namespace selected. You can keep it.
- Click Save .
- Click the View Payload icon to preview the payload expected by the system and share it with to the person responsible for the event sending. This payload will need to be configured in the postback of the Mobile Services administration console.
In the same way, create the "RestaurantBeacon" event. Your two beacon events are created and can now be used in our journey. You now need to configure the mobile application so that it can send the expected payload to the Streaming Ingestion APIs endpoint. See Additional steps to send events to Journey Orchestration .