How it works
- Ping phase: Your source sends partial lead data (typically just enough to identify the lead type and location). Juiced auctions this data to your customers, collecting bids in real time.
- Post phase: Once a winning bid is determined, your source sends the complete lead data. The lead is assigned to the winning customer, funds are transferred, and everyone’s happy.
Partner integrations
Partners are external systems that receive your leads. When you configure a partner integration, you set up both ping and post configurations to match their API requirements.Request mapping
Each partner has their own field names and payload structure. Request mapping lets you transform Juiced’s lead data into whatever format your partner expects. Use merge fields in double curly braces to insert lead data:Using ping response data in posts
Some partners return data in their ping response that must be included in the subsequent post request—things like session IDs, tracking tokens, or campaign identifiers. When configuring a post request mapping, you can reference fields from the ping response using theresponse. namespace:
Ping response fields are only available when configuring post requests. They won’t appear in ping request mappings since no response exists yet at that point.
Offer penalty percentage
Sometimes you want to give certain partners a competitive disadvantage without changing what they actually pay. The offer penalty percentage does exactly this—it reduces a partner’s offer score without affecting the charged amount. For example, if a partner submits a $100 offer and has a 25% penalty:- Their offer score becomes $75 (used for ranking)
- Their charged amount stays $100 (what they actually pay if they win)
- A partner has lower lead quality or conversion rates
- You want to favor other partners without explicitly blocking anyone
- You’re managing partner relationships while maintaining pricing transparency
The penalty percentage is snapshotted on each offer, so changing a partner’s penalty only affects future offers—not ones already in the system.
Offer scoring
When multiple partners respond to a ping, their offers are ranked by score. The highest score wins. By default, the score equals the offer amount, but penalties can reduce this:| Partner | Offer Amount | Penalty | Offer Score | Winner? |
|---|---|---|---|---|
| Partner A | $100 | 0% | $100 | Yes |
| Partner B | $110 | 25% | $82.50 | No |
| Partner C | $90 | 0% | $90 | No |

