Campaigns Postback

Last updated on 

What is a Postback URL?

A Postback URL is used to send information about conversions (e.g., registrations, sales) from the advertiser to our system. This allows us to track events and build analytics.

Basic Postback URL format

https://s2s.adness.co/v1/conversion?clickid=[REQUIRED]&revenue=[OPTIONAL]&type=[OPTIONAL]&id=[OPTIONAL]

Parameters:

  • clickid – unique click ID provided by us (required parameter).
  • revenue – conversion amount. Default value = 0.
  • type – event type. Can be any text value (e.g., signup, sale). Default = default.
  • id – conversion identifier (any text value). Default = empty.

How to pass multiple events?

If you have several types of events (e.g., signup and sale), you can distinguish them using the type parameter. If you want to pass both events, you will need to set up two links for each event in your platform.

Examples (static values):

  • Event: Signup
https://s2s.adness.co/v1/conversion?clickid={your_clickid_parameter}&type=signup&revenue=0
  • Event: Sale
https://s2s.adness.co/v1/conversion?clickid={your_clickid_parameter}&type=sale&revenue={payout}

Examples (dynamic values):

If your tracking system defines events with its own codes or names, you can dynamically pass them in the type parameter:

https://s2s.adness.co/v1/conversion?clickid={your_clickid_parameter}&type={event_name}&revenue={payout}

👉 In this case, the {event_name} value you send (e.g., signup, sale, deposit) will be saved and displayed in our system exactly as you pass it.

Best Practices

  1. Use clear and consistent names for events in the type parameter (e.g., signup, sale, deposit).
  2. For non-monetary events, use revenue=0.
  3. For paid events, pass the actual value in the revenue parameter (static or dynamic).