Conversion Tracking API

Conversion Tracking API Overview

The Conversion Tracking API is used to track the conversion of goals such as reaching a landing page, subscription, or sign-up.

 

Request

The request is an HTTP GET request as follows:

http://syndication.example.com/tag.php?goal=1b9b3786eae526755467c2593d194005&tag={conversions_tracking}&skey=1234567>&cpa=0.1

 

ParameterDescription
GoalThe Goal ID as created in the Admin Panel, e.g. 1b9b3786eae526755467c2593d194005.
TagA data object generated by EXADS and usually replaced in the click URL through the {conversions_tracking} token.
CPA/skey*A numeric value defining the CPA bid at runtime + skey (an account-specific secret key provided by the EXADS platform).

*only if CPA is enabled

 

Response

The response will show either as 'OK' or as one of the errors below:

ResponseMeaning
OKThe request is OK.
ERROR: This conversion has already been notified and saved.A conversion goal for this conversions_tracking ID (tag) has already been registered within the last 24 hours.
ERROR: Tag is invalid!The format of the ID (tag) is not correct.
ERROR: No tag data.The tag or conversions_tracking ID is missing.
ERROR: Goal ID is invalid.The format of the Goal ID is not correct. Goal IDs are 32 characters of hexadecimal (0-9, a-f).
ERROR: No Goal ID.The tag or Goal ID is missing.
ERROR : Goal value is invalid.The format of Goal value should be a monetary number.

 

If the network has CPA enabled, there may also be these additional responses:

 

ResponseMeaning
ERROR: Price is invalid.The Value of the CPA price parameter is invalid. This should be a value between 0 and 100 (inclusive).
ERROR: Secret key is invalid.The secret key provided is incorrect. Your secret key can be found under Campaigns > Conversion Tracking at the bottom of the screen.

 

Error Examples

ERROR: Tag is invalid!

http://syndication.examplesite.com/tag.php?goal=1b9b3786eae526755467c2593d194005&tag=123456789

 

ERROR: No tag data.

http://syndication.examplesite.com/tag.php?goal=1a76578475674857&tag=

 

ERROR: Goal ID is invalid.

http://syndication.examplesite.com/tag.php?goal=4564&tag={conversions_tracking}

 

ERROR: No Goal ID.

http://syndication.examplesite.com/tag.php?goal=&tag={conversions_tracking}

 

ERROR: Goal value is invalid.

http://syndication.examplesite.com/tag.php?goal=c10a67e8bce7a35bcd9bb5a519f4b2b7&value=10
← Renderers