blog-post-banner
Blog / Affiliate marketing

Postback/API configuration

Support Bodorek

1 December 2019
298
0

Postback or API integration is an approach that allows conveniently monitor statistics. It is especially useful for publishers who are affiliate networks themselves or are other similar entities. Postback allows tracking the leads in a real time, while the API interface periodically sends queries to the advertiser's server (in this case to MyLead).


Before you start the configuration, learn about the use of postback in affiliate marketing from our earlier article.

How to correctly configure postback?


First, go to For webmasters > Postback. You will find there a list of parameters that postback is able to pass to the publisher. The most common parameters necessary to correctly assign the leads to sub-publishers are the click identifier (clickid) and the sub-publisher identifier (affid). To define clickid it is best to use the [ml_sub1] parameter, and similarly the [ml_sub2] parameter to define affid.

To create a new postback click the Add a new Postback URL button. When you do this, a window with the following two fields will appear:

  1. Lead status that activates Postback - in this field select the event at which postback should start. These events determine the lead status change and are correlated with the statuses in the MyLead panel. The following variants are available:

    • Any - postback will be launched whenever the status changes (most commonly used option),
    • Available to pay - postback is activated when the lead in the MyLead panel receives the acceptance status and can be withdrawn,
    • Accepted - postback will be launched when the lead is registered in the MyLead system as pre-approved and waits for consideration by a direct advertiser,
    • Pending - will be activated when the lead is registered in the MyLead system as correctly made, but not yet analyzed (mainly CPS offers)
    • Rejected - the postback will start when the lead in the MyLead system changes its status to rejected.

  2. Postback URL” - in this field enter the address of publisher’s website that is used for counting statistics. A more detailed explanation of creating such an address can be found below. 

Creating postback URL


To the basic address of the tracking platform, the parameters that the publisher wants to be passed through the postback should be added. Let's assume that the platform address is:


https://tracking-platform/postback 


To create a correct postback link, add the "?" symbol at the end of the platform address, and right after it, assign the MyLead parameter to the publisher's parameter (remember to use square brackets). It should look like this: 


https://tracking-platform.com/postback?clickid=[ml_sub1]


If the publisher needs more parameters, separate them with the "&" symbol. It should look like this:


https://tracking-platform.com/postback?clickid=[ml_sub1]&affid=[ml_sub2]&transaction=[transaction_id]


[payout_decimal] parameter, which displays the payout in decimal format (e.g., 4.00),or [payout], which returns the value in cents (e.g., 400).


Also, make sure to add the [status]parameter to the postback if you have chosen the "Any" status. Otherwise, there might be complications in counting statistics.


Preparing a tracking link for postback


To ensure that the statistics will be transferred correctly, in addition to postback configuration, you need to create a tracking link based on the link that the publisher uses to promote a specific MyLead offer. Let's assume that the promotion link looks like this:

https://leadmy.com/p/XXXX/yyyy/1111


For the link to work properly, you must assign the appropriate parameters in the link to the postback parameters (you have to map them).


A correctly configured tracking link should look like this:

https://leadmy.com/p/XXXX/yyyy/1111?ml_sub1=parametervalueclickid&ml_sub2=publisherparametervalue


Parameters ml_sub1 to ml_sub5 that are passed for tracking, can be viewed in the generated leads in theStatistics tab -> Leads. This is especially useful if you need to verify the postback operation. 


For promotion among sub-publishers, you should use a link that was configured as described above.

WHAT POSTBACK IN AFFILIATE MARKETING CAN OFFER YOU?


Now that you know how to configure a postback, check out the benefits it can bring you. Explore our article about using postback in affiliate marketing.


Last update: August 1, 2023