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 Clearing cache and cookies in your browser will fix a number of different problems related to page display, browser errors, and login issues. Solution Here are links to the support articles on how to clear cache and cookies for the most commonly used browsers. Chrome Clear cache and cookies - Computer - Google Account Help FireFox How to clear the Firefox cache | Firefox Help Internet Explorer https://support.microsoft.com/en-us/help/278835/how-to-delete-cookie-files-in-internet-explorer Microsoft Edge Microsoft Edge, browsing data, and privacy – Microsoft privacy

Issue You have two SFDC picklist fields mapped to one Marketo field but it isn't showing all picklist values for both SFDC fields. Solution When two SFDC picklist fields are mapped to one field in Marketo, the only values that will show in Marketo will be the values that exist in both picklists. Review the picklist values in Salesforce and add any missing values to the picklists so that they match exactly. This could happen in situations where the field in Marketo is mapped to a SFDC picklist field on leads as well as a SFDC field on contact/account.

Issue When trying to clone a Form or Landing page from Design Studio to a specific Program under Marketing Activities, there is no list of programs that appear. Solution This is expected behavior. When you don't see a program listed, this is because the number of programs in Marketing Activities actually exceeds what we're able to display at one time. If you start typing into the Program field in the pop-up window, you should start to see programs listed in the drop-down. For example, you enter the name of the particular program, you will get a result.

Summary UTM Parameters Not Populating with Known People Form Fill Issue UTM parameter field values are not being captured for some people's form submissions, even though the form is configured to capture the values. Solution When a form is using the "Show Custom HTML Form for Known People", the submission button will generate a Filled out Form activity, but will not write any new field values. When attempting to capture UTM parameters with the feature enabled, those UTM values, as well as the other fields on that form, will not be captured. Show Custom HTML Form for Known People | Adobe Marketo Engage

Issue When cloning an asset from Design Studio into Marketing Activities, there is a box that asks you to select which program to clone the asset into. When clicking into this box, you may see No Results, even though there are programs within Marketing Activities. This is a article attached image Solution Expected Behavior: This happens when there are too many programs in the Marketing Activities tree. To select your desired Marketing Program, begin typing the Program Name, and results will begin to appear in the Program drop-down. This was designed to increase UI performance when cloning assets into Marketing Activities from Design Studio.

Want to gauge how many leads clicked through a link you have in your social media or other outlets? This can be done using URL Parameters at the end of the URLs you use. Basically, you just add a little bit of code to the end of the hyperlinked URL. When leads click through and arrive at your Landing Page, that code can be captured into a hidden Form field. Here’s how to do it. Quick Overview of URL Parameters In the structure of a URL, there are two main parts. The first part is used for navigation, and the second part is used to pass data along. The two parts are separated by a question mark. For example, let’s look at this URL: www.myawesomewebsite.com?URLParameter=ThisIsAParameter The first part of the URL, “www.myawesomewebsite.com” is the main part of the URL used for navigation. The whole rest of the URL from the question mark on, “?URLParameter=ThisIsAParameter” is referred to as a querystring. It isn’t needed for navigation to the page specified, but can be used to pass the extra data you want to include. This is a article attached image The querystring contains the URL Parameters, which are used to push data into the hidden Form fields. In the querystring “?URLParameter=ThisIsAParameter” used here, “URLParameter” corresponds to the name of the parameter you use when designating the value for the hidden Form field, and “ThisIsAParameter” will be the value that is actually entered into that field. You can add additional values into additional other fields by adding those into the format of the URL separated by an ampersand like this: www.myawesomewebsite.com?URLParameter=ThisIsAParameter&URLParameter2=ThisIsValue2&URLParameter3=ThisIsValue3 In this example, you’ve got the same initial value being pushed into the first hidden field, but now two more hidden fields will store the next two values as well. The name of the parameter for the second hidden field would be “URLParameter2” and the value put into it would be “ThisIsValue2”. The third hidden field parameter name would be “URLParameter3” and the value put into this field would be “ThisIsValue3”. This is a article attached image Applying This to Social Media Use So, how does this let you track leads coming from each of your social media sources? Well, in setting up your different promotional channels, when adding the hyperlink, you can customize the URL parameter for each channel so that the values passed will input the information specific to where they came from. The parameter values will change from one social media outlet to the next, but the structure and format will stay the same. Let’s use the social media sources of Twitter, LinkedIn and Facebook as examples. Since you’re looking to identify the source of these leads, you’d likely want to name your parameter as “Source” so that it’s easily identifiable. Using the same base URL, let’s see how you’d structure the URLs. For hyperlinks placed on Twitter: www.myawesomewebsite.com?Source=twitter For hyperlinks placed on LinkedIn: www.myawesomewebsite.com?Source=linkedin For hyperlinks placed on Facebook: www.myawesomewebsite.com?Source=facebook When leads fill out the form on your landing page, the Source field will then tell you exactly where they came from! The best part, this is completely customizable and scalable. You can add more parameters and hidden fields to capture additional information like what campaign it is for. Documentation How to make form fields hidden: https://experienceleague.adobe.com/en/docs/marketo/using/product-docs/demand-generation/forms/form-fields/set-a-form-field-as-hidden How to define hidden form field value: https://experienceleague.adobe.com/en/docs/marketo/using/product-docs/demand-generation/forms/form-fields/set-a-form-field-as-hidden (Look for the section on URL Parameters in particular) Using the URL builder to generate the URLs you’ll be using: https://experienceleague.adobe.com/en/docs/marketo/using/product-docs/demand-generation/landing-pages/personalizing-landing-pages/using-the-url-builder

