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.

Debug steps

  1. Update "Ultimate Member" and "Ultimate Member - MailChimp" plugins to the latest version
  2. Enable "Requests log"
  3. Verify your audience settings in MailChimp and WordPress
  4. Try to subscribe and unsubscribe member from the Account page
  5. Try to register new member
  6. Investigate "Requests log"

Update "Ultimate Member" and "Ultimate Member - MailChimp" plugins to the latest version

How to update plugin

[Plugins > Installed Plugins]

Plugins, Installed Plugins

How to update plugin 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 more details.

Enable "Requests log"

"Ultimate Member - MailChimp" extension may save requests to the MailChimp server to the /wp-content/uploads/ultimatemember/mailchimp.log file. Use log to debug MailChimp API issues.

[Ultimate member > Settings > Extensions > MailChimp]

Verify your audience settings in MailChimp and WordPress

Pay attention to required fields and choices for the "radio buttons" and "drop down" field types. Synchronization between Ultimate Member and MailChimp would fail if one of the required fields 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 widget 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

[Ultimate Member > MailChimp > Edit audience]

[Ultimate Member > MailChimp > Edit audience (with warning)]

Ultimate Member, MailChimp, Edit audience

Try to subscribe and unsubscribe member from the Account page

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

[Account page > Notifications]

UM-Account-Notifications-Fail-update

Try to register new member

Test your site`s Registration form. Look to the "Requests log" if new member was not subscribed to the audience.

Investigate "Requests log"

"Ultimate Member - MailChimp" extension saves requests to the MailChimp server to the file  /wp-content/uploads/ultimatemember/mailchimp.log. You may overview this file on the extension`s settings page. Use log to debug MailChimp API issues. Requests with errors are colored in red. Usually you may find the reason of the issue in the RESPONSE data.

[Ultimate member > Settings > Extensions > MailChimp]