Upsells: A to Z

From TMM Wiki
Jump to navigationJump to search
Members Admin
The Members Admin
View Member Details
Add Member
MySQL Auth
Mod Authn DB
Multisite Access
Member Logging
Member Password Retrieval
OpenID Connect
Mod Auth OpenIDC
ID Numbers
Upsells Admin
The Upsells Admin
Configuring Cross Sells
Configuring Upsells
Cross Sell Supported Billers
Upsell Supported Billers
Process Gateway Cross Sales Outside NATS
Cross Sells: A to Z
Upsells: A to Z
Upsell Plus
Setting Rules


Although the exact setup for an upsell with each biller is different, here are some general guidelines on how to set up Upsells in NATS v4.

Setting up the Upsells


Basic Setup

The first step (normally) involves setting up the upsell on the biller's end. Please refer to your biller's documentation for more information on how to configure a upsell in their admin.

After that is complete, to set up an outgoing upsell in NATS, visit your Upsells Admin:

NATS4 Upsells Admin.jpg

Then you need to click on Outgoing Upsells:

Outgoing Upsells

At the bottom, you should see a dropdown of billers...

No Available Outgoing Upsells

This dropdown will only contain billers that NATS will support sending upsells to, and will only contain billers that you already have configured in your Billers Admin. Select the biller that will handle the outgoing upsell from the dropdown and click "Add New Option".

You will then see a page similar to this (the exact layout will vary from biller to biller):

Configuring Biller for Outgoing Upsell

  • The Title text box is purely for your own internal reference.
  • If you activate the Enable for all Options checkbox, NATS will trigger this upsell anytime it sends a surfer to the biller handling the upsell. Otherwise, the upsell will never fire until you set up rules for your upsell.
  • The information collected in the Biller Info section will vary greatly from biller-to-biller. However, almost all billers will require a field called Ref Code. This field links the referring site to the site that is going to receive the upsell. If you are doing upsells between two of your own sites, NATS will use this field to link the outgoing and incoming upsells. NATS has a tool that will generate the Ref Code for you. See this part of the article for more details.
Upsell Rules

In order for you outgoing upsell to be triggered, you have to set up rules to tell NATS when to trigger the outgoing upsell. You can see/edit these rules by clicking on the Shuffle 16.gif icon. You should see a page similar to this:

Configuring Rules for an Outgoing Upsell

  • The Type specifies whether the rule you are setting up is a "SHOW" rule or a "HIDE" rule. If this rule is a match based on the other fields, this will let NATS know whether or not to trigger the outgoing upsell. The IGNORE setting will disable this rule entirely but not delete it.
  • The Affiliate field restricts the rule to a specific affiliate's traffic.
  • The Option field lets you pick which option this rule will apply for.
  • The Program field allows you to restrict the rule to a certain program.

Be sure to click Save Rule when you want to add the rule.

NOTE: You must have at least one rule set up in order for the upsell to be triggered.


Basic Setup

The first step (normally) involves setting up the upsell on the biller's end. Please refer to your biller's documentation for more information on how to configure a upsell in their admin.

When you visit your Upsells Admin, click on the white tab at the top-left that says "Incoming Upsells":

Incoming Upsells

Then to set up a new incoming upsell, first pick the biller that will be handling the upsell as well as the site that will receive the upsell and the program the transaction will be paid out under:

Incoming Upsells

From there, you'll be able to add the details for your incoming upsell:

Configuring Biller for Incoming Upsell

  • The Program dropdowns will only contain valid Cross Sale Program types.
 If no programs are available, please configure a new Cross Sale Program type program via the Programs Admin
  • The Details section allows you to set some basic details for the upsell, such as the internal title of the upsell, the initial amount/days, and rebill amount/days.
  • The Biller Info section is where you tell NATS the information that NATS will use to process the upsell (The information collected varies greatly from biller to biller).

Click on Save Changes when you are done.

Linking an Outgoing Upsell to an Incoming Upsell

If you are sending upsells between two of your NATS sites, NATS provides a tool that will generate a ref code it can use to link the outgoing and incoming upsell. The tool will use data from a specific campaign, program, and upsell to generate a ref code. You can access this tool by visiting internal.php?page=xsells on your NATS installation. Pick the site, program, and campaign from the dropdowns and click on Apply Changes.

You should then see something similar to this:

Ref Codes

You can then take that ref code, go back to your Upsells Admin, and then click on the pencil Pen 16.gif for the outgoing upsale you wish to link to. From there, copy/paste the ref code you got from the previous page:

Configuring the Ref. Code in the Admin

Using UpsellPlus

Upsells let you offer incentives for your members to join other sites after they have joined a site. The member will need to complete an upsell by clicking on a given link.

Give the following link to your users to give them the upsell saved:

  • http://<linkdomain>/signup/upsellplus.php?site=<siteid>&username=<username>
    • Siteid and Username is the preferred way of doing it.
  • http://<linkdomain>/signup/upsellplus.php?memberid=<memberid>&natssess=<nats_session>&site=<siteid>

The first link is preferred. Replace <linkdomain>, <memberid>, <nats_session>, <siteid> and <username> with your link domain and the member's member id, session id, site id and/or user name respectively.

Additional optional variable can be added for the desired effect:

  • If you want the user be automatically submitted for the upsell, you can add the variables '&upsellid=<upsellid>&email=<email>&submit=1'. <upsellid> will be the id number (of the Outgoing Upsell) from the Upsells Admin and the <email> will be the email for the member.
  • If you want to pre-check certain upsells that are shown, you can add '&upsellids=<upsellid_list>'. <upsellid_list> should be a comma seperated list of the Upsells ids that you want the user to see checked (e.g. upsellids=1,2,5).

The last step you will need to do is setup 3 new site templates.

  • gateway_upsell will be shown to the user when they click on the link given to them.
  • page_upsell_approval will be shown to the user when their upsell is approved.
  • page_upsell_denial will be shown to the user when their upsell is denied.