Undersold ping post – PX Knowledge Base

Undersold Ping Post allows PX Owner to participate in the real-time exchange of shared leads with publishers.

How to Enable Undersold Ping Post for a Publisher

To start using undersold ping post between PX and publisher, the following should be done:

Set Undersold Forwarding or Undersold Prediction type in Publisher Settings.
The publisher must insert leads including an additional Distribution Directives block.

Distribution Directives

Distribution Directives block contains the following data:

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;
Num Slots parameter shows how many times this lead can be sold;
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

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.

Distribution Directives block with num slots specified, as well as ZIP code and IP Address are mandatory in a publisher ping request.

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.