Bronto Application by Kibo eCommerce

Configuration Guide

Current Version: 1.1.0 (August 2016)
Install: Kibo eCommerce App Marketplace
More Info: Version History

Bronto is the top-ranked email marketing platform to the Internet Retailer Top 1000. It features an advanced marketing and email automation engine designed for email, mobile, and social campaigns. With Bronto, you can handle shopping cart abandonment, post-purchase follow-ups, shopper segmentation, and more.

The Bronto Application by Kibo eCommerce integrates the benefits of Bronto with your Kibo eCommerce account. After configuring and enabling the Bronto Application by Kibo eCommerce, you can access the functionality of the application using extensions that install in the Customers and Orders modules.

Application Features:

Install the App

You can install the Bronto Application by Kibo eCommerce directly from the Kibo eCommerce App Marketplace:

  1. Go to: www.kibocommerce.com/marketplace
  2. In the Search field, enter: Bronto
  3. Click the app icon.
  4. On the app page, click Install Now.

Configure the App

To integrate your Bronto services with Kibo eCommerce, review the configuration requirements to ensure you have everything you need to be successful before you begin, and then complete the steps in this section.

Configuration Requirements

Obtain Your Bronto API Key

The Bronto SOAP API credentials grant Kibo eCommerce access to your Bronto contacts and email templates without requiring you to enter your Bronto credentials in Kibo eCommerce. The Bronto REST API credentials grant access to Bronto orders, carts, and products. Note the API credentials so you can then enter them in Kibo eCommerce during configuration:

  1. Log in to your Bronto account.
  2. Find the list of SOAP API Access Tokens for your account. At the time of this writing, you could find this list on the Home > Settings > Data Exchange page.
  3. Note the key you want to use from the list. If you have not yet created a key, click Add Access Token to configure a new key with read, write, and send permissions for use with the Bronto Application by Kibo eCommerce.
  4. Find the list of REST integrations for your account. At the time of this writing, you could find this list on the Home > Settings > Data Exchange page.
  5. Note the REST ID and Secret for the REST integration you want to use. If you have not yet created a REST integration, click Add Integration to configure a new integration with full read and write permissions for use with the Bronto Application by Kibo eCommerce.

Configure the Bronto Application by Kibo eCommerce

After obtaining your Bronto API key, enter the key in Kibo eCommerce and configure the settings for the Bronto Application by Kibo eCommerce:

  1. In Admin, go to System > Customization > Applications.
  2. Click Bronto Application by Mozu.
  3. Click the Configuration link to open configuration settings.
  4. Open the API Keys tab.
  5. Select a customer set from the dropdown menu.
  6. Enter your Bronto SOAP API Key.
  7. Enter your Bronto REST Client ID.
  8. Enter your Bronto REST Shared Secret.
  9. Enable Is Mozu Sanbox? if you plan to test the application on a sandbox. When this setting is enabled, Kibo eCommerce appends your tenant ID to every order to avoid duplicating order numbers and affecting production data.
  10. Enable Save Event History? to maintain logs related to this application.
  11. Click Save.
  12. Repeat the process for any additional customer sets configured on your tenant. You can tie customer sets to different Bronto accounts or the use the same account.

An Account Features tab displays.

  1. Open the Account Features tab.
  2. Select a customer set from the dropdown menu.
  3. Specify which Bronto list to add the customer set's contacts to.
  4. Specify sync options between Kibo eCommerce and Bronto:
    Enable Opt in/Out Sync from Mozu to BrontoSends shopper information from Kibo eCommerce to Bronto about shoppers who opted into email marketing during the checkout process.

    If you do not enable this feature, Bronto classifies shoppers who receive non-transactional emails (wishlist reminder, welcome email, store credit) as "Onboarding Contacts", and classifies shoppers who receive transactional emails (in-stock notification, order confirmation, order shipment, RMA emails, password reset, and order abandonment) as "Transactional Contacts".
    Enable Opt in/Out Sync from Bronto to MozuSends your Bronto contacts' marketing preferences from Bronto to Kibo eCommerce.
    Enable Contact ExportSends contact information from Kibo eCommerce to Bronto about shoppers, including names, email addresses, and custom shopper attributes.
  5. Click Save.
  6. Repeat the process for any additional customer sets configured on your tenant. You can tie customer sets to different Bronto lists or use the same one.

