Boxes combine the functionality of traffic distribution scripts, caps, rotators (including the "Bucket" algorithm), and can set a timetable, сommission payments model, and payments. Working with boxes is carried out in the «Boxes» subsection «Control» section and is available to administrators.
Important! Boxes are not a complete analogue of traffic distribution scripts and represent simplified visual distribution settings.
Adding and configuring boxes
Go to the «Boxes» subsection of the «Control» section. Specify a convenient name for you, select the default company and click the «Add» button.
You will be redirected to the box settings page, where you can edit the name and default company (you don’t need to save the changes, they are applied automatically), add cases, and link the box to offers.
Setting up cases
Case — traffic distribution option. The list of cases corresponds to the script lines in the "Bucket" algorithm.
To add a case, click «Add new case» and fill out the form:
- Company. Company where the leads should be sent.
- Priority. Allows you to sort cases by several priority levels. Each priority block is processed separately (from top to bottom).
- Probability. The percentage of probability of a case triggering within the priority level. If the value is not specified, the distribution is uniform.
- Country. List of countries the case works with. If not specified, work is carried out with all countries.
- Source. Traffic source.
- Cap. Lead counting period. When the cap is disabled, the number of leads is unlimited.
- Status. Leads in what status will be taken into account when calculating the cap filling.
- Limit. Determines the volume of the cap that can be filled. After this amount, the cap will be considered full and the case will become unavailable.
- Time shift. Allows you to manually shift the time for which leads are counted. Measured in hours, can be both positive and negative.
- Weekdays. Days of the week the case operates.
- Timetable. Case work schedule.
- Timezone. Time zone of the schedule.
- Filter. Allows you to set filters. By default, there are no filters.
- Field. List of fields by which you can set up filtering.
- Value. The value of the filter field. Depending on the type of filtering and the task, it can be an identifier, a list of identifiers, a regular expression, or an arbitrary set of characters.
- Commission payments model. The model by which leads will be evaluated. Takes precedence over the model at the offer level. Our vision of work models described in the manual.
- Pay to affiliate. The amount of the deduction for the webmaster (we pay) and its currency.
- Pay from advertiser. The amount of the deduction for the advertiser (we get paid) and its currency.
Binding a box to an offer
In order for traffic to go to the box, it must be linked to an offer. This can be done in the box settings via the offer lists at the bottom of the page. The box can also be selected as a default company in the offer settings, or connected as part of the distribution script.
Examples of using a box as part of a distribution script:
reason:7 box(123)
Features of lead counting
Boxes (and cases in particular) only count leads that have passed through them automatically, or that have been forwarded directly to the box or a specific case. If you manually resend directly to the box company, the case will not count the lead.