Bronto End-of-Life
The Bronto email provider has been discontinued as of May 31, 2022 and Kibo no longer supports this application. If you were using Bronto and have not transitioned to Kibo's out-of-the-box email functionality, contact Support. This will require developer effort and rebuilding any customized email templates.
The Bronto email provider has been discontinued as of May 31, 2022 and Kibo no longer supports this application. If you were using Bronto and have not transitioned to Kibo's out-of-the-box email functionality, contact Support. This will require developer effort and rebuilding any customized email templates.
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 integrates the benefits of Bronto with your Kibo account, whether it is an eComm-only, OMS-only, or eComm+OMS implementation. After configuring and enabling the application, you can access the functionality of the application using extensions that install in the Customers and Orders modules.
Application Features
- High level of granularity for choosing which marketing and transactional emails to send to shoppers, as well as what information to send to Bronto regarding shoppers and orders
- Sync the marketing preferences for your shoppers between your Bronto and Kibo accounts.
- Export shopper and order information to Bronto to take advantage of follow-up email campaigns.
- Enable Bronto email campaigns such as order confirmations, wishlist reminders, order abandonment follow-ups, and in-stock notifications.
- Map shopper attributes and order history to Bronto lists to organize your marketing campaigns.
- Identify abandoned carts and automatically send reminders to the customer about their incomplete order.
- Preview how emails sent to shoppers will look.
- View logs related to shopper accounts and orders.
- Use Kibo variables to customize email templates in Bronto.
Install the App
You can install the Bronto Application directly from the Kibo eCommerce App Marketplace (even for an OMS-only integration of the application):
- Go to: www.kibocommerce.com/marketplace
- In the Search field, enter: Bronto
- Click the app icon.
- On the app page, click Install Now.
Configure the App
To integrate your Bronto services, 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
- The Bronto Application must be installed on your tenant.
- You must have an active Bronto account.
- You must have configured campaigns, customer lists, and email templates in your Bronto account.
Obtain Your Bronto API Key
The Bronto SOAP API credentials grant Kibo access to your Bronto contacts and email templates without requiring you to enter your Bronto credentials in Kibo. 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 during configuration:
- Log in to your Bronto account.
- 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.
- 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.
- 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.
- 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.
Configure the Bronto Application
After obtaining your Bronto API key, enter the key in Kibo and configure the settings for the application:
- In Admin, go to System > Customization > Applications.
- Click Bronto Application by Mozu.
- Click the Configuration link to open configuration settings.
- Open the API Keys tab.
- Select a customer set from the dropdown menu.
- Enter your Bronto SOAP API Key.
- Enter your Bronto REST Client ID.
- Enter your Bronto REST Shared Secret.
- Enable Is Mozu Sandbox? if you plan to test the application on a sandbox. When this setting is enabled, Kibo appends your tenant ID to every order to avoid duplicating order numbers and affecting production data.
- Enable Save Event History? to maintain logs related to this application.
- Click Save.
- 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.
- Open the Account Features tab.
- Select a customer set from the dropdown menu.
- Specify which Bronto list to add the customer set's contacts to.
- Specify sync options between Kibo and Bronto:
Enable Opt in/Out Sync from Kibo to Bronto Sends shopper information from Kibo 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 Kibo Sends your Bronto contacts' marketing preferences from Bronto to Kibo. Enable Contact Export Sends contact information from Kibo to Bronto about shoppers, including names, email addresses, and custom shopper attributes. - Click Save.
- 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.
- Open the Site Features tab.
- Select a site from the dropdown menu and then choose which features to enable or disable for that site.
Enable Order sync from Mozu to Bronto Sends order information from Kibo to Bronto. Enable Order Confirmation Email Sends an order confirmation email to shoppers after the checkout process is complete. Enable Order Abandonment Emails Sends an email to shoppers who began the checkout process 48 hours ago but who have not yet submitted the order. Enable Order Shipment Emails Sends an email to shoppers when their order ships. Enable Return Created Emails Sends an email to shoppers after they create a return. Enable Return Authorized Emails Sends an email to shoppers after you receive and accept a return in Kibo using the Orders module. Enable Return Rejected Emails Sends an email to shoppers after you reject a return in Kibo using the Orders module. Enable Return Closed Emails Sends an email to shoppers after you close a return in Kibo using the Orders module. Enable InStock Notification Emails Sends an email to shoppers when an item on their wishlist is back in stock. (Note that this is not supported for bundles.) Enable Welcome Emails Sends a welcome email to new shoppers. Enable Password Reset Emails Sends password reset emails to shoppers using a Bronto template instead of the default Kibo email. Turn on wishlist reminder emails Sends a reminder email after a specified number of idle Day(s) to shoppers who have items in their wishlists. - Click Save.
- Repeat the process for any other sites configured on your tenant.
Enable the App
After configuration, enable the Bronto Application to apply its functionality to your tenant.
- In Admin, go to System > Customization > Applications.
- Click Bronto Application by Mozu.
- Click Enable App.
After enabling the Bronto Application perform an initial export of shopper and order information from Kibo to Bronto.
Export Shopper Information to Bronto
Export shopper information using the Customers module extension. The export adds existing shoppers and their attributes to your Bronto contacts. After the first export, the Bronto Application automatically sends information about new shoppers to Bronto if you enable the contact export feature in the configuration settings.
- In Admin, go to the Customers module.
- Click the Bronto extension button (
) and select Bronto > Attributes. - Use the Attribute Mapping page to map shopper attributes gathered or created in Kibo , by customer set, to fields in your Bronto account. For example, you can map typical shopper attributes, like a shopper's first name, to a corresponding Bronto field. You can also map any custom shopper attributes you have created to a Bronto field. If you don't select a field for an attribute, it will not map to Bronto.
- Click Save.
- Click Sync to open the Sync page.
- Click Export All Contacts To Bronto.
- Click Export to Bronto to send existing shopper information and marketing preferences to Bronto.
Export Order Information to Bronto
Export order information using the Orders module extension. The export sends order information to Bronto about orders your site received prior to enabling the application. After you enable the application, new order information is automatically sent to Bronto if you enable the order export feature in the configuration settings.
- In Admin, go to Main > Fulfillment > Orders.
- Click the Bronto extension button (
) and select Bronto > Export. - Click Export.
You can now preview Bronto functionality on your site.
Use the App
- Customer Module Extension: Sync Contacts, Send Wishlist Reminders, View Logs, and Preview Emails
- Orders Module Extension: View Logs and Preview Order & Return Emails
- Abandoned Cart Widget
- Use API Variables to Customize Email Templates
Customer Module Extension
The Bronto Application adds an extension to the Customers module that allows you to sync contact information between Kibo 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:
- In Admin, go to the Customers module.
- Click the Bronto extension button (
) and select a page.
Sync Contacts Between Kibo and Bronto
Use the Sync page in the Bronto extension to update shoppers with their marketing preferences stored in Bronto. Any change in subscription settings in Bronto automatically updates in Kibo.
- Click Sync Marketing Preferences From Bronto.
- Click Sync from Bronto to import shopper information and marketing preferences from Bronto.
After you sync contacts between Kibo and Bronto, Kibo 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:
- Select an Email Type to preview from the drop-down menu.
- 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).
- Click Test Email to send the test email to the email address associated with your Kibo account.
Orders Module Extension
The Bronto Application adds an extension to the Orders module that allows you to view order export logs and preview emails sent to shoppers.
To view this extension:
- In Admin, go to the Orders module.
- 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.
- Select an Email Type to preview from the drop-down menu.
- 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).
- Click Test Email to send the test email to the email address associated with your Kibo account.
Abandoned Cart Widget
When a 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:
- Have the Bronto application configured for your tenant.
- Drop the "Bronto Conversion Tracking Script" widget onto the cart page.
- Log in to Bronto and copy the Tag Manager script code from Settings > Commerce.
- 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 exports an assortment of variables through the 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 | Shipments | Returns | Refunds | Welcome Email | Wishlist | Password Reset
In-Stock Notification Email
- productCode
- productName
- description
- fullDescription
- productUrl
- productQty
- productImageUrl_
- storeUrl
- storeName
- fromEmail
- fromName
- toEmail
Order Abandoned, Confirmed, or Shipped
- storeUrl
- storeName
- fromName
- fromEmail
- toEmail
- checkoutUrl (only for Abandoned order)
- orderNumber
- orderStatus
- paymentStatus
- subTotal
- discountedSubTotal
- discountedTotal
- shippingTotal
- shippingSubTotal
- shippingTaxTotal
- handlingTotal
- handlingTaxTotal
- itemTaxTotal
- taxTotal
- feeTotal
- total
- currencyCode
- fulfillmentStatus
- storeHours_#
- storeHours_sunday
- storeHours_monday
- storeHours_tuesday
- storeHours_wednesday
- storeHours_thursday
- storeHours_friday
- storeHours_saturday
- shippingAddressLine
- shippingAddress1
- shippingAddress2
- shippingAddress3
- shippingAddress4
- shippingCityOrTown
- shippingStateorProvince
- shippingPostalOrZipCode
- shippingCountryCode
- shippingEmail
- shippingFirstName
- shippingLastName
- shippingMiddleName
- shippingHome
- shippingMobile
- shippingWork
- billingAddressLine
- billingAddress1
- billingAddress2
- billingAddress3
- billingAddress4
- billingCityOrTown
- billingStateorProvince
- billingPostalOrZipCode
- billingCountryCode
- billingEmail
- billingFirstName
- billingLastName
- billingMiddleName
- billingHome
- billingMobile
- billingWork
- itemCode_#
- itemName_#
- itemImage_#
- itemQty_#
- itemFulfillmentMethod_#
- itemSubTotal_#
- itemExtendedTotal_#
- itemTaxableTotal_#
- itemDiscountTotal_#
- itemTaxTotal_#
- itemShippingTaxTotal_#
- itemShippingTotal_#
- itemHandlingAmount_#
- itemFeeTotal_#
- itemTotal_#
- paymentMethod_#
- amountRequested_#
- amountCollected_#
- amountCredited_#
- paymentStatus_#
- shippingDicounetName_#
- shippingDiscountValue_#
- shippingDiscountCoupon_#
- orderDiscountName_#
- orderDiscountValue_#
- orderDiscountCoupon_#
- orderAdjustment_#
- shippingAdjustment_# (only for Shipped order)
- shipmentTracking_# (only for Shipped order)
- shipmentItems_# (only for Shipped order)
- shipmentMethod_# (only for Shipped order)
- shipmentWeight_# (only for Shipped order)
- shipmentHeight_# (only for Shipped order)
- shipmentWidth_# (only for Shipped order)
- shipmentLength_# (only for Shipped order)
- pickupItems_# (only for Shipped order)
- parentOrderNumber_# (only for Multiship orders)
- childOrderNumber_# (only for Multiship orders)
- childOrderStatus_# (only for Multiship orders)
- childOrderPaymentStatus_# (only for Multiship orders)
- billingFirstName_# (only for Multiship orders)
- billingMiddleName_# (only for Multiship orders)
- billingLastName_# (only for Multiship orders)
- billingAddressLine_# (only for Multiship orders)
- billingCityOrTown_# (only for Multiship orders)
- billingStateOrProvince_# (only for Multiship orders)
- billingPostalOrZipCode_# (only for Multiship orders)
- billingCountryCode_# (only for Multiship orders)
- billingHome_# (only for Multiship orders)
- billingMobile_# (only for Multiship orders)
- billingWork_# (only for Multiship orders)
- shippingFirstName_# (only for Multiship orders)
- shippingMiddleName_# (only for Multiship orders)
- shippingLastName_# (only for Multiship orders)
- shippingAddressLine_# (only for Multiship orders)
- shippingCityOrTown_# (only for Multiship orders)
- shippingStateOrProvince_# (only for Multiship orders)
- shippingPostalOrZipCode_# (only for Multiship orders)
- shippingCountryCode_# (only for Multiship orders)
- shippingHome_# (only for Multiship orders)
- shippingMobile_# (only for Multiship orders)
- shippingWork_# (only for Multiship orders)
- itemOrderNo_# (only for Multiship orders)
Shipments
- shipmentNumber
- orderNumber
- orderSubmitDate
- shipmentStatus
- shipmentType
- total
- shippingTotal
- shippingTaxTotal
- handlingTotal
- handlingTaxTotal
- currencyCode
- fulfillmentStatus
- fulfillmentDate (only for Fulfilled shipment)
- shipmentAdjustment
- shippingMethodCode
- shippingMethodName
- shippingSubtotal
- shippingTaxAdjustment
- lineItemTotal
- lineItemTaxTotal
- lineItemTaxAdjustment
- lineItemSubtotal
- backorderCreatedDate
- cost
- dutyAdjustment
- dutyTotal
- externalShipmentId
- externalOrderId
- fulfillmentLocationCode
- handlingAdjustment
- handlingSubtotal
- handlingTaxAdjustment
- billingAddressLine
- billingAddress1
- billingAddress2
- billingAddress3
- billingAddress4
- billingCityOrTown
- billingStateOrProvince
- billingPostalOrZipCode
- billingCountryCode
- billingEmail
- billingFirstName
- billingLastName
- billingMiddelName
- billingHome
- billingMobile
- billingWork
- shippingAddressLine
- shippingAddress1
- shippingAddress2
- shippingAddress3
- shippingAddress4
- shippingCityOrTown
- shippingStateOrProvince
- shippingPostalOrZipCode
- shippingCountryCode
- shippingEmail
- shippingFirstName
- shippingLastName
- shippingMiddelName
- shippingHome
- shippingMobile
- shippingWork
- storeHours_#
- storeHours_sunday
- storeHours_monday
- storeHours_tuesday
- storeHours_wednesday
- storeHours_thursday
- storeHours_friday
- storeHours_saturday
- paymentMethod_#
- amountRequested_#
- amountCollected_#
- amountCredited_#
- paymentStatus_#
- itemCode_#
- itemName_#
- itemImage_#
- itemQty_#
- itemShipping_#
- itemShippingDiscount_#
- itemShippingTax_#
- itemTaxableHandling_#
- itemTaxableLineItemCost_#
- itemTaxableShipping_#
- itemUnitPrice_#
- itemDutyAdjustment_#
- itemHandleAdjustment_#
- itemHandleTaxAdjustment_#
- itemItemTaxAdjustment_#
- itemShipmentAdjustment_#
- itemOverridePrice_#
- itemOriginalOrderItemId_#
- itemOptionAttributeFQN_#
- itemActualPrice_#
- itemDuty_#
- itemLocationCode_#
- itemHandling_#
- itemHandleDiscount_#
- itemShipAdjustment_#
- itemHandleTax_#
- itemIsPackaged_#
- itemIsTaxable_#
- itemItemDiscount_#
- itemItemTax_#
- itemLineId_#
- itemLineItemCost_#
- itemShipTaxAdjustment_#
- itemPrice_#
- itemReadyForPickupQty_#
- itemPendingForPickupQty_#
- itemBOrderReleaseDate_#
- All above "item" parameters with "c" appended to front (e.g., "cItemName_#" for canceled items in the shipment) plus cItemCancelReason_#
Returns
- returnNumber
- returnType
- returnStatus
- returnProductAmount
- returnProductTaxAmount
- returnShippingAmount
- returnShippingTaxAmount
- returnAmount
- returnDeadline
- itemCode_#
- itemName_#
- itemDescription_#
- itemImageUrl_#
- itemReason_#
- itemQty_#
- storeUrl
- storeName
- fromEmail
- fromName
- customerName
- toEmail
Refunds
- orderNumber
- refundAmount_#
- refundDate_#
- paymentType_#
- storeCreditCode_#
- giftCardCode_#
Welcome Email
- storeUrl
- storeName
- fromEmail
- fromName
- customerName
- toEmail
Wishlist
- customerName
- fromEmail
- fromName
- storeUrl
- storeName
- productName_#
- productImage_#
- productPrice_#
- productUrl_#
- productSalePrice_#
- productDiscountPrice_#
Password Reset
- passwordResetLink
- firstName
- lastName
- storeName
- storeUrl
- fromEmail
- fromName
- customerName
- toEmail