A Site Features tab displays.

  1. Open the Site Features tab.
  2. Select a site from the dropdown menu and then choose which features to enable or disable for that site. Note: Many of the features require you to select a template for the emails sent to shoppers. If you want to add or edit these templates, you can do so from within your Bronto account.
    Enable Order sync from Mozu to BrontoSends order information from Kibo eCommerce to Bronto.
    Enable Order Confirmation EmailSends an order confirmation email to shoppers after the checkout process is complete.
    Enable Order Abandonment EmailsSends an email to shoppers who began the checkout process 48 hours ago but who have not yet submitted the order.
    Enable Order Shipment EmailsSends an email to shoppers when their order ships.
    Enable Return Created EmailsSends an email to shoppers after they create a return.
    Enable Return Authorized EmailsSends an email to shoppers after you receive and accept a return in Kibo eCommerce using the Orders module.
    Enable Return Rejected EmailsSends an email to shoppers after you reject a return in Kibo eCommerce using the Orders module.
    Enable Return Closed EmailsSends an email to shoppers after you close a return in Kibo eCommerce using the Orders module.
    Enable InStock Notification EmailsSends an email to shoppers when an item on their wishlist is back in stock. (Note that this is not supported for bundles.)
    Enable Welcome EmailsSends a welcome email to new shoppers.
    Enable Password Reset EmailsSends password reset emails to shoppers using a Bronto template instead of the default Kibo eCommerce email.
    Turn on wishlist reminder emailsSends a reminder email after a specified number of idle Day(s) to shoppers who have items in their wishlists.
  3. Click Save.
  4. Repeat the process for any other sites configured on your tenant.

Enable the App

After configuration, enable the Bronto Application by Kibo eCommerce in Kibo eCommerce to apply its functionality to your tenant.

  1. In Admin, go to System > Customization > Applications.
  2. Click Bronto Application by Mozu.
  3. Click Enable App.

After enabling the Bronto Application by Kibo eCommerce, perform an initial export of shopper and order information from Kibo eCommerce to Bronto.

Export Shopper Information to Bronto

Export Kibo eCommerce shopper information using the Customers module extension. The export adds existing Kibo eCommerce shoppers and their attributes to your Bronto contacts. After the first export, the Bronto Application by Kibo eCommerce automatically sends information about new Kibo eCommerce shoppers to Bronto if you enable the contact export feature in the configuration settings.

  1. In Admin, go to the Customers module.
  2. Click the Bronto extension button and select Bronto > Attributes.
  3. Use the Attribute Mapping page to map shopper attributes gathered or created in Kibo eCommerce, by customer set, to fields in your Bronto account. For example, you can map typical Kibo eCommerce shopper attributes, like a shopper's first name, to a corresponding Bronto field. You can also map any custom shopper attributes you have created in Kibo eCommerce to a Bronto field. If you don't select a field for an attribute, it will not map to Bronto.
  4. Click Save.
  5. Click Sync to open the Sync page.
  6. Click Export All Contacts To Bronto.
  7. Click Export to Bronto to send existing Kibo eCommerce shopper information and marketing preferences to Bronto.

Export Order Information to Bronto

Export Kibo eCommerce order information using the Orders module extension. The export sends order information from Kibo eCommerce to Bronto about orders your site received prior to enabling the Bronto Application by Kibo eCommerce. After you enable the application, new order information is automatically sent to Bronto if you enable the order export feature in the configuration settings.

  1. In Admin, go to Main > Fulfillment > Orders.
  2. Click the Bronto extension button and select Bronto > Export.
  3. Click Export.

Congratulations! You can now preview Bronto functionality on your site.

Use the App

Customer Module Extension

The Bronto Application by Kibo eCommerce adds an extension to the Customers module that allows you to sync contact information between Kibo eCommerce and Bronto, manage wishlist reminders, view related logs, and preview emails sent to shoppers. Note: The pages that display in this extension depend on the features you enable during configuration.

To view this extension:

  1. In Admin, go to the Customers module.
  2. Click the Bronto extension button and select a page.

Sync Contacts Between Kibo eCommerce and Bronto

Use the Sync page in the Bronto extension to update Kibo eCommerce shoppers with their marketing preferences stored in Bronto. Any change in subscription settings in Bronto automatically update in Kibo eCommerce.


  1. Click Sync Marketing Preferences From Bronto.
  2. Click Sync from Bronto to import shopper information and marketing preferences from Bronto.

After you sync contacts between Kibo eCommerce and Bronto, Kibo eCommerce receives updates from Bronto once every hour.

Run Wishlist Reminder

Use the Wishlist page in the Bronto extension to remind shoppers about products on their wishlist that are available for purchase. Click Run Wishlist Reminder to send an on-demand email reminder. If you enabled wishlist reminders during configuration, a new reminder will run once per day at 12:00 AM CST to shoppers who have had items in their wishlist for the specified idle period.

View Shopper Marketing Logs

Use the Logs page in the Bronto extension to view events related to shopper marketing preferences. The log displays information about when shopper accounts were created, when marketing preferences were changed for an account, and when updates were made to shopper accounts. You can use the Search to filter the logs by shopper email.

Send a Test Email

Use the Email Test page in the Bronto extension to preview how an email will look to a shopper:


  1. Select an Email Type to preview from the drop-down menu.
  2. Enter an Email address associated with one of your shopper accounts. The information from the shopper account is used to populate the email with relevant data (for example, a shopper's name and wishlist).
  3. Click Test Email to send the test email to the email address associated with your Kibo eCommerce account.

Orders Module Extension

The Bronto Application by Kibo eCommerce adds an extension to the Orders module that allows you to view order export logs and preview emails sent to shoppers. Note: The pages that display in this extension depend on the features you enable during configuration.

To view this extension:

  1. In Admin, go to the Orders module.
  2. Click the Bronto extension button and select a page.

View Order Logs

Use the Logs page in the Bronto extension to view events related to order exports. You can use the Search to filter the logs by shopper email.

Send a Test Email

Use the Email Test page in the Bronto extension to preview how an email related to a specific order or return will look.


  1. Select an Email Type to preview from the drop-down menu.
  2. Enter an Order/Return Number. The information from the order or return is used to populate the email with relevant data (for example, the product ordered).
  3. Click Test Email to send the test email to the email address associated with your Kibo eCommerce account.

Abandoned Cart Widget

When a Kibo eCommerce customer places items in their cart and does not complete checkout, automatic reminder emails can be triggered via Bronto. You can specify when to trigger these emails – for example, if the cart has not been touched in 48 hours, then Bronto can send this email and send a reminder every 2 days after.

This functionality must be enabled through a Bronto widget:

  1. Have the Bronto application configured for your tenant.
  2. Drop the “Bronto Conversion Tracking Script” widget onto the cart page.
  3. Log in to Bronto and copy the Tag Manager script code from Settings > Commerce.
  4. Paste the script into the widget’s text box.

This will allow Bronto to identify when a cart has been abandoned and begin sending emails.

Use API Variables to Customize Email Templates

Kibo eCommerce exports an assortment of variables through the Kibo eCommerce API related to shoppers and orders. You can use these variables to add useful content to your Bronto email templates. The syntax for using API variables in Bronto email templates is %%#variable%%. For example, if you are creating an email template to notify shoppers of a product that has come back into stock (and you are not using a bundled product), you could enter the following text in the HTML for the Bronto In-Stock email template:

Good news! %%#productName%% is back in stock!

Also note that you must place email variables that end in _# within loops. For example:

{loop}%%#productImageUrl_#%%{/loop}

Refer to the following tables for the complete list of email variables you can use in Bronto, and to the Bronto Help & Learning Center for information on customizing email templates with API variables.

In-Stock Notification Email | Order Abandoned, Confirmed, or Shipped | Returns | Welcome Email | Wishlist | Password Reset