eventsPerRequest

The eventsPerRequest property sets the maximum number of queued events the SDK puts into one HTTP request when it uploads from local storage. A single request never carries more than that many events; if the queue is longer, the SDK sends extra requests until it is done. How often uploads run is controlled by dispatchInterval.

Syntax

PiwikTracker.sharedInstance()?.eventsPerRequest = events

[PiwikTracker sharedInstance].eventsPerRequest = events;

Parameters

• eventsPerRequest integer, required. Maximum number of events per one HTTP request when the queue is uploaded. Default: 20.

Examples

To send at most 50 events per request:

PiwikTracker.sharedInstance()?.eventsPerRequest = 50

[PiwikTracker sharedInstance].eventsPerRequest = 50;

Notes

• Whether one upload uses GET or POST depends on how many events are in that upload; see dispatch().
• A higher eventsPerRequest usually means fewer separate uploads, but each upload can carry more data.

Related methods

• dispatch()
• dispatchInterval
• maxNumberOfQueuedEvents