Knowledgebase

Featured article

Included in this article Overview Data you’ll get from Email Bounces Bounce Categories Hard Bounces Soft Bounces Bounce Details Building the Directory 1. Create 6 custom fields 2. Create a Program to house everything 3. Create a Static List 4. Create two Smart Campaigns Smart Campaign One - Logging Email Bounces with Bounce Details Smart Campaign Two - Remove Leads From the List After Successful Deliveries 5. Create Custom List View Showing Bounce Details Overview Bounce activities carry details for why the email was bounced, but it’s housed within the activity log entry, not in a field on the lead record, so it’s difficult to export that data. This article will show you how to extract that information to create a directory of leads bouncing emails and how to make the list automatically update. This will also create counters for bounces and successful re-deliveries after bounces happen. Data you’ll get from Email Bounces Bounce Categories Email bounces come in different types depending on why the email was bounced; Hard Bounces or Soft Bounces. Hard Bounces Hard Bounces come in two types, Category 1 and Category 2. Category 1 bounces are emails that have been marked as spam by the recipient mail server. Many email servers monitor blacklists or spam traps, so after de-listing with them, leads that have had a Category 1 bounce previously may be able to receive emails again. Category 2 bounces occur due to an email address that is invalid or doesn’t exist. Soft Bounces Soft Bounces come in three different types, Categories 3, 4 or 9. Category 3 bounces are usually temporary, caused by full mailboxes, timeouts, or throttling. Any email with this designation has been retried for up to 24 hours (36 for AOL). Category 4 bounces are caused by technical problems, Transient Failures, Admin Failures, DNS Failures. Any email with this designation has been retried for up to 24 hours (36 for AOL). Category 9 bounces are unknown, undetermined or gibberish details. Any email with this designation has been retried for up to 24 hours (36 for AOL). Bounce Details When an email is bounced, the recipient mail server includes details of why it was bounced. These are created by the admin of the recipient mail server and vary greatly, but most will give some explanation that can give valuable information. Email Bounce Codes Building the Directory 1. Create 6 custom fields You’ll need 6 custom fields, two DateTime fields, two Score fields, and two String fields Name the DateTime fields “Bounce Date” and “Email Delivered After Bounce”. Name the Score fields “Email Bounces” and “Deliveries After Bounces” Name the String fields “Email Bounce Details” and “Email Bounce Category” Directions for creating Custom Fields can be found here: Create a Custom Field in Marketo 2. Create a Program to house everything Use a default program type and name it "Directory of Leads Bouncing Emails". Info on creating programs can be found here: Create a Program 3. Create a Static List This static list will be your actual directory that contains all of the leads that are currently bouncing emails. Name it "Active Bounce List". Info on creating a static list can be found here: Create a Static List 4. Create two Smart Campaigns These two Smart Campaigns are what will be used to add and remove leads from your active bounce list. Info on creating Smart Campaigns can be found here: Create a New Smart Campaign Smart Campaign One - Logging Email Bounces with Bounce Details Your first Smart Campaign will be used to listen for any email bounces that occur. The campaign will populate the “Bounce Date”, “Email Bounce Category” and “Email Bounce Details” fields. It will then add one point to the “Email Bounces” score field which can be used to count how many bounces have occurred per lead. Lastly, the campaign will add the lead to the static list which will be an active directory of leads who are bouncing emails. Campaign Smart List Use the two triggers of “Email Bounces” and “Email Bounces Soft” in the Smart List. Set both triggers to “is any” so that they will fire whenever any email bounces for any reason. Campaign Flow The Flow of the campaign will have 5 flow steps. The flow will use a System Token and some Trigger Tokens, which can be used to pull details out of the action that activated the trigger. In this case, the Trigger Tokens will be pulling out the details on why the emails were bounced. That info is in the bounce message and is logged in the lead's activity log. Normally you'd have to comb through the activity log one at a time to find these details for each individual lead. This method, however, will pull the details out automatically for all leads. Flow Step 1: Change Data Value Attribute: “Bounce Date” New Value: {{system.dateTime}} Flow Step 2: Change Data Value. Attribute: “Email Bounce Category” New Value: {{trigger.category}} Flow Step 3: Change Data Value Attribute: “Email Bounce Details” New Value: {{trigger.details}} Flow Step 4: Change Score Score Name: “Email Bounces” Change: +1 Flow Step 5: Add to List List Name: “Active Bounce List” Smart Campaign Two - Remove Leads From the List After Successful Deliveries Campaign Smart List The Smart List of the campaign will need a trigger for “Email is Delivered” set to “is any” and also a filter of “Member of List” looking just for leads that belong to your Static List. This way, the campaign will only apply to leads who have had an email bounce but have then had an email successfully delivered afterwards. Campaign Flow The Flow of the campaign will have 3 flow steps to do the following; log when the email was delivered, add a point to the "Deliveries After Bounce" Score Field, and remove the lead from the "Active Bounce List". Flow Step 1: Change Data Value Attribute: “Email Delivered After Bounce” New Value: {{system.dateTime}} Flow Step 2: Change Score Score Name: “Deliveries After Bounces” Change: +1 Flow Step 3: Remove from List List Name: Operational.Active Bounce List 5. Create Custom List View Showing Bounce Details The custom fields you’ve created for email bounce information won’t show automatically in the view of your list. You can create a new view of the list to show just this information so that when it is exported it will give you only the email bounce information you need. Once the list has the necessary details, it can be exported with those columns included so that you can work with it. You can identify emerging trends and issues with your deliverability by looking for common themes among the bounce details. Directions for creating Custom Views can be found here

