Note: ESP = Email Service Provider
Q: Why do I see the Missing/invalid email property error?
Explanation:
This happens when the customer email attribute is either empty or doesn't contain a valid email address format.
Debug:
Check the email attribute value of the impacted customer profiles. In most cases, the failure generates “enqueue_falied” status campaign events where the message attribute contains additional details about the failure.
Fix:
Fix the email attribute of the customer:
- Include the 'email has value' condition in your scenario to avoid attempting to enqueue messages for customer profiles with an invalid email address.
- If possible, also include more complex conditions to filter only valid email addresses (such as “email contains @”, “email contains .”, etc.).
Q: Why do I see the Consent/policy error
Explanation:
This happens in two cases:
- Consents: Customer does not have valid consent for given consent category that is used in the communication node settings.
- Policy: Customer has already received the maximum amount of communication permitted by a given policy that is used in the communication node settings.
Debug:
- Consents: Check the customer profile, if they have valid consent for a given consent category.
- Policy: Check the customer profile for all campaign events with the same policy as the one in the campaign that has failed. Validate if the customer has already received the maximum allowed number of communications from all campaigns with this policy within the defined interval.
Fix:
- Consents: Add a condition to the campaign that checks if the customer has valid consent for a given category. That way, customers that do not have this consent are excluded from the scenario, therefore not entering the communication node, preventing unnecessary “enqueued_failed” campaign events.
- Policy: Ensure that customers are not being targeted by too many campaigns with the same policy setting at the same time intervals.
Q: Why do I get the Bounces/Blocks from ESP level?
Explanation:
This happens when ESP has blocked the customer’s email due to either long-term inability to deliver (multiple soft bounces) or inability to deliver with reason that implies long-term inability to deliver in the future.
Debug:
Check the message attribute of campaign events with soft or hard bounces that precede the suppression and invalidation of the customer.
Fix:
- Make sure that the customer’s email is valid
- Allowlist customer’s email on the ESP level. If Bloomreach is managing your ESP integration, contact your CSM, who will reach out to our emailing team to resolve this issue
For more information about bounce management, refer to this article on Email Tracking and Bounce Management.
Q: Why does the email_invalid attribute set to true lead to suppressed campaigns?
Explanation:
This occurs when the Bloomreach Engagement platform marks a customer profile with an invalid email because of the information it has received from your ESP about the inability to deliver the communication. This happens to prevent any further attempts to send communication to invalid addresses and to preserve your domain reputation, among other reasons.
For more information, read about how sending a communication to invalid email addresses can impact your domain reputation in our guide.
Fix:
Create a report with the following:
- “email_invalid is true” in the customer filter
- “count event invalid_contact” in metrics
- “invalid_contact -> reason” in rows/columns of the report to get information about the reason for the invalidation of the contact
- “invalid_contact -> source, channel, etc.” in rows/columns of the report to get any additional information about the invalidation of the contact
A report of this type gives you all the information you need to understand the reasons why email service providers have decided to invalidate the contact.
After investigating the reasons for the invalidation of contacts, follow the solutions for the Bounces/Blocks from the ESP level section above to avoid the blacklisting of given contacts on the ESP level. After that, set the email_invalid attribute of impacted contacts to False to allow the communication to be enqueued to their email addresses from Bloomreach.
If the whitelisting on the ESP level is done successfully and the contacts are indeed valid and therefore eligible to receive the communication, ESP should send the communication Bloomreach has enqueued for the given customers, resulting in a successful delivery.
Q: Why do I get “Enqueue_failed"?
Explanation:
This might occur if your communication contains any content that can not be rendered successfully due to given circumstances, such as the absence of the data that you are trying to work with using Jinja.
Therefore, the communication is not sent, and the corresponding campaign event with “enqueue_failed” status is recorded under the impacted customer profile.
Debug:
You can preview the message attribute of the campaign events with enqueue_failed for the impacted customer base or campaign to determine the reason behind the failure of sending a given communication.
Fix:
To solve this issue, ensure that all the edge cases are handled correctly and that the provided content behaves as expected for any potential input that it can be rendered with. For example, make sure that there is no data missing for any object that you are referencing, such as an event property or a customer attribute.
📘
A missing email property in a customer profile does not generate enqueue_failed events; the same applies to phones, for example.
Q: Why are my emails aborted?
Explanation:
You can use the {% abort %}
command, which will stop the execution of the code for a specific customer. The abort feature is usually used in combination with an if statement to avoid sending a communication to customers that do not meet certain conditions. For example, using {% abort %} in an email node in a scenario prevents the email from being sent, and the scenario does not continue to subsequent nodes (for the specific customer). If used in an email, you can see the number of aborted customers in the scenario evaluate tab (when you hover over the specific email node).
Debug:
To debug this issue, check the email template that generated this aborted action and look for the {%abort%}
Jinja code. The good practice is to use the syntax {% abort: "Custom message" %}
. In this case, the action will not only be aborted, but it will also add a campaign event with status aborted, and the custom message will be in the message property.
Fix:
To solve this issue, ensure that customers who do not fulfill {%abort%}
Jinja conditions are filtered out before reaching the email node.
Q: Why are my emails filtered between the ESP and the recipient’s mailbox?
Explanation:
If Mailgun has confirmed the delivery of the email, the issue is most likely in the email application of the customer.
Fix:
To debug and solve this issue, check spam/filtering settings and ensure that the application can connect to the recipient email server.
Recommendation:
- Global filters and blacklists (project-level setup).
- Email list hygiene filter allows for project-level filtering of customers who should not receive any email campaign in order to manage the health of the subscribers' list.
Q: Why is my custom web font not properly displayed in my email app when I uploaded it to the Visual editor?
Explanation:
The adoption of custom web fonts across email clients varies. Some email clients have very limited support for custom fonts or no support at all.
The Visual email builder inserts custom fonts into the email code, but it cannot control how those fonts are rendered by an email client app. In case the email client does not support a particular custom font, it uses a fallback font that is defined in the custom font CSS, which is usually a web-safe font of similar properties (serif for serif fonts, etc.).
What is the difference between a web-safe font and a web font?
Web-safe fonts are a set of widespread fonts available on most devices, and most applications support these fonts, including email clients. Web fonts are not-so-popular fonts usually hosted on some CDN like Google fonts or Adobe Fonts and are attached to emails as links in the email’s CSS.
Where can I find more information about custom fonts in emails?
You can find more information on the BeeFee email builder support site. It is a very informative article covering the topics of font support in email apps. Additionally, it provides an overview of custom font support for the most popular email clients.
Q: How do I check consistency between my custom evaluation and the Evaluate tab?
Explanation:
To check how the definitions in the Evaluate tab in Email Campaigns are built and compare them with your custom evaluation, follow these steps:
- Go to the Evaluate tab in Scenarios and navigate to Results in the Evaluate tab.
- View more options by clicking on the three dots in the top right corner of the page next to the Start button).
- Select the Copy email campaign to dashboard option.
- You can check and compare the definitions between the Evaluate tab and your custom evaluation in the new dashboard. View and edit this dashboard like any other regular dashboard.
Q: How do I check consistency between my custom evaluation and the New Evaluate tab?
Explanation:
You can compare the results with the email campaign results tab by manually building the metrics, such as:
- Orders
- Conversion Rate
- Average order value
- Revenue
Note:
Bear in mind that the purchase event must contain the following assets:
- Hours between campaign click and purchase
- Last clicked campaign_id
Q: How do I place an uneven number of columns in a row in the Email Visual Builder?
Explanation:
As an end-user, you may find yourself in a position where you would like to place an odd number of columns in the column layout in the Visual Builder. However, it is not always easy to get an odd number of columns to measure to be the same width each.
Our visual builder uses 12-column layout as it's popular amongst responsive layout systems like Bootstrap because it has many divisors.
Solution:
The answer to the challenge usually lies in the challenge of making sure everything renders properly on all devices. While it might seem like a normal request to have five even-width columns, it actually poses a rendering challenge.
If we went with a 10-column layout, you could make 5 even columns, but not 3, 4, or 6. This is what we mean by the 12-column layout having lots of divisors (2, 3, 4, and 6 can be supported, but unfortunately 5 gets left out.
On that note, it’s possible to have a 5-column same-size “feeling” toying with a 2-3-2-3-2 layout (or other ways to balance the “3" columns) and smart padding/sizing of the content. It’s tricky, doesn’t apply to everything, and might not be pixel-perfect, but it could work as a workaround.
You could also try to apply custom HTML in the Visual Builder template (specifically using the HTML content button), using which they can add a table with a specific number of columns and a set size for each column.
Q: How can you identify all customers who have opened an email using a Gmail client?
Solution:
The easiest way to check which customers opened an email in the Gmail email client is to create a report where you would check opened events and user-agent value in those events.
If the email was opened in Gmail, “GoogleImageProxy" will be included in the user-agent property value in the opened email campaign event. You can also create a segmentation to define those customers if you would like to target only customers who are opening emails in Gmail specifically.
The customer filter for this use case can look like the following example:
You can use this filter anywhere in the platform to filter our customers who are opening emails in Gmail or choose the “not matching” filter to exclude people opening emails in Gmail.
Note:
You can always segment customers based on the email domain, but customers sometimes can have a custom domain instead of the @gmail.com domain, so the domain filter will not be the ideal solution. Using the user-agent is, in this case, a more precise solution for targeting customer using Gmail email clients.