TRACK UpdateConversionDisposition API

Updated on 2014-04-08
Current Version: Version 2
Deprecated Version: -
Requests Allowed: GET/POST/SOAP

 

Summary:

Allows you to change the disposition of a single conversion. 

Resource/WSDL Page:

http://<your_domain_here>/api/2/track.asmx?op=UpdateConversionDisposition

 

Parameters

api_key
Required Value
Type: STRING
Length (Max): 50

API key can be found in the user interface under setup> Permissions. Only accessible to administrators.

Example Values: dNJFmId9rI

request_id
Required Value
Type: INT
Length (Max/Min): NA

This is the unique identifier of the click, and can be found both on the click reports and the conversion reports.

Example Values: 3970121

 

offer_id
Required Value
Type: INT/
Length (Max/Min): NA

 

This is the unique identifier of the Offer. Can be found in the User interface in the offer card.

Example Values: 125, 78678, 789646

disposition_id
Required Value
Type: INT
Length (Max/Min): NA

 

Not currently available in the user interface. Can be obtained with the AcceptedDispositions API.

Example Values: 25, 75, 3

note
Optional
Type: STRING
Length (Max/Min): NA

 

Optional value to reference the change you've made.

Example Values: Any string.

 **Note all optional parameters still need to be passed through in the actual call. These parameters do not need a value (therefore you can use a null value). 

 

Example Request

GET

http://demo.cakemarketing.com/api/2/track.asmx/UpdateConversionDisposition?api_key=dNJFmId9rI&request_id=3970121&offer_id=0&disposition_id=15&note=API-Docs-Test

 

Sample XML Response:

<update_conversion_disposition_response xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://cakemarketing.com/api/1/">
<success>false</success>
<message>Invalid Disposition ID</message>
<conversion_id xsi:nil="true" />
</update_conversion_disposition_response>

 

Example Error Messages: 

Error Message

Likely Cause

Invalid API Key

API key does not exist or is expired.

Invalid Disposition ID

Disposition ID does not exist or is invalid.

Conversion Not Found

Conversion cannot be found using the supplied request_id and offer_id.