Configure Magento Connector Coupons

You can use the Magento Connector to manage coupon code assignment and the display of coupon codes used with your Magento site.

About this task

General Settings on the Coupon tab will configure a coupon redirect link that can be used in messages. This redirect link can be used with Coupon Manager coupon codes or coupon codes generated using Magento. It will not generate coupon codes. While these codes can be used with Coupon Manager, this app is not required if you want to use the codes directly with Magento.

The redirect URL for M2 is http://example.com/bronto/redirect/index?service=coupon&coupon=%%#couponCode%%. In your redirect URL, replace example.com with the domain used for your Magento site. Settings can be used to configure the messages that will be displayed to contacts for each status of a coupon.

Additionally, you can use Create New Coupon Generator to configure a coupon generator that you can point to when you want Bronto to generate coupons in messages when they are sent.

Coupons generated from Magento can be added to your message using the API tag %%#couponCode%%. For more information about API tags see API Message Tags.

Procedure

  1. Go to Settings > Integrations > Connector.
  2. Locate the connector you want to work with and click its Edit link.
  3. Click Coupons.
  4. Set Enable Connection to Yes.
  5. Optional: If you want to use a different query parameter than coupon in the URL for valid coupons, enter it in the Coupon Code Query Parameter box.

    If you change the query parameter, make sure the change is reflected in the redirect URL outlined above.

  6. Optional: If you want to use a different query parameter than invalid_coupon in the URL for invalid coupons, enter it in the Invalid Coupon Query Parameter.
  7. If you want to provide a notification for contacts when they try to use a coupon in your store set Display Message to Yes and configure the message for each type of message:
    • Success Message is used when the coupon was successfully added to the shopping session.
    • Invalid Message is used when the coupon could not be added because it is invalid.
    • Depleted Message is used when the coupon pool has been used to completion.
    • Expired Message is used when the coupon has expired.
    • Conflict Message is used when the shopping session or cart already has a coupon applied.
  8. Click Save Changes.
  9. Click Create New Coupon Generator to configure a coupon generator you can point to when you want Bronto to generate coupons in messages when they are sent.

    This can populate an existing Shopping Cart Price Rule in Magento, and be dynamically included in messages that are triggered by the integration sent through Bronto.

  10. Enter a name for the generator in the Name box.
  11. Set Enable Connection to Yes.
  12. Connect the generator to a Magento shopping cart price rule:
    1. Click the Shopping Cart Price Rule Select button.
    2. Select from the Coupon list.
    3. Enter in the Coupon Code box.
    4. Select whether you want to Use Auto Generation.
    5. Click Confirm.
  13. Select the format to use for coupon codes from the Code Format list.
  14. Set the number of characters to use for the coupon code in Code Length.
  15. Optional: Enter a prefix to add to generated coupon codes in the Code Prefix box.

    This can be used to help identify groups of coupon codes and to group redemption metrics.

  16. Optional: Enter a suffix to add to generated coupon codes in the Code Suffix box.

    This can be used to help identify groups of coupon codes and to group redemption metrics.

  17. To add dashes to coupon codes after so many characters set the desired interval in the Dash Every X Characters.

    Dashes can make long coupon codes easier to read.

  18. Optional: If you use Coupon Manager and want to allow Magento Connector to replenish coupon codes to a campaign:
    1. Set Coupon Campaign Sync to Yes.
    2. Select the Coupon Manger campaign from the Coupon Campaign list.
    3. Set the Replenish Threshold.

      When the unused coupon amount dips below the Replenish Threshold, the Magento Connector uploads coupons codes equal to the Replenish Amount to the Coupon Manager campaign specified.

    4. Set the number of coupon codes you want to generate in the Replenish Amount box.
    5. Optional: Use Replenish Until to enter a date you want to stop replenishing coupons.
  19. Click Save to save the generator.
  20. Repeat the Create New Coupon Generator steps, as necessary, to create more coupon generators.