Download the pixel


The function "Request Queue" is available as of Webtrekk pixel version 5.0.9 and 4.4.5 and deactivated by default.



The "Request Queue" feature ensures the sequence of the tracking requests in every situation. This gives you the following advantages:

  • Offline tracking
    If this function is activated, all requests are processed 100% in the order in which they were sent. This means that no requests can be lost, even if users go offline (offline tracking). This also applies to the Progressive Web App (PWA) or Single Page Application (SPA).


  • Page unload

    If you have implemented several tracking functions on a single page, for example, form tracking, heatmap tracking, and link tracking, the request queue ensures that all requests created here are sent on the subsequent page when the user leaves the page. Formerly, the browser dropped these requests.


  • Server-side tracking
    Another advantage is the sequential processing of requests from unknown users when you set cookies on the server side. With the new ITP2.1 update, Safari browsers from version 12.1 will not store cookies for longer than seven days. After this period, a returning visitor receives a new EID and is counted as a new visitor. You can avoid this by using server-side cookies. With the Request Queue functionality, Webtrekk can guarantee an unambiguous assignment of the visitor IDs so that the use of server-side cookies does not lead to an unexpected increase in new/ unknown visitors. The request queue ensures that requests are not sent simultaneously and that too many EIDs are generated for a new/ unknown visitor.


You can find more information on ITP 2.1 in the  Best Practice: Intelligent Tracking Prevention (ITP) 2.1.


Implementation Options


Follow the steps below:

  1. To activate the function "Request Queue" and to configure it, open the Webtrekk Plugin and open the tab "Request Queue."




  2. Make the following settings:

    ParameterDescription
    Activate request queueActivate the checkbox if you want to control the order of browser requests to the track server (recommended for server-side cookie settings).
    Request interval (sec.)Enter the interval (in seconds) after which a failed request should be sent again.
    Max. time in the queue (sec.)Enter the maximum time (in seconds) that a request should remain in the queue.
    Max. number of requestsSpecify the maximum number of requests that can be in the queue.


You can activate the function "Request Queue" via the variable "requestQueueActivated".

Example global configuration

var webtrekkConfig = {
    trackId: "111111111111111",
    trackDomain: "track.webtrekk.net",
    domain: "www.website.com",
    requestQueueActivated: true,
    requestQueueTTL: 5 * 60 * 1000,
    requestQueueResendInterval: 5 * 1000,
    requestQueueSize: 100
};


Example page-specific configuration

var pageConfig = {
    requestQueueActivated: true,
    requestQueueTTL: 5 * 60 * 1000,
    requestQueueResendInterval: 5 * 1000,
    requestQueueSize: 100
};

var wt = new webtrekkV3(pageConfig);
wt.contentId = "de.startseite";
wt.sendinfo();
ParameterDescription
requestQueueActivatedtrue = The "Request Queue" function is activated.
requestQueueTTLEnter the maximum time (in milliseconds) that a request should remain in the queue.
requestQueueResendIntervalEnter the interval (in milliseconds) after which an incorrect request is to be sent again.
requestQueueSizeSpecify the maximum number of requests that can be in the queue.