Understanding why nudges are not shown

This guide will help you understand the nudge diagnosis results, i.e. how many users are not seeing the nudges and why.

📘

Below are SDK version prerequisites for getting results of nudge not shown count along with reasons. Please ensure to upgrade your SDK:

  • Android Smartech Nudges SDK v8.9.0 and above and Android Base SDK v3.2.27 (modular SDK) or Android SDK v3.1.40 (non-modular SDK) onwards.
  • iOS Smartech Nudges SDK support - Releasing soon!
  • This feature is also available on Web JS SDK.

We've enhanced the nudge results analytics with 'nudge-not-shown' reasons. You can find it under the - nudge results > Diagnosis tab. Details of each data point is mentioned below:

14421442
  • Overall population - This is the unique count of users satisfying a given branch condition, be it a segment or a variant branch.
  • Unique trigger count - This is the unique count of users doing the trigger event. This is calculated as unique of nudge shown and nudge not shown events
  • Users not nudged - This is the unique count of users who performed the trigger event but the nudge was not shown to such users due to various reasons.

In the subsequent section, you will see a graph of overall users not nudged. Further down, we have provided bifurcation of different reasons for which nudges are not shown to the users

ReasonDetailsCorrective Action
Device criteria not matched that includes app version, device, OS, OS version, manufacturer, SDK version"This reason is shown when a user doesn't satisfy conditions related to app version, device make and model, OS, OS version or SDK version.You can review if conditions are set correctly as per the usecase. If yes, then this is expected behavior.
The repeat frequency condition is not metThis error signifies that the nudge repeat condition criteria is not met and hence nudge is not shown to a userThis is expected behavior as per the repeat condition set for a given nudge. You can review the criteria if it's correct as per the usecase.
The stop condition based on scheduled timeout is metThis error signifies that the nudge stop condition based on scheduled timeout is not met and hence nudge is not shown to a userThis is expected behavior as per the stop condition based on scheduled timeout set for a given nudge. You can review the criteria if it's correct as per the usecase.
The stop condition based on number of nudges shown or event occurred is metThis error signifies that the nudge stop condition based on number of nudges shown or event occurred is not met and hence nudge is not shown to a userThis is expected behavior as per the stop condition based on number of nudges shown or event occurred that is set for a given nudge. You can review the criteria if it's correct as per the usecase.
Screen name is not matching with given screen nameThis error is shown when the screen name on the device and the screenshot captured on the PX panel is not matching. Due to this mismatch, nudge is not shown.We recommend to ensure fire trigger event in the activity where nudge is placed
Nudge anchor view is nil or hiddenThis error is shown when the anchor element to which nudge is attached is nil or hidden and hence nudge can't be placed there.-
Nudge anchor point is outside of window boundsThis error is shown when the anchor element to which nudge is attached is falling outside of the window bounds (say e.g. element is partially visible and below the scroll) and hence nudge is not shown in this case.We ensure to not place the nudge if element is partially visible. If user doesn't scroll, such nudge is dropped. While this is driven by user behavior, you can try implementing correct trigger event for showing the nudge when achored element is visible on the screen.
Nudge anchor point falls outside of its parent viewThis error is shown when the anchor element to which nudge is attached is falling outside of its parent view and hence nudge is not shown in this case.Please ensure the right anchor element is selected and it is consistent across different app versions.
Nudge anchor point is overlapped by another viewThis error is shown when the anchor element to which nudge is attached is getting overlapped with another view. Nudge is not shown in this case.To fix this issue, ensure that you are selecting the right element to place the nudge and ensure it is not getting overlapped with another view. You can also implement hansel_ignore_view method to ignore overlapping transparent views.
Not enough space to show nudgeWhen a given nudge doesn't get enough height to render on a given device, nudge is not displayed to the user. This is typically applicable for anchored nudges such as tooltip, beacons set near edge of the screen.In such cases, you can select auto-position setting for nudges where our SDK will decide either top or bottom position for the nudge rendering if given height is not enough for showing the nudge.
View hierarchy is not matching compared to screen captured for the nudgeThis error is shown when the screen view hierarchy on user's device vs the screen captured on the PX panel is different. Due to the difference in view hierarchy, nudge is not shown to a user.In this scenario, you should ensure the view heirarchy of a given screen does not change across different app versions. If it does, we recommend to recapture the screen on PX panel with latest app version.
App level frequency cap has metThis error signifies that the repeat condition criteria is not met and hence nudge is not shown to a userThis is expected behavior as per the repeat condition set for a given nudge. You can review the criteria if it's correct as per the usecase.
Criteria mismatched for trigger event having event property conditionThis error signifies that the event property condition set in the trigger condition of the nudge is not matching, and hence nudge is not shown a userThis is expected behavior as event property condition is not met. You can review the criteria if it's correct as per the usecase.