Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

There are multiple parameters that can be used to control the number of times the waterfall will run. All are explained in Player Implementation Guide

Player Configuration

The below parameters can be configured in the player adConfig

  • vastRetry: vastRetry is the number of immediate retry of the calls to the waterfall. If vastRetry = 1, the waterfall will be called one time once and after finishing calling all ad sources it will immediately retry again.

  • errorLimit: The erroLimit parameter is used in order to limit the number of waterfall runs that do not generate an impression in a player session.
    Definition: the total number of subsequent retry runs of (vastRetry + 1) runs of the waterfall without impression.
    For example, if vastRetry=2 and errorLimit=3, this will be the flow:

    • (1+2) runs

    • (1+2) runs

    • (1+2) runs

    • (1+2) runs

    • If there is no impression in any of the runs, the player will stop. If there is an impression, the errorLimit counter will reset to 0

  • maxImp: Maximum number of impressions in the session. When this number is reached, the player will stop after the impression.

  • maxRun: Total number of waterfall runs - no meter if its generating an impression or not

  • midrollfunc: Midroll function can be used in order to fully control the number and frequency of waterfall runs. This function will be called every time the waterfall runs and will wait for the callback to be called. This way its possible to fully control the timing of the waterfall runs.

...