How to debug MailChimp error

Overview

This document provides instructions on how to detect and debug errors, that may appear when member subscribes to the MailChimp audience using the MailChimp extension.

Contents

Debugging #

Update plugins #

Update "Ultimate Member" and "Ultimate Member - MailChimp" plugins to the latest version. You can update plugins automatically or manually from the archive.

Image 01 - How to update plugin automatically

Plugins, Installed Plugins

How to update plugin manually from the .zip archive

  • go to the admin page "Plugins"
  • deactivate old version (if it is)
  • delete old version (if it is)
  • click the "Add New" button
  • click the "Upload Plugin" button
  • click the "Choose file" button - additional window should appear
  • select an archive with the new version
  • click the "Install Now" button - installation will start
  • activate plugin after the installation

Please look to the documentation for details.

Enable requests log #

The extension may save requests to the MailChimp server to the file  /wp-content/uploads/ultimatemember/mailchimp.log. Turn on the setting Enable requests log to enable this feature.

Image 02 - The page [Ultimate member > Settings > Extensions > MailChimp]

Verify audience and connection settings #

Synchronization between Ultimate Member and MailChimp fails if the  required field is empty. 

Synchronization between Ultimate Member and MailChimp may fail if the value of the "radio buttons" or "drop down" field type doesn't match the audience field options.

The widget Merge User Meta has several tools that helps you to configure fields relationship and avoid mistakes:

  • required fields marked by the icon !
  • additional information about field type and choices may be seen under the icon ?
  • a warning appears under the field if configuration is wrong

Image 03 - The widget Merge User Meta on the page [Ultimate Member > MailChimp > Edit audience]

Image 04 - A warning in the widget Merge User Meta

Ultimate Member, MailChimp, Edit audience

Try to subscribe and unsubscribe member from the Account page #

Error message appears on the Account page if update fails for some reason. Verify your audience and connection settings. Pay attention to the widget  Merge User Meta, especially on required fields and choices for the "radio buttons" and "drop down" field types.

Image 05 - An error message on the page [Account > Notifications]

UM-Account-Notifications-Fail-update

Investigate the Requests log #

The extension may save requests to the MailChimp server. You can overview the Requests log on the extension's settings page. Use log to debug MailChimp API errors. Requests with errors are colored in red. Usually you may find the error detail in the RESPONSE data.

Image 06 - An error detail in the Requests log on the page [Ultimate member > Settings > Extensions > MailChimp]

MailChimp errors #

Forgotten Email Not Subscribed #

MailChimp doesn't allow re-subscribe permanently deleted contacts by API. You have to go to your MailChimp account and re-subscribe this contact manually.

Note: We don't recommend using the action "Permanently delete" on account removal. Read the article MailChimp Setup for details.

Image 07 - The error message "Forgotten Email Not Subscribed"

Member In Compliance State #

MailChimp adds an email address to the black list if a member use the link "unsubscribe from this list" in the email footer. 

Image 08 - The unsubscribe link

This email address can't be resubscribed via API. You should see an error message if you try to resubscribe using fields in the account tab Notifications.

Image 09 - The error message "Member In Compliance State"

We can't influence this logic from the site. A member can resubscribe by clicking the button "Subscribe" in the email "You are now unsubscribed" that Mailchimp sends after the contact is unsubscribed.

Image 10 - The email "You are now unsubscribed"