При помощи JavaScript API вы можете обращаться к данным Alfa-track на клиентской части, управлять функциями емеилтрекинга и передавать собственные параметры.

API по умолчанию включен, поэтому достаточно ознакомиться с его возможностями ниже.

Метод setCustomId

                                        (function () {
    var stop = setTimeout(function () {
        clearInterval(timerId);
    }, 30000); // время максимального ожидания счетчика alfa-track
    var timerId = setInterval(function() {
        if (window.alfatrack && window.alfatrack.api) {
            clearTimeout(stop);
            clearInterval(timerId);
            window.alfatrack.api.setCustomId('custom_id'); // custom_id - значение вашего параметра
        }
    }, 500);
})()

Функция позволяет передавать значение пользовательского параметра в качестве идентификатора посетителя сайта. Каждый новый вызов функции перезаписывает предыдущее значение параметра.

Если вы убедились, что счетчик alfa-track загружен, функцию также можно вызывать следующим образом:

window.alfatrack.api.setCustomId('custom_id');

Метод replaceMailboxes

window.alfatrack.eventDispatcher.dispatchEvent(window.alfatrack.CONST.EVENTS.REPLACED_MAILBOXES);

Функция позволяет выполнить подмену емеил-адресов. Используется чаще всего для SPA приложений при смене адреса страницы. Если возникают сложности при добавлении кода в "нужные места", можно воспользоваться следующим вариантом:

document.body.addEventListener('update page', () => {
        setTimeout(() => {
            if (url !== window.location.href) {
                window.alfatrack.eventDispatcher.dispatchEvent(window.alfatrack.CONST.EVENTS.REPLACED_MAILBOXES);
                // console.log('url changed');
            }
            url = window.location.href;
        });
    }, 1000);

Лимиты и ограничения

API работает в рамках одного Alfa-Track проекта.
Ограничено количество вызовов в секунду, не более одного вызова в секунду.