Winning & Losing

A Running Campaign will participate in auctions for incoming Data Instances that match the Campaign query criteria.

Winning

A Data Instance will be won, and the On Win Notification(s) triggered if:

• The Campaign is Running
• The Bid Preferences allow for bidding at the time specified
• The Bid Preferences limits have not been reached
• The bid is the highest bid, or if equal to another bid from a different Buyer was created earlier
• The associated Account has sufficient funds to cover the bid amount

The other participants in the auction will lose, and their respective On Lose Notification(s) triggered.

note

The price paid and the bid amount can vary. Bids from the same Buyer are de-duplicated according the the Data Auction Duplicate / Multiple bid settings. The price will be calculated according to the Data Auction pricing model.

Accessing Won Data Instances

As winner of a Data Instance:

• You can access all public and private properties of the Data Instance via the get Data Instance API
• The Data Instance will be shown as won in the list Data Instances API
• The price will be debited from the Account, and is shown in the list Transactions API.

Losing

If you participate in an auction, but lose, the On Lose Notification(s) will be triggered.

There are a number of reasons you could lose an auction:

Insufficient bid

• The bid amount was below the starting price for the Data Instance
• The bid amount was below that of another Buyer

Insufficient balance

• The associated Account does not have enough balance to cover the bid. Note, if the balance is below the bid amount, the bid could have been adjusted according to the Data Auction settings.

Accessing Lost Data Instances

As loser of a Data Instance:

• You can access all public properties of the Data Instance via the get Data Instance API
• The Data Instance will be shown as lost in the list Data Instances API