TRACK UpdateConversionPrice API Version 2

Ron Torres

Modified on: Tue, 15 Sep, 2015 at 4:25 PM

TRACK UpdateConversionPrice API

Updated on 2014-04-07
Current Version: Version 2
Deprecated Version: V1
Requests Allowed: GET&SOAP

Summary:

Returns a message indicating whether or not the conversion price was updated.

Resource/WSDL Page:

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

Parameters

api_key Required Type: STRING Length (Max/Min): 50	Must be a valid API keu (existing and NOT expired) Example Values: Fo35NRAqvFLXoZxqB4aVMhh
request_id Required Type: INT Length (Max/Min): NA	Click Request Session ID {See export.asmx > Conversions} Example Values: 123456
offer_id Required Type: INT Length (Max/Min): NA	Must be an existing offer ID Example Values: 123456
add_to_existing Required Type: BOOL Length (Max/Min): NA	Add Amount to Existing Revenue? ["TRUE" = Add, "FALSE" = Overwrite] Example Values: 123456
amount Required Type: DECIMAL Length (Max/Min): NA	Revenue to be Added/Overwritten [Use a negative Dollar Amount to Remove Credit] Example Values: -123.45
mark_as_returned Required Type: BOOL Length 9Max/Min): NA	Mark the Conversion as Returned? ["TRUE", "FALSE"] Example Values: True
note_to_append Required Type: STRING Length (Max/Min): NA	Freeform Notes. Can be left blank. Example Values: notes to append
effective_date_option Required Type: STRING Length (Max/Min): NA	Accepts "today", "conversion_date" or "custom" Example Values: today
custom_date Required Type: DATE Length (Max/Min): NA	Allowed formats: "YYYY-mm-dd", "dd-mm-YYYY" Example Values: 2014-04-24, 24-04-2014

**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/UpdateConversionPrice?api_key=dNJFmId9rI&request_id=3420071&offer_id=1000610&add_to_existing=TRUE& amount=15.00&mark_as_returned=FALSE&note_to_append=Here+is+where+I%27m+putting+my+notes& effective_date_option=conversion_date&custom_date=1/1/2006

Sample XML Response:

<update_conversion_price_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>true</success>
<message>Conversion Updated</message>
</update_conversion_price_response>

Example Error Messages:

Error Message	Likely Cause
Invalid API Key	API Key does not exist or is expired