Common Personalization Errors and FAQs

Personalization failure occurs when you use a user attribute or event attribute that is not present in the MoEngage dataset and do not configure a fallback.

Personalization Errors

You can see personalization errors in the Failed to Send error category in the Error breakdown table. Click See breakdown in the Name column for personalization errors to get a detailed view of the number of users for whom personalization has failed and the reasons for failure.

If you configure custom Jinja errors using the MOE_NOT_SEND tag, the error breakdown section on the campaign’s analytics page displays your specific message whenever a defined delivery condition is failed.

Personalization Failure Analysis

The Personalization failure analysis helps you identify specific attributes that cause personalization failures and offers in-depth insights into these causes.
Personalization errors can be classified into the following categories:

Error Category	Description
User Attribute	This denotes the unavailability of the user attribute used in personalization because it is unavailable in the system (for example, copy-paste errors) or for a specific user. For example, if the first_name user attribute is used in personalization and unavailable for a user, this will result in a User Attribute error.
Event Attribute	This denotes the unavailability of the user attribute used in personalization because it is unavailable in the system (for example, copy-paste errors) or for a specific user. For example, if the product_name event attribute is used in personalization and unavailable for a user, this will result in an Event Attribute error.
Campaign Attribute	This denotes an unavailability of campaign-specific information used in personalization. For example, if campaign tags are used for personalization and a campaign tag attribute is missing, this will result in a Campaign Attribute error.
Undefined	This denotes errors that happen when MoEngage cannot fetch the value for the attribute used in personalization. For example, if the image attribute is unavailable for a specific product in a product set, this will result in an Undefined error.
Unknown	This denotes any error that does not fall into the abovementioned categories.
Custom Error Message	This uses the MOE_NOT_SEND Jinja tag to define a specific reason for delivery failure when content personalization conditions are not met. This provides explicit insight into why targeted users did not receive the message due to data or attribute issues.

The number of failures listed in the Personalization Failed category under Failed to Send denotes the unique number of users for whom personalization has failed. In some cases, this might differ from the count shown in the Personalization failure analysis pop-up window, as multiple failures can happen for the same user and might be counted under each failure category shown in the UI. For example, if a user were to have a user attribute and event attribute failure, they would be counted for the number of failures in both these sections in the analysis page. In contrast, they would be counted as one in the Personalization Failed section.

Personalization Failure

Consider a scenario where you have personalized both the template and backup notifications but not added the personalization fallback. In this situation, if the personalization fails for the template or backup, the notification will not be sent to any users. This is because the template and backup are considered to be part of one payload. Because the personalization fallback does not exist, MoEngage won’t have any alternate message to send to the user in case of failure.

To avoid this issue, make sure that you add a personalization backup to your messages.

Internal Errors

MoEngage internal system generates a few errors, which apply to Push messages sent to all platforms.

Error	Description
Personalization Failed	This occurs when Push Personalization fails, and you have not configured a fallback message. MoEngage will not notify the user and will generate the Personalization Failed error.