Issue When using the [mktorest.com/rest/asset/v1/emailTemplates.json] end-point to pull all Email templates, the COUNT is much less than what is shown in Marketo's Design Studio Global Search. Solution This is the expected behavior. When viewing the total count of Email templates in the Design Studio UI, it will count EACH shared template that is shared across other workspaces, counting the same template multiple times depending on how many workspaces it's shared to. However, when retrieving the Email Templates from the REST API, it will only return DISTINCT Email Template ID's from the originating shared workspace where the template resides. It will not return the templates from the shared workspaces. Root Cause REST API Expected Behavior

Issue You may notice this permission error "You do not have sufficient privileges to perform this action" when previewing an email even though the user role has permission to access the emails. Solution This can happen when the user role didn't have any access to the lead database as shown in the picture. This is a article attached image The user role needs the top-level access to the Lead Database(1 of 15). This is because the email previewer allows one to view the asset as if you were a specific lead, but if you can't see the leads, then the error will trigger. To fix this issue, you would need to provide the user role with top-level access to the lead database.

Issue Issue Description "${button-link}" appears on the Email Link Performance report in place of the URL the buttons point to. Solution Issue Resolution To stop this "${button-link}" from appearing on the reports, edit the text version of the emails to replace the "${button-link}" with the URL the button points to. This occurs because the text version of the email didn't get edited to provide a valid button link. The "${button-link}" value is part of HTML templates and if the setting 'Copy HTML to Text version of email' is checked then those values get copied across. From there, if the text version doesn't get edited or reviewed after that copy over happens, tracked links for "http://${button-link}?mkt_tok=..." will be sent out for those leads that get the text version of the email in place of the URL the button points to. The next question after hearing this solution is often, "If this is just for the text version, who is reading the text version of emails?", and the answer is that it's probably automated link scanners or security software visiting the link and triggering the click to show on reports.