Issue You have been receiving form submissions that appear to have bogus/nonsensical data in the fields, such as "kjsag@sm4.to" for email address, or "111-111-1111" for phone number, or in a Comment field other random nonsensical text. Solution Currently, there are no default settings in Marketo that prohibit a form submission if the required fields are filled out. A great workaround for addressing these bogus form submissions in Marketo is to implement a 'honeypot' field on the form. To do this, you will need to create a custom Marketo field, string type, and name it something distinctive (such as "spam" or "honeypot"). After creating this field in Marketo Admin > Field Management, place this new field on the form as a hidden field. Real live end-users do not see hidden fields, but spam bots will see them and fill out all available fields. So now when we see form fills with this honeypot field "not empty," we know that it was a bot fillout. Setting up the Honeypot Field Say that you have a Trigger Campaign that's having some issue with these spam/bogus form fills. In the flow of this campaign, you can add a flow step at the top: Remove from Flow, with a Choice. Choice: If Honeypot field Is not empty, then remove from flow Default: do nothing This way, the lead record is removed from the flow. You can also have other campaigns to handle these bogus form fills, such as a daily recurring batch to delete the record. Other Options Another method of dealing with bot fillouts is to enable a reCaptcha. In fact, a very prolific Marketo user has written custom code that you feasibly could use to enable a reCaptcha on the form! Check this out: https://codepen.io/figureone/pen/meybqN?editors=0110

Issue You want to have one email address in the From field ( abc@test.com) a different email address in the Reply-To (all@test.com)? Solution Yes, you can use different email addresses in the From and Reply-To. If the Reply-To is an email alias that sends to a group, you should confirm that email is working and able to receive email. Please note: Automatic replies, such as out-of-office notifications will be sent to the From address, not the Reply-To. Reply-To is only used when the person who received the email clicks the Reply button in their email client. Note :- The SMTP envelope sender typically appears as <uniqueidentifier>@*.mktomail.com. You will only receive responses of this nature if you have configured a branded sender for your subscription. While this serves as the correct destination for auto-responses, regrettably, it is frequently overlooked.

Issue Sometimes email addresses that are CC'd can have emails bounce. This doc describes what to expect in these scenarios. Solution Sending Emails To address is valid, cc address bounces The email will be sent to the recipient but the cc'ed recipient will not receive it (since the address is invalid). Nothing in the Marketo UI will communicate that the email to the cc'ed address was undeliverable. To address bounces, the cc address is valid The email to the recipient will bounce normally. The cc'ed recipient will still receive a copy of the email. Nothing in the email sent to the cc'ed recipient will tell them that the To: the address was undeliverable. To address is valid, cc address is unsubscribed The email to the recipient will deliver normally. The unsubscribed cc address will not receive the email. Nothing in the UI will reflect that the cc'ed recipient did not receive the email because of an unsubscribe setting. The cc'ed address will not appear in the Send Email activity under the cc'ed attribute. Email Delivered This will not include details of the cc'ed email addresses. There is no log item in the UI to communicate that a CC email was delivered to the recipient or bounced. Emails in the inbox The cc'ed person will be in the cc field of the email the lead receives. The links in the email will be tracked for the person in the To: line. If the cc'ed person clicks the links in the email, the 'Click Link' activity will be logged on the lead in the To: address and the cc'ed recipient will be cookied by Munchkin as the person in the To: address.

Issue -Error editing image in email: “image URL does not exist” or “image URL cannot be found” Environment -SSL not enabled on Marketo instance -Browser blocks unsecured content Solution Option 1 -Set up SSL for landing pages (Recommended! SSL should be a baseline configuration for all landing pages and tracking domains). Add SSL to Your Landing Pages | Adobe Marketo Engage Option 2 (Not recommended! Warning! This is a security risk.) -Allow browser to view unsecured content (can choose to turn this setting back off in the browser after viewing the content) This link below describes how to enable this content in Chrome. https://docs.adobe.com/content/help/en/target/using/experiences/vec/troubleshoot-composer/mixed-content.html This link below describes how to enable this content in Firefox. https://support.mozilla.org/en-US/kb/mixed-content-blocking-firefox Option 3 -Try to use a different browser or try turning off all browser extensions. Root Cause This issue could be caused by SSL not being enabled. If the issue was sudden, and SSL is enabled, it is likely due to the browser needing an update. Check if there are any updates that need to be done.

Issue When trying to edit an email you are receiving the error "Cannot Load Email" with out any other details. This is only when trying to edit the email, other functionalities like cloning still work. Solution The reason you are receiving this error message is because the HTML of the email has been corrupted. Extract the HTML of the email by following the instructions here: https://docs.marketo.com/display/DOCS/Download+an+Email's+HTML Find the email and select it In the Email Actions Drop down click Download HTML Once the emails HTML is extracted you can check on the errors by pushing the HTML through a validator (https://validator.w3.org/) **If no Errors are evident please create a support ticket. If there are errors but you would still like to use the HTML in an email. Create a new email, replace the HTML with the extracted content from the old email Append the HTML to resolve any errors that would corrupt the content Save and Approve Email for use in campaigns and programs Root Cause Sometimes emails can become corrupted in Marketo. When this occurs unexpected behavior may occur. Typically emails become corrupted when a copy of a copy of a copy (etc.) occurs. With each clone of an asset there is a small chance that the asset could become corrupted, this becomes more and more likely as clones of clones are made. A solution to help prevent corruption would be to create a 'master' email that you can clone from each time instead of cloning from something else that was cloned. This same solution can be applied to other assets such as landing pages.

Issue You receive a page with the error "Cannot get email content" when visiting View as Webpage link in email. Solution The view as webpage link is tied to the original email asset when it was sent. Occasionally customers will say they're receiving an error message when visiting the link like so: This is a article attached image There are multiple reasons this can happen: The email was a sample send of a draft of an email that no longer exists. It was discarded, or approved. The email asset was deleted You tried to use the view as webpage token from MSI. Root Cause This issue occurs when the visit webpage link is trying to refer to an email or email version that no longer exists either because it was deleted, replaced or approved.

When a customer triggers a blacklisting on Marketo's shared IP range that customer is moved to a set of IPs we call the quarantined IP range. We do this to protect the health of our shared network and ensure the best deliverability possible for all of our customers on that network. If you have received a Blacklist Notification from Marketo reporting that you have triggered a blacklisting your Marketo account is now in the quarantined IP range. While you are in the quarantined range it is possible that you may experience a slight decrease in your deliverability rates. The reason for this is that you are now sending from a range made up of senders that have also caused other blacklist issues. All customers have received a notice of the listing and are in the process of repairing their database. There are two ways to be removed from the quarantined IP range: Follow the steps outlined in our Blacklist Remediation article. Be sure to fill out the form referenced in the email alert to indicate that you have taken steps to mitigate the issue. Demonstrate clean sending behavior for 3 months. We remove senders from the quarantined IP range if they have not triggered any new listings in 3 months. To ensure your best deliverability rates blacklist issues should be addressed right away to prevent further damage to your sending reputation. Furthermore, if no action is taken to improve list hygiene the issue will likely recur. Marketo's Privacy Team strongly recommend following the Blacklist Remediation steps. Additional Resources: Blacklist Deep Dive

