Welcome to our Help Center

Setting Up Postbacks

Postback URLs can be configured either by an Affiliate Manager or by the Affiliate themselves.

Before configuring a Postback URL, ensure that the required Postback Events have been enabled. For instructions, refer to How Do I Allow An Affiliate To Set Up a Postback?

Postback URLs support dynamic placeholders that are automatically replaced with customer and tracking information when the postback is sent.

Placeholder Description
{customer.id} Unique identifier of the customer.
{payload} Payload value supplied during click tracking.
{s2s.req_id} The s2s.req_id value supplied during click tracking.
{s2s.pub_id} The s2s.pub_id value supplied during click tracking.
{media.id} ID of the promotional media used.
{media.name} Name of the promotional media used.
{landing_page.id} ID of the landing page used.
{landing_page.name} Name of the landing page used.
{campaign.id} Campaign ID used during the referral.
{campaign.name} Campaign name associated with the referral.
{brand.name} Brand associated with the conversion event.

Note: The affiliate's receiving server must be configured to interpret these values correctly once the request is received.


How Can an Affiliate Set Up Their Own Postbacks?

  1. Log in to the Affiliate Front End.
  2. Navigate to Postbacks from the main menu.
  3. Select the event(s) you wish to configure.
  4. Enter the Postback URLs and replace the required parameters with the appropriate MyAffiliates placeholders.
  5. Save the configuration.

Example: 
If an affiliate's tracking platform expects the following URL:

Original Postback Link:
http://www.affiliateserver.com/conversion?c=350&clickid={clickID}&media={mediaID}&customer={CustomerID}

It should be configured in MyAffiliates as:

http://www.affiliateserver.com/conversion?c=350&clickid={s2s.req_id}&media={media.id}&customer={customer.id}

For a downloadable version of this article to send to your affiliates, click here.


How Can An Affiliate Manager Set Up Their Affiliate’s Postback?

  1. Navigate to the affiliate's profile in the BackOffice.
  2. Select Postbacks from the left-hand menu.
  3. Open the Allowed Events tab and enable the required postback events.
  4. Open the Postback URLs tab and enter the Postback URL(s) for the affiliate replacing the required parameters with MyAffiliates Placeholders.
  5. Save the changes.

Setting Up the Tracking Link for Postback Parameters

When setting up a postback, it is important to ensure that any information the affiliate expects to receive in the postback is first passed to MyAffiliates through the tracking link.

If the information is not generated by MyAffiliates or stored within the tracking token, it must be included as a tracking parameter when the customer is referred. MyAffiliates can then store this information and pass it back to the affiliate when the relevant postback event occurs.

For example, if an affiliate expects a click ID to be included in the postback, the click ID must first be passed to MyAffiliates through the tracking link. MyAffiliates does not generate the click ID, so it must be supplied by the affiliate's tracking system.

Example
If the postback is configured in MyAffiliates as:

http://demo.myaffiliates.com/conversion.php?cid={s2s.req_id}&brand={brand.name}&var1={payload}

The tracking link should be configured to pass the required parameters:

https://record.demo.myaffiliates.com/_KOhwZ3kbWkqg8FyRIUdfImNd7ZgqdRLk/1/?payload=TopBanner&s2s.req_id={clickid}

 

In this example:

{s2s.req_id} in the postback is populated using the s2s.req_id value passed through the tracking link.
{payload} in the postback is populated using the payload value passed through the tracking link.
{brand.name} does not need to be included as a tracking parameter because MyAffiliates already has the brand information associated with the customer.

Therefore, the tracking link must include any external parameters that the affiliate wants MyAffiliates to pass back through the postback.

Note: If a parameter is not passed to MyAffiliates when the customer is referred, MyAffiliates will not have the value available to include in the corresponding postback, and the postback will fail.
 

Was this article helpful?

Yes No

Thank you for your feedback!

×
Select company

You are related to multiple companies. Please select the company you wish to login as.