How to show delivery progress on the lock screen

Let customers follow the courier on the lock screen from order placed until delivery. This guide builds that journey with the Live Activity element.

Prerequisites

• Your iOS app supports Live Activities. See the iOS SDK Live Activities guide.
• A delivery widget schema is published for this app. See iOS Live Activity schemas configuration.

Create the events

These are example event names for this guide. When your app or backend sends a name for the first time, Pushwoosh creates that event automatically. Create the events in the Control Panel first only if you want to set attribute types yourself before the first send.

Create (or reuse) the events OrderPlaced, CourierStatusChanged, and OrderDelivered.

Learn more about creating events

Build the journey

Open Customer Journey Builder, create a campaign, and build everything below on one canvas.

1. Go to Campaigns → Customer Journey Builder.
2. Click Create campaign.
3. Click Build a journey from scratch.

Set the entry

1. Add a Trigger-based entry element to the canvas.
2. Set it to OrderPlaced.

Start the order card

1. Add a Live Activity element after the entry.
2. Name it Order card start.
3. Set Action to Start.
4. Select the delivery Widget and Schema version.

5. Set Card key: event to OrderPlaced.

6. Fill Card content (courierName, eta, distanceMeters) and the alert fields.

7. Click Apply.

Wait and update the card

Continue on the same canvas after the Start element.

1. Add a Wait for Trigger element.
2. Wait for CourierStatusChanged.
3. Set a waiting period that fits your delivery updates.

4. On the branch that fires when the event happens, add a Live Activity element.
5. Name it Order card update.
6. Set Action to Update.
7. Choose the same Widget and Schema version.

8. Select Order card start in Card created by.

9. Update Card content.

10. Click Apply.

Wait and end the card

Continue on the same canvas after the Update element.

1. Add another Wait for Trigger element.
2. Wait for OrderDelivered.

3. On the branch that fires when the event happens, add a Live Activity element.
4. Name it Order card end.
5. Set Action to End.
6. Choose the same Widget and Schema version.
7. Select Order card start in Card created by.

8. Set alert and Dismiss after, min if needed.

9. Click Apply.

What the customer sees

On the lock screen, the customer gets one Live Activity card that changes as the delivery progresses. For example:

After the order is placed

Courier Alex M., ETA 18:30, distance 1200 meters.

When courier status changes

The same card updates, for example courier Alex M., ETA 18:15, distance 400 meters.

On delivery

The card closes and leaves the lock screen.