Video Nudges
Learn to configure Video Nudges on Netcore PX dashboard to deliver in-app video experiences.
Overview
The Video Nudge template lets you deliver in-app video experiences without writing custom code or relying on external video tools. You can either host the video yourself and point Netcore PX to the direct file URL or use a YouTube/Vimeo link.
Sub-types
| Sub-type | When to use it |
|---|---|
| Video Only | A video-first nudge with no surrounding text or buttons. Best for short product demos, brand storytelling, quick visual announcements, and tutorials where the video is the message. Supports picture-in-picture behaviour, allowing the user to move the player around the screen while continuing to use the app. |
| Video with Text Announcement and CTA | A richer template that pairs a video with a customisable headline/description and up to two CTA buttons. Best for new-feature announcements, sales and offers, onboarding walkthroughs, and any campaign where you need the user to take an action after watching. |
Pre-requisites
Before you create a Video Nudge, confirm the following:
| Requirement | Details |
|---|---|
| iOS SDK version | Native Smartech Nudges iOS SDK v9.0.32 or above. |
| Android SDK version | Android Smartech Nudges SDK: v10.3.1 |
| Web SDK | Video Nudges are not yet supported on the Web SDK. Support is on the roadmap. |
| Supported video formats | .mp4 files served over https, YouTube links, and Vimeo links. |
Note
If your integrated SDK version is below the minimum, the Video Nudge will not render on the user's device even though it deploys successfully on the dashboard. Verify your app's SDK version before going live.
Supported Video Sources
You can supply the video to a Video Nudge in two ways:
1. Direct .mp4 URL: A direct https:// link to an .mp4 file hosted on your CDN or storage. Use this when you want full control over the video file and its hosting.
2. YouTube or Vimeo link: Standard YouTube or Vimeo URLs of the video you want to embed. Streaming, bandwidth, and quality switching are handled by the respective platform.
Tip
For the best playback experience, upload your video in the highest resolution available. For direct
.mp4files, keep the file size reasonable (we recommend under ~20 MB for in-app playback) to avoid long load times and battery drain on the end user's device.
Use Cases
Refer to the given table to know some of the most common use cases for video nudges.
| Use Case | Recommended Sub-type |
|---|---|
| Product demos and feature walkthroughs | Video Only |
| Brand storytelling and emotional brand films | Video Only |
| Quick visual announcements (sales, drops) | Video Only |
| New-feature announcements with a "Try it now" action | Video with Text Announcement and CTA |
| App version walkthroughs with an "Update / Explore" CTA | Video with Text Announcement and CTA |
| Promotional offers with "Shop Now" / "Learn More" | Video with Text Announcement and CTA |
| Onboarding step with a "Get Started" CTA | Video with Text Announcement and CTA |
Configure a Video Nudge
When you select the Video template in the Nudge Gallery and open the editor, the following configuration sections will be available. Sections marked (Video with Text Announcement and CTA only) will only appear for that sub-type.
Nudge Properties
Controls where the nudge appears and how it can be dismissed.
| Setting | Description |
|---|---|
| Position on screen | Top, Middle Center, or Bottom of the screen. |
| Width | Width of the nudge as a percentage of screen width (30–100%). |
| Background, Opacity, Border Size, Border Color | Available for Video with Text Announcement and CTA. Not applicable for Video Only, which uses a frameless player. |
| Radius | Corner radius of the nudge container. |
| Let users interact with the app | When enabled, the user can continue to use the underlying app while the nudge is on screen. |
| Add Backdrop | Adds a dimmed backdrop behind the nudge. The backdrop is automatically removed if the user drags the video player around the screen. |
| Dismiss Conditions | Choose how the nudge can be closed: Add a Close Icon, Close Automatically, On Click Anywhere Outside Nudge, On Click of Device Back Button. |
| Nudge Event Identifier | A label used to identify this nudge in analytics. |
| Send the event to Analytics provider | When enabled, nudge-level events are forwarded to your configured analytics provider. |
Video URL
Paste your .mp4, YouTube, or Vimeo URL into the Video URL field. The editor validates the URL format:
- Empty URL → "Video URL cannot be empty."
- Wrong format → "Please enter a valid video URL." (for direct files) or "Please enter a valid YouTube or Vimeo URL."
- Wrong protocol → "URL must start with 'http://' or 'https://'."
Player Properties
Controls the on-player behaviour and which controls are visible to the end user.
| Setting | Description |
|---|---|
| Add option to mute | Shows a mute/unmute button on the player. |
| Pause video on tap | Lets the user pause and resume by tapping the video. A play/pause icon is displayed. |
| Play Enlarged (Fullscreen) | Adds a fullscreen toggle. In fullscreen mode, a minimise control returns the video to its original size. |
| Let user move the player | Allows the user to drag the player around the screen (picture-in-picture style). The starting position is set by Position on screen above. |
Video Behaviour
| Setting | Description |
|---|---|
| Loop video | Plays the video continuously on loop. |
| Play muted | Starts the video in a muted state. Recommended when Auto play is enabled. |
| Auto play video with nudge reveal | Starts the video automatically when the nudge appears. If disabled, the user sees a play icon and the video starts on tap. |
Description Editor (Video with Text Announcement and CTA only)
Same editing controls as the Title Text editor in other nudges (e.g. Announcement):
- Title / description text
- Font and font size
- Alignment (Left, Center, Right)
- Line height, spacing, padding
Button Editor (Video with Text Announcement and CTA only)
You can configure up to two CTA buttons per nudge.
| Setting group | Options |
|---|---|
| Show Secondary Button | Toggle a second button on or off. |
| Text properties | Button label text, font, font size. |
| Styles | Button style (Button / Filled), text colour, fill colour, border colour, radius, padding, spacing. |
| Action | What happens when the button is tapped: Close Prompt, Launch URL, or Invoke Action. |
Close Button Editor (available only when "Add a close icon" is selected)
Style the close icon shown on the nudge.
| Setting group | Options |
|---|---|
| Styles | Button style (Button / Filled / Icon), text colour, button size, fill colour, radius, spacing. |
| Action | Close Prompt, Launch URL, or Invoke Action. |
Mute Button Editor (available only when "Add option to mute" is selected)
| Setting group | Options |
|---|---|
| Styles | Button style (Button / Filled / Icon), text colour, button size, fill colour, radius, spacing. |
Enlarge Button Editor (available only when "Play Enlarged" is selected)
| Setting group | Options |
|---|---|
| Styles | Button style (Button / Filled / Icon), text colour, button size, fill colour, radius, spacing. |
2.5 Editor Settings Visibility: Quick reference
| Editor Section | Video Only | Video with Text Announcement and CTA |
|---|---|---|
| Nudge Properties | ✅ | ✅ |
| Video URL | ✅ | ✅ |
| Player Properties | ✅ | ✅ |
| Video Behaviour | ✅ | ✅ |
| Description Editor | ❌ | ✅ |
| Button Editor | ❌ | ✅ |
| Close Button Editor (conditional) | ✅ | ✅ |
| Mute Button Editor (conditional) | ✅ | ✅ |
| Enlarge Button Editor (conditional) | ✅ | ✅ |
Best Practices
- Keep videos short. In-app nudges work best with videos under 30 seconds. Longer videos are better off being linked out to via a CTA than embedded in-app.
- Default to muted autoplay. Most users open apps in public or quiet settings. Combining Auto play with Play muted and showing the mute / unmute button gives the best balance of attention and respect.
- Use the highest resolution source you can. PX does not transcode videos. Quality on the device matches the quality of the file you provide.
- Pair video with a CTA when you want action. If your goal is anything other than passive awareness (e.g. visit a screen, redeem an offer, update the app), use the Video with Text Announcement and CTA sub-type rather than the Video-only one.
- Test on a real device. Use Test Mode to preview the nudge on a physical device before deploying — playback behaviour, controls visibility, and dragging feel can differ between the dashboard preview and the actual device.
Updated about 12 hours ago