Offer Settings: Cap Management

Time to read: 9 min.

topic.pngThis article covers the following topics:

Cap general settings

Cap is an indicator that characterizes the conversions’ limit.

It has several parameters:

Timeframe is a time cap’s parameter. It indicates a period of time the cap option is enabled. It may be:

  • daily - it correlates with the conversion creation date. It’s calculated for 24 hours according to your settings’ time zone, and its reset occurs at midnight. It’s also possible to set up the time zone due to the offer’s requirements;  
  • month - it’s calculated for a calendar month. Even if the cap is set up on 15.11, the calculation will be made from 01.11 till 30.11, and it’ll be reset again on 01.12;
  • all - total cap, it’s calculated for the entire time, when the offer receives the traffic.

2. Type is a parameter that denotes the value the cap is limited by. It may be:

  • conversions - the number of conversions limits the cap;
  • payouts- the cap is limited by the sum of conversions’ payouts. It means if there’s a currency of EUR in the payout offer settings, the cap calculation is carried out in EUR.
  • click - the number of clicks limits the cap;

3. Value is the actual limit’s measure.

4. Goal is a parameter, that is used for determining when the cap’s limit is reached. It may be:

  • all - totally for all goals;
  • each - for each offer’s goal;
  • select  - for a specific chosen goal value.

Markup 2020-06-18 at 13.38.27.png

If there is Goal value only, it will be depicted in the dropdown list. If there are both Goal value and Goal title, only Goal title will be depicted. If there is a personal payout where the specific goal is set up, it will be depicted where the specific Affiliate is chosen.

5. Country is a country the cap is chosen for. It works for each type of cap. It may be:

  • all - totally for all countries in the world
  • each - for each country
  • select - certain country (might be several ones)

import.png If several countries are chosen, the limit is spread across all listed countries. 

6. Affiliate is an affiliate the cap is chosen for. It may be:

  • all - totally for all affiliates who have access to the offer;
  • each - for each affiliate enabled to the offer:

a) if an offer’s privacy level is “public” - for each affiliate that has “Active” status;
b) if an affiliate isn’t disabled from the offer or the advertiser.

  • select - for a specifically chosen affiliate by pib id.

Markup 2020-06-18 at 13.40.06.png

Cap additional settings

Overcap allows managing traffic flow when the cap is reached.

Markup 2020-05-20 at 10.18.32.png

If the cap is reached - the incoming traffic will be redirected to the local Trafficback URL (at the offer’s level). If there’s no local Trafficback URL, but there’s  Preview URL and/or Global Trafficback URL, and besides the box 'Use by other reasons' is ticked -  the incoming traffic will be redirected to the Global Trafficback URL.

Markup 2020-06-18 at 13.49.48.png

If the box 'Use by other reasons' isn’t ticked - the incoming traffic will be redirected to the Preview URL of the offer. We recommend you to read our guide on Trafficback feature.

Overcap works based on the principle of traffic redirection to the Trafficback URL only if the chosen goal is 'all' (Goal=All). The case, when the goal equals Goal=Each/Select, and Overcap is ticked, is described below.

Markup 2020-05-20 at 10.33.46.png

import.png When Overcap is ticked with the chosen Goal=Each/Select, clicks won’t be redirected to the Trafficback URL when the cap is reached. The offer will still accept the incoming traffic, but the conversions on the clicks, accepted over the limit, will be automatically declined with the comment [Cap is reached]. The reason is that the Goal value can’t be determined at the incoming click level. The goal could be determined only at the advertiser’s postback level and recorded for conversion in Affise.

To enable Overcap via API is possible using these methods POST /3.0/admin/offer/ and POST /3.0/admin/offer/{ID} сorrespondingly:

Markup 2020-05-20 at 10.52.47.png

Default goal Overcap

Default goal Overcap allows managing traffic flow when the desired goal is reached. 

Markup 2020-05-20 at 11.00.53.png

Markup 2020-05-20 at 11.54.58.png
If the cap for the chosen goal is reached, it allows us to block the traffic or send it to the Trafficback immediately without waiting for other caps to be reached, even if there're other Cap rules for Goal=Select. The logic of sending to the Trafficback is the same as with Overcap function: the incoming traffic will be redirected to the local Trafficback URL (at the offer’s level). If there’s no local Trafficback URL, but there’s Preview URL and/or Global Trafficback URL, and besides the box “Use by other reasons” is ticked -  the incoming traffic will be redirected to the Global Trafficback URL.

