Time to read: 7 min.

The article covers the following topics:

Cap settings

Cap is an indicator that characterizes the limit of impressions, clicks, conversions, or budget (payouts). It is located in Offers -> a certain offer -> Caps tab.

cap_rule.png

It has several parameters:

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

  • hour - it correlates with the impression/click/conversion creation time. It's calculated for an hour according to the timezone you've set up for caps. Its reset happens at 00:00, 01:00, 02:00, etc. If you set up cap rule at 15:45, it will be turned back to zero at 16:00, however the cap counts all clicks/conversions come from 15:00 till 16:00 (for the whole hour). If you don't have the timezone for caps, then the general timezone set up in Settings is used.

⚠️ The Hour cap feature is available only for certain plans. Contact your Affise account manager to get the feature.

  • day - it correlates with the impression/click/conversion creation date. It’s calculated for 24 hours according to timezone you've set up for caps, and its reset occurs at midnight. If you don't have the timezone for caps, then the general timezone set up in Settings is used.

  • 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.

❗ Click and Impression Cap for Timeframe=All cannot be set up.

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

  • impressions - the number of impressions limits the cap.

  • clicks - the number of clicks limits the cap.

  • 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.

3. Value is the actual limit’s measure.

4. Sub account is a parameter used to limit the number of clicks or conversions according to a certain indicated sub2 value. There are two options:

  • Disabled - the parameter isn't used.

  • Sub2 - indicate certain sub2 values, which the cap rule should work with.

    ⚠️ The Sub account cap feature is available only for certain plans. Contact your Affise account manager to get the feature.

Delimit values by a comma without spaces. The following symbols of sub2 values are accepted: (a-z A-Z), numbers (0-9), and these symbols: -,._{}+=/:~. If you indicate several values, cap is reached once there are enough clicks/conversions for each value. You can't save the offer if you select the 'sub2' option, but haven't indicated any values.

5. 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.

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.

6. 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).

7. 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 pid id.

Below, you can find additional fields.

  • Overcap allows managing traffic flow when the cap is reached.

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

    Read more about these two features here.

  • Hide caps in partner interface allows you to hide cap rules in his partner panel.

  • Timezone is a time zone the cap is selected for. Select the time zone of conversions/clicks calculating.

  • Conversion status for caps count allows you to set up conversions' statuses for caps. It works for all cap periods and types (conversions or payouts).

    The option also presents in Settings - Tracking and Trafficback:

❗ Settings set up in the offer have priority over the settings in the section Settings - Tracking and Trafficback.

Caps on Admin panel

Caps on the Dashboard

In the Top Caps section on the Dashboard, there'll be depicted offers where the cap of any of types (clicks, conversions, payouts) is set up for Sub Account=Disable, Goal=All, Countries=All and Affiliate=All only. Only active offers are taken into account.

Caps in the offer list (Offers section)

Offers _ Rocketcompany - Google Chrome 2022-04-25 at 5.50.45 PM

Where:

  • Cap - indicates if an offer has a conversion limit (Yes/No).

  • Daily limit - the first daily cap of the offer that has Timeframe=Day, Goal=All, Countries=All, Affiliate=All (dash '-' or '0' value indicates that there is no such a cap rule). The progress bar is updated in real time.

  • Total limit - the first total cap of the offer that has Timeframe=All, Goal=All, Countries=All, Affiliate=All (dash '-' or '0' value indicates that there is no such a cap rule). The progress bar is updated in real time.

Caps on the offer preview page

The offer preview page shows absolutely all cap rules existent in the offer.

preview.png

If a cap rule is applied to each affiliate or contains several affiliates like here:

twopubs.png

Then there are two possible ways of its depiction as a cap bar:

1) if only one affiliate sends traffic -> only his results (amount of conversions / payouts / clicks) will be depicted.

2) if several affiliates send traffic -> the average value for all affiliates sending traffic is depicted.

The average value is depicted both as an average percent and an average amount of clicks/conversions/payouts. It is calculated the following way: Value in the Progress bar = All clicks or conversions or payouts / Number of affiliates. E.g. there is a cap for 70 clicks. The affiliate #1 sent 12 clicks (17%), and the affiliate #2 sent 16 clicks (23%), in the progress bar you see the average amount of clicks - 14, and the average percent - 20% :

Offer Trafficback_main_TEST DO NOT TOUCH_ _ Rocketcompany - Google Chrome 2021-12-07 at 12.06.14 PM

Caps on Affiliate panel

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

Offer Shortpedia Test - Google Chrome 2022-05-20 at 4.18.59 PM

❗On the Affiliates panel, you can see all caps that you set on the 'offer edit' page, even if you set up the caps differing only by countries.

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.

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

The progress bars are shown differently in different cases according to the table:

Affiliates: All

Affiliates: Each

Affiliates: Select

Goal: All

No progress bars

No progress bars

One separate progress bar for each selected affiliate for all goals.

Goal: Each

No progress bars

Separate progress bars for each goal. With goal title (if any)

Separate progress bars for each goal. With goal title (if any)

Goal: Select

No progress bars

Separate progress bars for each goal. With goal title (if any)

Separate progress bars for each goal. With goal title (if any)

For example, if there’s a cap with Goal=All and two selected affiliates - one progress bar for all goals will be shown for each of them.


❗Keep in mind that in progress bars on the Affiliate panel, the affiliate can see only his own conversions (not conversions of all affiliates).

You can hide cap rules in the partner panel. See the section Cap settings.

FAQ

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

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 advertiser 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, go to conversions list and check the click's and conversion's date in the correspondent columns.

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

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.

Caps' types of Conversions and Payouts have the same priority.

❗ Cap saturation takes into account all periods of caps (hour, 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.

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

Please, check if the box 'Hide caps' is ticked on the platform level in the section Settings -> Affiliates -> General or on the offer level. See the 'Hide caps in partner interface' checkbox.

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

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

twpubs2.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.

5) How are caps counted if I choose several countries/affiliates?

Once you choose several countries or affiliates (Country=Each/Select; Affiliate=Each/Select), the limit is applied to each country/affiliate separately, e.g. if you set a cap rule for 1000 clicks and choose two countries USA and Canada, your Affiliate has an opportunity to send 1000 clicks from the USA and 1000 clicks from Canada. If you choose two different affiliates, each of them can send 1000 clicks.

6) How are caps regulated via API?

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

The following articles can be helpful:


If you have any further questions, feel free to contact [email protected].

Did this answer your question?