Skip to main content
All CollectionsIntegrations
How to setup postback for affiliates?
How to setup postback for affiliates?
Nikhil Kandpal avatar
Written by Nikhil Kandpal
Updated over a month ago

In this article, we will discuss:

Overview


Postbacks are a crucial component of affiliate marketing, allowing you to track and credit your affiliates for the sales or conversions they generate. By setting up postbacks in Tapfiliate, you can ensure that your affiliates are properly rewarded for their efforts and incentivize them to continue promoting your products or services.

What are Tapfiliate Postbacks?

Tapfiliate postbacks are notifications sent to your affiliates' servers whenever a desired action is completed by a referred customer. These actions can include:

  • Sales: When a customer referred by your affiliate makes a purchase on your website.

  • Signups: When a customer referred by your affiliate signs up for your service or creates an account.

  • Leads: When a customer referred by your affiliate submits a lead form on your website.

When a conversion occurs, Tapfiliate sends a postback to the publisher, including the original Click ID as a macro. This allows the publisher to verify that the conversion is attributed correctly and ensure they receive appropriate credit for the referred business.

Setting Up Tapfiliate Postbacks

The affiliate postback setup is available to be set up by the affiliates as well as by the advertisers in the "affiliates" section, with the same interface.

To set up postbacks in Tapfiliate, follow these steps:

  • Navigate to the Affiliates section in your Tapfiliate dashboard.

  • Click on the "Add Postback" button and select the affiliate you want to create a postback for.

  • Enter a descriptive name for your postback (e.g., "Sale").

  • Choose the action type you want to track the postback for (e.g., "conversion").

  • Enter your affiliate's postback URL in the designated field. This is the URL that Tapfiliate will send a POST request to whenever the chosen event occurs.

Note: Your affiliates need to send the click_id information in the content key in the open parameters tm_subid1 to tm_subid10.

Example affiliate referral link: https://tapfiliateclicklink.com/?ref=abcxyz&tm_subid1=affiliate_click_id&tm_subid2=affiliate_sub_id

Use the ${click_subid} macro to share the subid data via postback. Setup screenshot attached below

  • (Optional) Set any custom parameters that you want to include in the postback data. These parameters can be used to provide your affiliates with additional information about the conversion, such as the order amount or the customer's email address.

  • Click the "Save" button.

Once you have saved the postback, Tapfiliate will automatically send a notification to your affiliate's server whenever the chosen event is triggered. Your affiliate can then use this data to track their earnings and measure the success of their promotional efforts.

Sharing external id to affiliates

You can share the external id to your affiliate's postback by using the ${conversion_external_id} macro. Example screenshot of how you can share the external id in the postback is given below:

Sharing meta data to affiliates


You can share information like the external id and the conversion meta datas via postback by exposing these meta data for the affiliates.

  • Expose the meta data for affiliates via Advanced settings.

  • In the postback section, use the custom value to share the exposed meta data

Testing Tapfiliate Postbacks

It's important to properly manage and test your Tapfiliate postbacks to ensure they are functioning correctly. Here are some tips:

  • Test your postbacks: Before launching your affiliate campaign, it's essential to test your postbacks to make sure they are sending data correctly. You can do this by using our "Test the postback" button and firing a test postback with your affiliates.

Managing Tapfiliate postbacks

You can manage your previously created affiliate postbacks from the postback section.

  • Edit: This allows you to edit a previously created postback

  • Pause: This allows you to pause a currently active postback

  • Delete: This allows you to delete a postback

  • Update your affiliates: If you make any changes to your postback URLs or parameters, be sure to notify your affiliates so they can update their tracking accordingly.

By following these steps, you can set up and manage effective Tapfiliate postbacks to track your affiliate marketing campaigns and ensure that your affiliates are properly rewarded for their contributions.

List of available macros

  1. ${program_id} - The unique identifier of the affiliate program.

  2. ${program_title} - The title or name of the affiliate program.

  3. ${currency} - The currency used for the conversion.

  4. ${conversion_id} - The unique identifier for the conversion.

  5. ${conversion_amount} - The total amount of the conversion.

  6. ${conversion_created_at} - The timestamp when the conversion was created.

  7. ${conversion_time} - The time of the conversion.

  8. ${conversion_status} - The current status of the conversion (e.g., pending, approved).

  9. ${conversion_meta_data} - Additional metadata related to the conversion.

  10. ${conversion_external_id} - To share the external id of the conversion.

  11. ${commission_amount} - The commission earned from the conversion.

  12. ${customer_id} - The unique identifier for the customer involved in the conversion.

  13. ${customer_created_at} - The timestamp when the customer was created in the system.

  14. ${customer_status} - The status of the customer (e.g., active, inactive).

  15. ${customer_meta_data} - Additional metadata related to the customer.

  16. ${click_id} - The unique identifier for the click that led to the conversion.

  17. ${click_time} - The timestamp when the click occurred.

  18. ${click_referrer} - The referrer URL of the click.

  19. ${click_subid} - The sub-ID attached to the click, often used for tracking purposes.






Did this answer your question?