Server to Server (S2S) Conversion Tracking

A guide on the benefits of server to server conversion tracking and how to get it setup

NOTE: this tracking method should not be used in conjunction with conversion pixels. Using both together will result in duplicate conversions reported

How S2S Tracking Works & the Benefits:

Unlike standard image pixel tracking, server to server (S2S) tracking (also known as cookie-less tracking and postback URL tracking) does not require any modifications to an Advertiser’s site or landing page code. Whenever a unique click to a campaign occurs, instead of using a cookie, Revcontent appends a unique ID (uuid) to the Advertiser’s destination URL, which is stored server-side. Once a successful conversion occurs, the unique ID (uuid), along with any conversion events, are sent back to Revcontent from the Advertiser’s server by way of postback, and are matched to the user.

S2S is especially useful for mobile app tracking, where limitations with cookie placements are likely to exist. Additional benefits over standard pixel tracking include greater reporting accuracy, increased security, and more opportunities for optimization.



S2S Postback Structure 

  • Endpoint:
    https://trends.revcontent.com/api/v1/conversion.php
  • Supported Methods:
    POST & GET 
  • Required Parameters:
    api_key - your api access key

    uuid - unique ID (the "rc_uuid" value) identifying the user who initiated the click

    amount - value of each unique conversion
  • Optional Parameters:
    user_ip - IP address of the user that initiated the click

    user_agent - user agent string of the user that initiated the click


Example of Final Postback Structure:

https://trends.revcontent.com/api/v1/conversion.php?api_key=<your_api_key>&uuid=<rc_uuid>&amount=<conversion_value>


Summarizing the Process

  • Advertiser's content is actively serving on widgets
  • The content is clicked on
  • The "rc_uuid" parameter and unique value (uuid) are appended to the content's destination URL

The "rc_uuid" parameter and value are automatically appended to your content destination URLs following a successful click event. Do not manually add "rc_uuid" to your campaign's tracking variables or content URLs

  • The Advertiser captures the unique "rc_uuid" value appended to their content's URL, and following a conversion event sends it back to Revcontent via postback with all three required parameters and their correlating values filled in
  • Upon submission, the postback conversion data is matched up with the original click event & a conversion is generated in the Advertiser’s account

Setting Up Custom UUID Values

If your tracker requires a specific value that differs from our rc_uuid, you can follow the steps below to set up that value for your Postback URL

  • First, you'll need to login and access the campaign you want to get set up.
  • You'll need to head to that campaign's settings area and scroll to the bottom of that page until you see the UTM tracking line in the Tracking Section.
  • Click the cog wheel in the far right of the UTM line, this will open a pop up.

  • Scroll to Add Custom Key Value Pairs
  • The first line (Custom Key) you'll want to add your value, external_id  (or other value) The second line (Custom Value) you'll need to add {conversion_uuid}

download (1)

Troubleshooting

  • If your postback response is coming back invalid, ensure all 3 required parameters and their correlating values are being passed:
    api_key=<your_api_key>
    uuid=<rc_uuid_value>
    amount=<your_conversion_value>
  • Ensure your API key does not have any typos
  • If you've manually added the "rc_uuid" parameter to your campaign's tracking variables or content URLs you'll need to remove it. This parameter and its correlating unique value are automatically appended to your content URLs following a successful click event.
  • If you're not receiving the "rc_uuid" values we're passing, confirm:
    1) your campaign is actively serving. If it's not active, the parameter and values will not be appended.
    2) if you're using redirects, confirm you're forwarding all parameters thru to the final landing URL. Failure to do so will result in parameters and their values being dropped upon the initial redirect.

If you've double-checked all of the above and are still experiencing issues, please reach out to your account representative or support@revcontent.com to troubleshoot your configuration further