NOTE: This service requires one of these three fields(conversion_id, request_session_id, or transaction_id) to find the specific Conversion/Event that you want to update.
WSDL Page: http://<your_domain_here>/api/2/track.asmx?op=UpdateConversion
Parameter Summary:
api_key / STRING = Admin API Key
offer_id / INT = Offer ID
conversion_id / INT = Conversion ID {See reports.asmx > Conversions}
request_id / INT = Click Request Session ID {See reports.asmx > Conversions}
transaction_id / STRING = Conversion Transaction ID {See reports.asmx > Conversions} [ To ignore this string field, you can leave it blank, otherwise we will attempt to match a conversion with a Transaction ID of "0"]
payout /DECIMAL= Payout amount
add_to_existing_payout /BOOL = Add the payout amount to the conversion? ["TRUE", "FALSE"]
received / DECIMAL = Received amount
received_option / ENUMERATION = How should the received field be handled with this request. [""total_sale_amount", "additional_sale_amount", "total_revenue", "additional_revenue", "no_change"]
disposition_type / ENUMERATION = Disposition Type to assign to the conversion ["no_change","pending","rejected","approved","returned"]
disposition_id / INT = Dispostion ID to add additional color to the Disposition Type assigned. {See track.asmx > ConversionDispositions}
update_revshare_payout / BOOL = When the conversion is tied to a revshare campaign, do you want the received amount to update the payout amount? ["TRUE", "FALSE"]
effective_date_option /STRING =The effective date these changes should be applied to ["today", "conversion_date", "custom"]
custom_date / DATETIME = This date field is only used on effective_date_option = custom, otherwise this date is ignored.[MM/DD/YYYY HH:MM:SS]
note_to_append / STRING = Freeform Notes
Parameter Types:
api_key - ID
offer_id - ID
conversion_id - ID
request_session_id - ID
transaction_id - ID
payout -ASSIGNABLE
add_to_existing_payout - ASSIGNABLE
received - ASSIGNABLE
received_option - ASSIGNABLE
disposition_type - ASSIGNABLE
disposition_id - ASSIGNABLE
update_revshare_payout - ASSIGNABLE
effective_date_option- ASSIGNABLE
custom_date - ASSIGNABLE
note_to_append - ASSIGNABLE
Sample GET Call:
https://demo.cakemarketing.com/api/2/track.asmx/UpdateConversion?api_key=dNJFmId9rI&offer_id=55378197&conversion_id=707658&request_session_id=0&transaction_id=&payout=20&add_to_existing_payout=false&received=30&received_option=total_revenue&disposition_type=no_change&disposition_id=0&update_revshare_payout=true&effective_date_option=today&custom_date=1%2F1%2F2001¬e_to_append=example
Sample XML Response:
<update_conversion_response>
<success>true</success>
<message>Conversion Updated</message>
</update_conversion_response>