Issue Emails with valid email address get soft bounced with this error: Local address contains control or whitespace. Solution This error means that the email has a space somewhere in the the From email address or there was a comma or extra character in the From line. If you do not see a space inside the email address, check the end of the address to see if a space somehow got added at the end. The email send did not occur due to the error with the address. The emails will need to be resent once after the associated address is corrected with white spaces or extra characters. Also, there is the possibility that email address "text" contains Paragraph marks or hidden formatting symbols (https://www.computerhope.com/jargon/f/formmark.htm) and instance users will required to have it reviewed and changed.

An email being filtered to a quarantine or bulk mail folder happens after the recipient mail server has accepted message. Once an email has been accepted by a mail server, it is impossible to tell where it went or what happened to it. Note that this is true of any mail sent by any system on the Internet. Every mail server has configurable filters that determine how received mail will be handled. The mail server administrator should be able to adjust those filters to ensure delivery of emails based on their business standards, or there may even be end-user-configurable controls that can accomplish the same thing. If test mailings you are sending to yourself or your colleagues are being filtered to a quarantine or bulk mail folder, you should consider asking your email administrator to whitelist Marketo’s IP ranges. They can be found here. You can also improve your deliverability in general by setting up SPF and DKIM records, and branding your tracking links.

Issue You notice that new records in Marketo have the 'Website' and 'Company Name' fields populated with the domain of their email address. Solution This will happened when a new lead is created by a form fill-out. If the new record is imported or created manually then this would not apply. This design decision has been a part of the code for many years where the domain of the email is used for the company name and website fields on the lead record. This feature cannot be disabled.

Issue External tracked webpages are not showing up in "Visited Webpage" or "Filled Out Form" Smart List filter. Solution Munchkin tracked pages will not show up in Smart List filters until a known lead visits the webpage. To make sure the webpage shows up, do the following: Make sure that you have the Munchkin tracking code on those webpages. Use a test lead to visit the page and you may have to fill out a form or send an email to the lead to make sure that the lead is tracking on your machine. Check the test lead's activity history to make sure the visit is logged. Try entering the webpage in the filter again. Note :- Customizing Munchkin code can also be responsible for the same.

Issue Leads were sent the email and clicked on a web page link on the email. However, the web page activities were not associated to these leads. Solution Issue Resolution Check that the link clicked in the email has tracked link enabled If the web page activities are associated to other records (e.g. duplicates), then: Check who was 'cookied' on the web browser before the visit web page activity was recorded for the other records. This can be checked by looking at the web page activities recorded in the activity log. Check the User Agent details of the Click Link activity of the lead that was sent the email and compare it with the User Agent details of the Web Page Visit activity of the other record. The following tool can be used to help interpret the device details from the User Agent details: https://developers.whatismybrowser.com/useragents/parse/#parse-useragent In case of a non marketo landing page , check whether the munchkin is enabled correctly over the page without any customization. Reference Doc :- Munchkin Tracking

Issue If your Smart Lists are processing slowly, you may be able to speed them up using Segmentations for exclusion lists. Solution Many companies maintain email exclusion lists based on a number of criteria. In Marketo, these are often set up using Smart Lists that are then referenced in "Member of Smart List" filters. However, Smart Lists that reference other Smart Lists can be slow to resolve. Using a Segmentation for your exclusion lists instead of Smart Lists can help your campaigns and programs run more efficiently. Instructions for setting up Segmentations can be found here: Create a Segmentatio. You can then use the Segmentation filters in your Smart List rather than the "Member of Smart List" filters: Use Segment Filters in a Smart List.

Issue You are trying to identify your most active leads and set up a Smart List with an "Opened Email" or "Clicked Email" filter using "Email 'Is Any'" and a "Min number of Times" constraint, but are not sure if results are based on individual emails or 'all' emails in the 'Date of Activity' range. Solution These filters read from the Activity log so the min number of times constraint is based on all emails for a given record For instance, consider a record that has received Email 1 twice and Email 2 once. To meet the minimum qualifying threshold of three, the record qualifies since it has a total of three email send activities (two from Email 1 and one from Email 2). The same criterion applies to click activities. Note: An open activity is recorded only once per email per record. For further details, you can read more here .

Issue You want to measure who clicks a specific link that uses a query string from a landing page, but when you try to use this logic in a smart campaign or smart list, it tells you the URL can’t be found, even though you can see the URL embedded on the landing page. Solution If you are using the link "marketo.com/company/contact/?firstname=test", then you need to seperate the url into the link and the query string. The root domain (Link in the filter/trigger) will be marketo.com/company/contact/ and the query string (from Add Constraint dropdown) will be firstname=test. This will allow you to correctly track the links you are wanting. Make sure that you have the correct Web Page associated as a constraint as well. This is a article attached image This is a article attached image For a better understanding of what query strings are, they are the parameters that are preceded by the "?" in the url. Detailed Doc :- on UTMs and Query string parameters :- Tracking Lead Sources Using UTM Parameters

List imports can fail for a number of different reasons, so finding what that reason was is the first step to fixing what went wrong. When a list import fails to import leads, the Import Status dialog box will give you an error to tell you that some of the leads failed to import. The “Failed: X Leads” showing in the Import Status dialog box is a hyperlink. This is a article attached image When you click on the hyperlink, it will download an Excel file that carries the details of what caused the failure. The details for the import failure will change depending on the different types of issues, so watch for the explanations in the far right column for each lead on the list. Invalid data for the field type: This is a article attached image Invalid Email Address Warning: This is a article attached image Lead belongs to a different Lead Partition: This is a article attached image

Issue You added yourself to the Send Alert To portion of the List Import process and continue to receive unwanted Alert Emails every time a list is imported. Solution During the next List Import process to the problem Static List in Marketo, you'll want to select the Edit Send Notification from the window that pops up in the top right section of your screen after the import process is started. Selecting the Edit Send Notification will cause a new window to open up that shows all of the email addresses who will be sent an Alert Email once the import completes. If you no longer want to receive the Alert Emails for this static list going forward, deleteyour email address and click save.

My export is going to take a long time, do I have to stay logged in until it completes? Thankfully no, once you get your Import or Export started, you can log out, go grab some coffee or go home and the process will continue. Export: When you start the export process, you can close out of Marketo, later in the day or the following day you can log back into Marketo, find the same SmartList or StaticList you ran the export from, select it, click on List Actions and choose "Show Export Status". The Export dropdown will show up and assuming it is finished, the download link will be available. 1. Find and Click on the SmartLists or StaticList: 2. Click on List Actions then "Show Export Status": 3. The dropdown will pop open in the top right hand corner with the export status or the download link: Import: Similarly, you can get an Import started, when you choose the CSV and begin the process the first step is for the file to get uploaded to our server where it will be further processed and imported into the database. Once the file is uploaded and the import process begins, you can close out of Marketo and come back to check on the status in the future instead of staying logged in the entire time. In a similar manner to checking export status, you can click the StaticList you are importing into as follows: 1. Find and Click the SmartList or StaticList you are Importing into: 2. Click on List Actions then "Show Import Status": 3. The dropdown will pop open in the top right hand corner.

Issue Issue Description You have a record with a "Change Data Value" activity, but that field doesn't have a value on the current record. There's also an anonymous lead merge (which can be identified by looking for a Merge Leads activity and seeing if "Anonymous Source" is True) on the record. Solution Issue Resolution Check the Change Data Value's "LeadId" field. If this matches the anonymous record's ID (identified from the Merge Leads activity in the "Merge Id" field), then the reason for the value not showing is because upon association of an anonymous lead to a known record, only the activities are merged -- not the values of any fields which may have been recorded as changed.

Knowledgebase

Maintaining a Directory of Leads Bouncing Emails

Dealing with Spam or Bot Form Fillouts

Different Email Addresses in the From and Reply-To Lines

CC in Email Notes

"Image URL cannot be found" Error for Editing Images in Emails

"Cannot Load Email" Error When Editing an Email

"Cannot get email content" message when visiting View as Webpage link in email.

What Is the Quarantined IP Range?

Soft Bounce: Local Address Contains Control or Whitespace

How Can I Tell If My Email Is Getting Filtered into a Quarantine or Bulk Mail Folder?

'Website' Field Same as Email Address Domain

Webpage Not Showing up in Visited Webpage or Filled out Form Smart List Filter

Web Page Activities Not Associated to Leads after Clicking Link in Email

Using Segmentations for Exclusion Lists

Using "Opened/Clicked Email - Email is Any" with a "Min Number of Times" Constraint

URL Not Appearing on Filter for Smart Campaign or Smart List

Unable to Create Subscription for Static List

TROUBLESHOOTING List Import Failure Reasons

Removing Yourself from a List Import Alert Email.

My Import/Export Is Going to Take a Long Time, Do I Have to Stay Logged in Until It Completes?

Merged Lead Has "Change Data Value" Activity But No Value in Field