Retention options allow you to define rules for automatically holding back certain events received from an Advertiser before they are processed and attributed to Affiliates. This is useful for filtering out suspicious conversions, enforcing quality thresholds, or managing events that arrive outside expected parameters.
The values configured here act as defaults for all new Offers created under this Advertiser. When a new Offer is created, these values are automatically copied to the Offer's own Retention options — unless the Offer is created from a template that already has Retention options configured, in which case the template values take precedence.
From that point, the Offer's retention configuration is completely independent — changes made here will not affect existing Offers. However, if you edit an existing Offer and click the restore from Advertiser icon next to the Retention options fields, the Offer will re-inherit the values currently configured here, overwriting its own settings.
See Offer – Retention options for details on how to manage retention at the Offer level.
How to access it
Go to Advertisers, open the Advertiser's profile, and navigate to General > Main setup > Retention options.
Configuration options
Retention Percentage (optional) — the percentage of incoming events that will be automatically retained. For example, a value of 25 means that 25 out of every 100 events received from the Advertiser are held back and not processed.
Max Payout Value (optional) — the maximum Advertiser payout value accepted per conversion. Events where the Advertiser sends a payout above this threshold are retained. Useful for catching unusually high payout values that may indicate errors or fraud.
Min TTC (optional) — the minimum Time To Convert, in seconds. Events that arrive before this time has elapsed since the original click are retained. For example, a value of 120 means conversions that happen in under 2 minutes after the click are held back.
Max TTC (optional) — the maximum Time To Convert, in seconds. Events that arrive after this time has elapsed since the original click are retained.
When cap is reached conversions — defines what happens to conversions that arrive after a CAP has been reached. Default: Are retained.
Retention policy (optional) — defines what happens to retained events:
Not set — retained events stay retained indefinitely. No automatic action is taken.
Period — retained events are automatically approved after a defined time window. Use this as a quarantine period when you want to review events before they are processed.
💡 Tip: Min and Max TTC are particularly useful for mobile campaigns where very fast or very delayed conversions may indicate bot traffic or attribution issues.
⚠️ Important: Retained events are not processed or attributed to Affiliates until they are manually approved or automatically released by the Retention policy. They remain visible in the Advertiser Events report.