With offer pinning and sorting, you can now control the position for your top offers manually, while all remaining offers continue to rank dynamically by EPC.
This gives you the best of both worlds:
Manual control and sorting for priority offers
Automated EPC sorting for everything else
What is Pinning?
Pinning allows you to manually place an offer in a top position (1–5) within a placement, overriding the default EPC-based sorting.
When an offer is pinned:
It is locked into a top slot (1–5)
It will always appear above all unpinned offers in that placement
You can control its exact position relative to other pinned offers
How It Works
Offers are pinned and sorted within their assigned Placement.
⚠️ IMPORTANT: You must assign a placement to the offer to be able to control the ordering. For more information on placements, see here.
Managing Pinned Offers
For instructions on how to pin and sort offers, click here.
Example:
If a homepage placement has 10 offers and you want a specific offer to appear first:
Pin it by clicking the star icon and assigning it to the top slot.
Once pinned, that offer will always appear in position 1 within the homepage above the other 9 offers—regardless of its EPC ranking.
Key Behaviors
Pinned offers always appear first, in their assigned order.
Unpinned offers automatically sort by EPC.
Placement-specific pinning
An offer can be pinned in different positions across multiple placements, or not pinned at all in others.Each placement supports up to 5 pinned offers.
Reordering Pinned Offers
Pinned offers can be reordered via drag-and-drop within the pinned section
Only pinned offers can be manually reordered
Changes are applied instantly
EPC Behavior (Unchanged)
Pinning does not affect EPC settings and calculations. Unpinned offers continue to rank based on EPC descending.
In the placements table, you can see each offer's current EPC:
EPC Locked | EPC Value Shown |
Yes | Baseline EPC (fixed value) |
No | True EPC (dynamically calculated from revenue and click data) |
API Behavior
The placements array in each offer details includes a pinnedPosition field that determines its ranking within a placement.
| Meaning |
1–5 | Offer is pinned to that specific slot |
0 | Offer is not pinned |
Sorting Rules
Offers with
pinnedPosition1–5 are always shown first, in ascending slot orderOffers with
pinnedPosition = 0are treated as unpinned and are sorted by EPC (descending)If no offers are pinned, the full list is sorted purely by EPC
Best Practices and Recommendations
Use pinned slots for:
High-priority campaigns
Sponsored placements
New offers that need visibility
Let EPC handle:
Long-tail optimization
Performance-based ranking
Regularly review pinned placements to ensure they still align with performance goals