Undersold ping post

Distribution Directives block contains the following data:

1. Allow Undersold parameter - if set to true and there are still free num slots available after the general selling process, the lead will be routed to undersold campaigns;
2. Num Slots parameter shows how many times this lead can be sold;
3. Hashed Leg Name or Leg Name parameter that indicates, to which legs this lead has already been sold. Campaigns from this leg are excluded from the list of potential campaigns and do not take part in the bidding process.

Code Example

<DistributionDirectives AllowUndersold="true">
   <NumSlots>3</NumSlots>
   <Directive Action="Exclude"><Name>Guardian Protection Services</Name></Directive>
   <Directive Action="Exclude"><HashName>e4d909c290d0fb1ca068ffaddf22cbd0</HashName> </Directive>
</DistributionDirectives>

Parameters:

• Allow Undersold=true/false - optional;
• Num Slots - mandatory;
• Excluding Legs by Leg Name of Hashed Leg Name - optional.

Undersold ping post flow includes the following steps:

1. PX receives the ping request from the publisher with the lead that includes all vertical specific information without contact data.

2. PX determines the list of potential shared campaigns for this lead, excluding campaigns from legs specified in the ping request (if there were any).

3. In undersold prediction flow, PX analyzes direct bids and payout rules of direct post campaigns.

4. In undersold ping forwarding flow, PX forwards ping request to potential campaigns and analyzes direct bids and bids of ping post campaigns based on real-time responses.

5. PX Bid is calculated.

6. PX sends ping response to the publisher including PX bid and Transaction ID.

7. If PX wins the lead, the publisher sends the post request with the full lead info, including contact data and Transaction ID from the ping response.

8. PX tries to sell the lead to shared campaigns.

9. If the lead is sold to campaign(s), PX sends post response to the publisher with the payout, which is usually equal to PX bid sent in ping response.

10. If the lead is sold but there are still num slots available, and undersolds are allowed, the lead is routed to undersold campaigns.

11. If the lead is not sold, the corresponding error is sent to the publisher (e.g. Unable to monetize).

Follow this article for more details about Shared Bid calculation.