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