Adverse user guide

Adverse user guide

  • Docs

›Guides

Guides

  • Adverse script
  • Templates
  • Creative Macros
  • Tracking Conversions
  • Network Setup
  • Dynamic Form Tutorial
  • Publisher Events API
  • Ad Scoring
  • Score Key
  • Integration: Has Offers

Tracking Conversions

Adverse allows multiple ways of tracking conversions. An advertiser can send a conversion event to Adverse server-to-server (postback) or client-to-server (pixel).

Server to Server (Postback)

Server to server tracking is preferred. When a visitor clicks on an Ad, the visitor is taken to the Creative Target URL. By default, Adverse will append the adverseClickId to this url as a query parameter. After a conversion, the Advertiser should hit the Adverse Postback URL:

https://adverse.lincx.la/convert?adverseClickId=XXX&price=YYY where XXX is the adverseClickId mentioned above and YYY is the value of the conversion in USD.

Passing the adverseClickId to the Advertiser

The Advertiser may require the adverseClickId to be passed as the value of a specific query parameter of the Creative Target URL such as s1 or aff_click_id. For example, if the Advertiser requires the adverseClickId to be set as the value of aff_click_id we would change the Creative Target URL from:

https://advertiser.com/offer

to

https://advertiser.com/offer?aff_click_id={{adverseClickId}}

For more information please see our other documentation on Creative Target URL Macros

Receiving the adverseClickId from the Advertiser

In the above section we show how to send the adverseClickId to the Advertiser. If the Advertiser platform has macros you'll want to use them to insert the adverseClickId and price into the Adverse Postback URL. For example, if the Advertiser uses the aff_click_id macro to store the adverseClickId (as shown above) and amount macro for the conversion price, you would enter the following Postback URL into their system:

https://adverse.lincx.la/convert?adverseClickId={aff_click_id}&price={amount}

All systems are different, be sure to consult your Advertiser account representative or their documentation for how to properly set up Postback URLs on their system.

Client to Server (Pixel)

Some Advertisers may not support a server-to-server Postback URL. Instead they may need a client-side iframe pixel:

<iframe src="https://adverse.lincx.la/convert?adId=AAA&price=BBB" style="display: none" />

Replace AAA with the adId and BBB with the conversion price. To find the adId, please consult your Ad list in your account:

Please note that this method relies on the visitor's browser and cookies to send tracking information and is less reliable than using server-to-server click ID-based tracking.

Testing Conversions

Some Advertiser platforms allow you to test fire conversion pixels. For Adverse to register a conversion, an actualized adverseClickId must be used. To find an actualized adverseClickId, do the following:

  1. Load your Zone in a browser
  2. Right click an Ad and copy the url
  3. Click on the Ad
  4. Paste the url into the box below
  5. Copy the Conversion URL that appears and paste it into the Advertiser test interface

After pasting the target URL into the box above, the Conversion URL should appear. You can either use the Advertiser platform to test the conversion, or you can test the conversion directly by navigating to that URL directly in your browser. You may also choose a price other than 0. You may also convert multiple times -- if you convert with a price of 5 first, you can zero-out the revenue by converting again with a price of 0.

← Creative MacrosNetwork Setup →
  • Server to Server (Postback)
    • Passing the adverseClickId to the Advertiser
    • Receiving the adverseClickId from the Advertiser
  • Client to Server (Pixel)
  • Testing Conversions
Copyright © 2022 Adverse