How to Set Up Completion Events in Tiled

A completion event fires when a viewer does something you have defined as meaningful: views a specific page, watches a video, clicks a hotspot, or spends a set amount of time in the microapp. Completion events feed into engagement analytics and the Tiled Score. They also notify external systems via webhook when you need to trigger an action outside of Tiled.

• Permissions: Editor or Admin permissions on the microapp you are editing

• Webhook: A webhook endpoint set up to receive incoming POST requests (for webhook notifications only)

Tiled supports four types of completion events. Use whichever fits how you want to measure engagement. You can combine more than one in the same microapp.

1. Page, State, or Overlay Completion

Use this when you want to know that a viewer reached a specific page: a pricing page, a next-steps page, or a final training screen.

1. Open the microapp in the Builder.

2. Navigate to the page, state, or overlay you want to mark.

3. Find the Completion slide bar in the top right of the Builder.

4. Move the slider to the right until it turns green.

A green checkmark appears below that page's thumbnail in the Microapp pages panel, confirming it is set.

2. Video Tile Completion

Use this when you want a completion event to fire based on video playback rather than just landing on the page.

5. Select the Video Tile on your page.

6. In the tile's properties, find the Completion slider.

7. Move the slider to the right to enable it.

When the video plays, Tiled records it as a completion event for the microapp.

3. Hotspot Completion

Use this when the meaningful action is a click: a Contact Us link, a Get Started button, or any other call to action.

8. Select the Hotspot Tile.

9. Move the Completion slider to the right.

4. Duration-Based Completion

Use this when total time spent is what matters, rather than a specific page or action. Useful for training content where dwell time signals engagement.

10. Open Microapp Settings > General.

11. Find the Completion field.

12. Set the duration a viewer must spend in the microapp for a completion event to fire.

Completion events stay inside Tiled by default, showing up in analytics and the Tiled Score. If you also want them to trigger an action outside of Tiled, configure a webhook.

How It Works

Each microapp has one webhook URL. Every time that microapp registers a completion event, from any of the methods above, Tiled sends an HTTP POST request to that URL. Your endpoint receives the request and acts on it: send a Slack message, update a CRM record, fire a custom analytics event, or anything else your system supports.

Steps

13. Set up an endpoint on your side that accepts incoming POST requests.

14. In the microapp's settings, enter your endpoint as the webhook URL.

15. Build out the logic on your endpoint to handle incoming completion event data.

Payload

Each POST request sends this JSON payload:

{

"userId": "example@recipient.com",

"microappId": "5ca668834b320d1f53dc7bab",

"microappName": "Test microapp",

"completionName": "cmptscreen5cca158fa969a00eee04ba12"

}

Field reference:

Verify It Worked

• Publish the microapp, share it, and view it yourself or have a colleague view it to trigger the completion.

• Check the microapp's engagement analytics. Completions appear there and factor into the recipient's Tiled Score.

• If you configured a webhook, confirm the request arrived at your endpoint. webhook.site shows incoming requests in real time during setup and testing.