​

Overview

Use targeted promotions to trigger promotions for your shoppers based on the sale source they originate from, increasing your conversion rate and maximizing customer lifetime value while accounting for various criteria, such as website URL or domain localization.

Availability

This feature is available to all 2Checkout accounts and applies only to Regular promotions.

Source parameter requirements 

• Use UTF-8 encoding.
• Use URL encoding if populating the SRC parameter with a link.
• Consider hashing long URL parameters instead of using them as they are.

Workflow

1. Define a product promotion by following the steps described here.
2. Set the promotion to trigger automatically when shoppers add the products to checkout using this option Auto apply discount(instant discount), if you want to offer discounts based on the values of the SRC parameter alone, without requiring customers to enter a coupon code. 
3. Use the Sources text box to define one or multiple sale sources that should trigger your promotion. Enter one source per line.
   
   • The sources are the values of the SRC parameter you include in the buy link.
4. Generate buy links using the corresponding SRC parameters for each of your localized promotions.
   
   • Example: If you defined a promotion to be triggered by a source called HomePage, your buy link should contain the &SRC=HomePage parameter.

Use cases

Target shoppers in specific countries

Let's say you own three localized domains for your online store, each with the same product portfolio.

• www.YourStore.com for international audience
• www.YourStore.es for Spanish audience
• www.YourStore.fr for the French audience

You might want to offer higher discounts to Spanish and French shoppers who buy Product A than you do to visitors buying from your international website.

Here's how to use this feature to do exactly that.

1. Let's start by adding a promotion for international shoppers. Add a product promotion for Product A offering a discount of 15% by following the steps described here.
2. Next, add the same promotion for the same product, with a discount of 20%, only this time, enter Spanish in the Sources box. This applies the 20% discount only to shoppers buying from www.YourStore.es. Save the promotion.
3. Add a third promotion for the same product, offering a 25% discount. This time, enter French in the Sources box. This applies the 25% discount only to shoppers buying from www.YourStore.fr. Save the promotion.
4. Follow the steps described here to generate three different buy links, one for each of your domains.
   
   • One buy link using the Spanish value for the link source parameter. Add this link to your www.YourStore.es store.

   • https://www.YourStore.es/order/checkout.php?PRODS=1234567&QTY=1&CART=1&CARD=1&SRC=Spanish
     

   • One buy link using the French value for the link source parameter. Add this link to your www.YourStore.fr store.
     

     https://www.YourStore.fr/order/checkout.php?PRODS=1234567&QTY=1&CART=1&CARD=1&SRC=French
     

   • One buy link with no source parameter for everyone else. Add this link to your www.YourStore.com store.
     

     https://www.YourStore.com/order/checkout.php?PRODS=1234567&QTY=1&CART=1&CARD=1
     

Promotions triggered by sale sources take priority over promotions without a sale source. This means that 2Checkout automatically applies the second promotion to all orders placed on www.YourStore.es and the third promotion to all orders placed on www.YourStore.fr.

Orders placed on any other domain get the first promotion applied.

Target shoppers by geolocation

Let's say you own an international online store, with a standalone product portfolio and you need to differentiate discounts based on shopper geography, offering higher promotions to those in North and South America, compared to those in EMEA and Asia and Australia, when they acquire the same product, InternationalSubscription. 

Here's how to use this feature to do exactly that.

1. Let's start by adding a promotion for North and South American shoppers. Add a product promotion for InternationalSubscription offering a discount of 30% by following the steps described here. Enter Americas in the Sources box.
2. Next, add the same promotion for the same product, with a discount of 25%, only this time, enter EMEA in the Sources box. This applies the 25% discount only to shoppers buying Europe, Middle East, and Africa. 
3. Add a third promotion for the same product, offering a 10% discount. This time, enter AsiaAndAU in the Sources box. This applies the 10% discount only to shoppers buying from Asia and Australia.
4. Follow the steps described here to generate three different buy links, one for each of your domains.
   
   • One buy link using the Americas value for the link source parameter. 

   • https://www.YourStore.es/order/checkout.php?PRODS=1234567&QTY=1&CART=1&CARD=1&SRC=Americas
     

   • One buy link using the EMEA value for the link source parameter. 
     

     https://www.YourStore.fr/order/checkout.php?PRODS=1234567&QTY=1&CART=1&CARD=1&SRC=EMEA
     

   • One buy link using the AsiaAndAU value for the link source parameter.
     

     https://www.YourStore.com/order/checkout.php?PRODS=1234567&QTY=1&CART=1&CARD=1&SRC=AsiaAndAU
     

5. Next, you need need to build logic on your online store to differentiate these users based on their location (IP geolocation) or on their browser language and serve the appropriate checkout links and the associated discounts. For example, shoppers located in the US and Canada would see the link below and get a 30% discount. 

   https://www.YourStore.es/order/checkout.php?PRODS=1234567&QTY=1&CART=1&CARD=1&SRC=Americas
   

Reporting

Monitor campaign results in real-time using the Top Promotions report or the Sales Source Report to see which links are performing better and identify the top converting promotions. 

Limitations

This feature is now available for affiliate or reseller (partner) promotions. 

Overview

2Checkout's lead management is a smart and easy way to reduce customer churn and gain useful insights into what drives customers to cancel automatic renewals. Use the Lead object to configure lead management campaigns via JSON-RPC API 6.0 to reduce unfinished payments and cart abandonment.

You can use lead management to:

• run a report on unfinished payments
• send abandoned shopping cart follow-up emails
• request invoices

Overview

Use the Partner object to search and retrieve partner information.

Structure

Attributes

Overview

The object below is returned directly or within a successful response from the following API requests:

Create promotion                          Update promotion                            Retrieve a promotion                            Search promotions

Promotion object

Overview

The usage-based/on-demand/pay-as-you-go pricing model allows merchants to charge their customers on the consumption or overage of a billable service or resource, usually on top of a recurring flat rate. 

Use the Usage object to manage (add, update, delete, retrieve, and import) usage via the 2Checkout API (SOAP API 6.0).

Parameters