If to check such a case with the tracking link the following response could be depicted:

import.png The goals in the dropdown menu are depicted according to goal values and goal titles set up in the general payments:


Thus if you see like in the screenshot above "1" and not the naming, it means there's no goal title in the payment:
import.png Default goal Overcap is relevant for both Conversions and Payouts type. 


Timezone is a time zone the cap is selected for. 

Markup 2020-05-20 at 12.26.14.png

To enable Timezone for caps via API is possible to use these methods POST /3.0/admin/offer/ and POST /3.0/admin/offer/{ID} сorrespondingly:

Markup 2020-05-20 at 12.29.09.png

Conversion status for caps count

Markup 2020-05-20 at 12.32.32.png

The option allows us to set up conversions' statuses for caps. It works for all cap periods and types (conversions or payouts). 

It's necessary to mention that the option also presents in Settings -> General -> Trafficback:

Markup 2020-06-18 at 13.53.03.png

Offer settings have a priority.

To enable Conversion status for caps count via API is possible using these methods POST /3.0/admin/offer/ and POST /3.0/admin/offer/{ID}, respectively:

import.png Settings set up in the offer have priority over the settings in the section Settings -> General ->Trafficback.

Caps Top section on Dashboard

In the section "Caps Top" on the Dashboard, there'll be depicted offers where the cap of any of types (clicks, conversions, payouts) is set up for Goal=All, Countries=All and Affiliate=All only.


Caps on Affiliate panel

 Affiliate sees the cap section on the offer view page on Affiliate panel like this:


If there’s a personal cap (Affiliate=Select), it’s shown as a progress bar in the affiliate’s panel. Other cap parameters (period, type, value, goals, countries) don't matter.

import.png The progress bar is shown even if there are no conversions yet. 

There's a box for hiding caps in the affiliate’s panel

Markup 2020-05-20 at 12.24.16.png

You also can tick this flag on a platform level here: Settins -> Affiliate dashboard design -> General. 



Q1) I have an overflow on the cap. Why?

A.: Please, mind the click’s time: conversions, recorded for clicks received before the time cap was reached, will be accepted as a server postback but declined as a conversion with the comment [Cap is reached]. The server postback from the advert will be accepted properly, with the status '1', but the conversion itself will be rejected, as the postback is accepted later than the cap was reached.
To figure out if the conversion is accepted within the necessary timeframe, please, mind the below date stands for the click date, and the above date stands for the conversion date.


Q2) I have an overflow on the cap. The traffic doesn’t go to Overcap immediately. Why?

A.: It’s normal for the Overcap system to be enabled within 3 minutes. It’s acceptable to receive clicks at the time of 3 minutes when the cap limit is reached, and Overcap is about to be enabled.

Q3) If I have several caps, how to define what Cap is reached earlier?

A.: The cap of the highest priority is the total cap,  i.e., the cap that has Affiliate=All and Goal=All set up like all. So, when the cap set up as Goal=All and Affiliate=All is reached, it automatically stops the other caps’ work. Further priorities are allocated according to the table, where 1 is the highest priority, and 9 is the lowest.



















import.png Caps' types of Conversions and Payouts have the same priority.
import.png Cap saturation takes into account all periods of caps (daily, month, all). As soon as the priority (see the table) is reached, we no longer consider the caps below the priority and determine it reached.

Q4) Why doesn’t my affiliate see the cap set up for him?

A.: Please, check if the box 'Hide caps' is ticked on the platform level in the section Settings - Affiliate dashboard design - General or on the offer level. See the section 'Caps on Affiliate panel'

Q5) If I have a cap rule for payouts (for instance, in USD) for several selected affiliates, how the payouts will be spread?

A.: If there is a cap rule for Goal=All and Affiliate=Select, where two or more affiliates are selected like here:

Markup 2020-05-20 at 12.51.19.png

Then payouts will be spread in the following way: each of the selected affiliates should have conversions for 100 USD. Cap will be reached when affiliate #1 will have conversions for 100 USD and when affiliate #2 will have conversions for 100 USD as well.

The same logic works for conversion type of cap.

Q6) How are caps regulated via API?

You can find the example of caps creation in our guide here.

article.pngThe following articles can be helpful:

Should you have any further questions, feel free to contact

Updated by Lizaveta Talkachova


Was this article helpful?
6 out of 7 found this helpful
Have more questions? Submit a request


Please sign in to leave a comment.