Ambassador

The Ambassador Developer Hub

Welcome to the Ambassador developer hub. You'll find comprehensive guides and documentation to help you start working with Ambassador as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Ecommerce Widget

Integration: Ecommerce Widget Perfect for Etailers

Paste this JavaScript snippet on the "payment confirmation" page after a successful payment on your site.

The example code is pre-filled with campaign information for you, but you will need to alter the Remote Customer Email to correlate with your new customer.

Multiple campaign events can be triggered by specifying multiple campaigns separated by commas in the "mbsy_campaign_uid" variable. The events will occur in the order provided.

See the table below the code for additional data you can pass us.

Required Fields:

  • mbsy_campaign_uid
  • mbsy_email
Variable
Description
Options
Default

mbsy_campaign_uid

Your campaign's ID(s)

mbsy_email

Your customer's email address

mbsy_revenue

Revenue amount of the event

mbsy_transaction_uid

Unique transaction ID for the event

mbsy_message

Default share message

"I'm an ambassador of..."

mbsy_uid

Your customer's internal unique ID

mbsy_first_name

Your customer's first name

mbsy_last_name

Your customer's last name

mbsy_email_new_ambassador

Email login credentials to new ambassadors

1 - yes
0 - no

1

mbsy_deactivate_new_ambassador

New ambassadors created are deactivated

1 - yes
0 - no

0

mbsy_add_to_group_id

Define which group(s) new ambassadors will be created in. Using this parameter will override default group settings. Group IDs should be separated by commas. If mbsy_add_to_group_id=-1, then ambassador will not be added to any group

mbsy_event_data1

Custom field - related to event/commission

mbsy_event_data2

Custom field - related to event/commission

mbsy_event_data3

Custom field - related to event/commission

mbsy_modal_header

Text displayed in modal header

Thanks for your purchase!

mbsy_modal_message

Text displayed in modal body

Share your purchase with your friends and earn rewards!

mbsy_is_approved

Commission status

1 - approved
0 - pending

campaign setting

<script type="text/javascript">
        var mbsy_campaign_uid='0000'; // Required; Example for multiple campaigns:  var mbsy_campaign_uid='0000,0001';
        var mbsy_email='example@example.com'; // Required - must be replaced with your customer's email
        var mbsy_revenue='0.00'; // Optional - replace with your revenue
        var addthis_config = {
           data_track_clickback: false
        }
        var addthis_share = {
          templates : {
           twitter : "  (via @GetAmbassador)"
          }
        }
    </script>
    <script type="text/javascript" src="https://mbsy.co/v3/ecommerce/js/[[app:username]]"></script>

Ecommerce Widget