Unbounce is a landing page platform for creating landingpages using a nice WYSIWYG editor. It supports a huge selection of building block templates and allows non-technical designers to allow setting up customized forms.
Unbounce can be used to collect leads and submit them to Maileon.
How to Configure Unbounce
After logging in into your Unbounce account, click on your current form or create a new one. In this example, we create a simple form that should collect the full name, an email address, the company name and some additional data like company size, as this is one of the default templates for a form.
Once the form is set up, you can see the collected leads by clicking on “Leads” in the top navigation of the page details. To connect Maileon, click on “Integrations” and select “Add Webhook” or edit an existing webhook.
In the popup you can enter the data specified in the documentation2 for webhooks. The URL of the webhook API is: https://api.maileon.com/webhooks/contacts/email?key=[YOUR API KEY]. Make sure to replace [YOUR API KEY] with an API key generated in your account under “Settings” “API-Keys”.
Under “Unbounce Form Data” you need to specify a mapping from form fields to Maileon contact fields. For standard fields use the attribute prefix "standard", as seen in the example above, for custom fields use "custom". The keys for standard fields can be found here: http://dev.maileon.com/api/rest-api-1-0/contacts/standard-contact-fields. Be careful to use correct capitalization, also for the custom fields.
In this example, we map the field “name” to the standard field “FULLNAME”, the “company_name” to “ORGANIZATION” and the “company_size” to some custom field named “csTest”. The name “email” for the E-Mail-Address is mandatory.
Under “Unbounce Page Data” you can decide, if you need some of the data as standard or customfields, e.g. in our example we write “page_url” to a customfield also called “page_url” and “page_name” to a customfield “page_name”.
Under “Custom fields” you can finally configure the action that is performed, when a contact is submitted by Unbounce, the complete list of parameters is specified here: https://support.maileon.com/support/create-contact/. In the example we use doi to signal, that Maileon should start a DOI process. Also other attributes from the documentation above can be added, e.g. we also used sync_mode.
The most commonly used attributes are:
The field for email address
The external ID, not required for LeadAds
The Maileon API-Key
Standard field “first name”
Standard field “last name”
Should a DOI be sent by Maileon?
Should Maileon use DOI+ as permission?
1: The contact is updated is existing, 2: The contact is ignored when already existing
The key of the DOI mailing in Maileon
If everything is set up, save the webhook, publish your form and enter some data. If everything works as expected, you can go to your lead, click in the list on the entry and check under “Integration Details” if the webhook has a green checkmark and the server response is 201.
If this is not the case, expand the report under “Integration Details” and click on “Response”. In this example we specified “standard_FULL_NAME” instead of “standard_FULLNAME” so the server responds:
Standard field is misconfigured: standard_FULL_NAME (Message: Not a valid standard field name: FULL_NAME (but starting with flag 'standard_': standard_FULL_NAME))
The solution in this case is using the correct spelling of the contact field.
Another reason why registration forms in new accounts often fail are the DOI mails that are to be triggered: if a DOI mail was added to Maileon but was not specified as default mailing in the settings, Maileon does not know how to send a DOI mail to the customer and refuses to accept the contact, signaling that there is something wrong. In case the DOI mail is marked with some special DOI key and Unbounce should trigger that special DOI mail, the key needs to be added as parameter doimailing to the webhook configuration (see “Custom fields”) and it should be ensured, that the DOI key is either never changed, i.e. if the DOI mail is replaced by a new one, make sure to use the same DOI key, or if it is changed inside Maileon, it must be updated in Unbounce, otherwise no contacts will be registered.