If you sent an email from the Lead Database (as a Single Flow Action), as part of a campaign, or as a test email but didn't receive it, here are some tips. Check the "From:" address When sending a test message, make sure to check the "From:" address setting on your message. To do this, go to the Email Settings tab of the email editor. In the "From:" field, make sure that you either have a single valid email address, or a valid email address as the default, if you are using a token. Many people want to send their messages from the lead owner. When you use the send test feature, the email address you are sending to doesn't have a full lead record, and so it doesn't have a lead owner. Since Marketo cannot send an email with no "From:" address, test messages without a valid email address in the "From:" field will not send. Send as a Lead If you have verified that the email had a valid From: address and you still aren't getting it, make sure to create yourself as a lead and send using a flow action. See if the mail was sent If you sent the email as part of a campaign or Single Flow Action, check the campaign's Results tab or your lead detail page to see if that mail was already sent to you. If it hasn't been sent yet, try waiting a little while longer. Check your Junk Mail In your email client, check your Junk Mail or Spam folder to see if the mail landed there. If it did, you should change the content of your email. Check your corporate spam filter Your corporate mail server may have blocked emails from Marketo; you should contact your IT department to see if this is the case. Please see our instructions for whitelisting Marketo's email servers: Add Marketo to Your Corporate Email Whitelist Try sending to a different recipient If you sent the original mail to your corporate account, try sending to a personal account on Yahoo or Gmail. If you sent it to a personal account, try your corporate mail account. Use Marketo's Email Deliverability product The Email Deliverability PowerPack, with Design Informant and Inbox Informant, can warn you when your mail is being rejected because of its content and help you identify junk mail pitfalls. Also, using Domain Keys and SPF improve the chances of your email landing in your leads' inboxes. Contact Marketo If you still can't figure out what happened contact Marketo to see if we can help.

Issue You have multiple domains for your landing page CNAMES and want to choose which one is used for a landing page. Solution First, you will need to make sure your secondary domains are set up with a CNAME and a domain alias. You don't choose a domain when creating the page. All pages are created under the default/original landing page domain, but they're all available from all domain aliases as well. Swapping out the default domain with the domain alias in the URL will take you to the same page. You find more detail on this here - Multiple Domains (CNAMEs) in a Single Marketo Instance

Issue You created a picklist field in SFDC and want to know if that field will sync down to Marketo with the field type of picklist. Solution Marketo has a picklist option in form fields, but not in Lead Database fields. When you sync a field from SFDC that has the type of picklist, this field will show in Marketo with a type of String. However, when you create a form, the field type for your field will show as "select," which is a picklist.

Issue You have a custom landing page template and are able to see that landing page is not rendering perfectly on the editor but works as expected when published. Solution As you are facing the issue on a custom template, we suggest you to follow the below steps. Download a template form the URL- https://experienceleague.adobe.com/docs/marketo/using/product-docs/demand-generation/landing-pages/landing-page-templates/guided-landing-page-template-list.html In Marketo, navigate to the Design Studio Click Landing Pages in the left-hand tree, then select Templates. In the menu bar, click Import Template. Choose the downloaded file, enter a template name, then click Import (make sure to pick a descriptive name and indicate that editing mode is Guided). Create a new Landing page with the recently downloaded template without making any changes. If the default background image works on this landing page as expected, it confirms that the issue lies with the custom coding that was added to the template. Marketo Support is not set up to assist with troubleshooting custom code. The best point of contact will be your web developer who should be able to resolve the issue for you. Please be aware that the landing page editor may not load all external resources in the editor or previewer, which can cause them to look different than the published version. If the background image doesn’t render on this newly downloaded template as well, contact support and we will assist in troubleshooting your issue.

Issue You would like an links in an email to be tracked, but need to eliminate the tracking URL parameter on the tracked links. Solution In the Email Editor, you can uncheck "include mkt_tok" in the Edit Link box. This is a article attached image Adding a class "mktNoTok" to any Anchor Tag will allow you to keep the Link Tracking, but disable the Tracking Token Parameter from the URL. You may also edit the Head of the email HTML to make large sections with this class.

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

How to Clear Cache and Cookies

Two SFDC Picklist Fields Mapped to One Marketo Field Aren’t Showing All Picklist Values in Marketo

Unable to Clone form from Design Studio into Marketing Activities

UTM Parameters Not Populating on Form Submission with Show Custom HTML for Known People Enabled

MyToken used in Email not reflecting correctly

No Programs To Select When Cloning Assets From Design Studio To Marketing Activities

Tracking Lead Sources Using UTM Parameters

Email Template Count Different in UI When Compared to REST API Count

Permission Error When Previewing Email

Email Link Performance Report Shows "${button-link}" Instead of URL

I Didn't Receive a Sample Email that I Sent

Using Multiple Landing Page Domains for Your Landing Pages

Picklist Field Type in SFDC and Marketo

Troubleshooting Background Image Not Being Rendered on Landing Page Editor

Marketo Link Too Long? Keep Email Link Tracking, Disable Tracking URL Parameter