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: