WSDL Page:  http://yourdomainhere.com/advertisers/api/1/track.asmx/op=UpdateConversion

HTTP GET (plus Parameters):

GET /advertisers/api/1/track.asmx/UpdateConversion?
api_key=string
advertiser_id=int
request_id=int
offer_id=int
step=int
amount=decimal
add_to_existing=bool
mark_as_returned=bool
transaction_id=string

 

Parameter Summary: ALL parameters required except for transaction_id

api_key=Admin API Key
advertiser_id=Advertiser ID
request_id=Request Session ID (use #reqid# token on the Offer Link to pass this value to the LP)
offer_id=Cake Offer ID
step=Step Number (if step pixels are not being used, step=0)
amount=Decimal (cannot be negative unless "add_to_existing" is false)
add_to_existing=Bool (true/false)
mark_as_returned=Bool (true/false)
transaction_id=String (field must be defined on the API call, but may be left empty)

Sample HTTP GET Call:

Appending Revenue to an existing Conversion

advertisers/api/1/track.asmx/UpdateConversion?api_key=sa78SDGsd7&advertiser_id=1&request_id=23403&offer_id=243&step=2&add_to_existing=true&amount=25&mark_as_returned=false&transaction_id=step+two+bonus


Appending Notes to an existing Conversion

aadvertisers/api/1/track.asmx/UpdateConversion?api_key=sa78SDGsd7&advertiser_id=1&request_id=23403&offer_id=243&step=5&add_to_existing=true&amount=0&mark_as _returned=false&transaction_id=adding+notes+no+new+revenue


Rewriting Revenue to an existing Conversion

aadvertisers/api/1/track.asmx/UpdateConversion?api_key=sa78SDGsd7&advertiser_id=1&request_id=23403&offer_id=243&step=0&add_to_existing=false&amount=1000&mark _as_returned=false&transaction_id=changing+original+price+without+adding+to+existing


Marking a Conversion as Returned

advertisers/api/1/track.asmx/UpdateConversion?api_key=sa78SDGsd7&advertiser_id=1&request_id=23403&offer_id=243&step=4&add_to_existing=false&amount=0&mark_as _returned=true&transaction_id=conversion+returned


Sample XML Response:

Success:
<update_conversion_response xlmns:xsi="http://www.w3.org/2001/XMLWSchema_instance"
xlmns:xsd="http:/www.w3.org/2001/XMLSchema"
xmlns="http://cakemarketing.com/advertisers/api/1/">
<success>true</success>
<message>Conversion Updated</message>
</update_conversion_response>

Error:
<update_converson_response xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="http://cakemarketing.com/advertisers/api/1/">
<success>false</success>
<message>Conversion Not Found</message>
</update_conversion_response>



Linkback to API Version Tracker:

https://support.getcake.com/support/solutions/articles/5000540244-start-here-admin-api-version-tracker