Динамический бейдж

Обновлено 14 августа 2026

Данный документ описывает требования к интеграции динамического бейджа в мобильное или веб-приложение Партнера.

Ключевые принципы:

1. Самостоятельная реализация: Визуальная часть и логика отображения динамического бейджа реализуются Партнером собственными силами на основании дизайн-гайда .
2. Использование SDK: SDK используется исключительно для:
   • Настройки бесшовного перехода.
   • Передачи событий (метрик) об отображении и взаимодействии с бейджем.

---

1. Подключение бесшовного перехода

Для обеспечения плавного пользовательского опыта необходимо настроить бесшовный переход из приложения или сайта Партнера на веб-интерфейс без повторной авторизации.

Предварительные требования

Перед началом подключения к SSO ознакомьтесь с общими требованиями:

🔗 Общие требования

Инструкции по платформам

Платформа	Ссылка на документацию
Android	Настройка перехода на веб-интерфейс Партнера
iOS	Настройка перехода на веб-интерфейс Партнера
Web	Web SSO

2. Отправка метрик в SDK

Партнеру необходимо уведомлять SDK о событиях, происходящих с динамическим бейджем, для дальнейшей транспортировки данных в Clickstream.

2.1. Мобильные приложения (Android / iOS)

2.1.1. Метод отправки событий

SID.Events.sendElkEvent(
    eventType: EventType,
    widgetType: String?,
    widgetName: String?,
    status: String?,
    avatar: String?
)

SID.Events.sendElkEvent(
    eventType: EventType,
    widgetType: String?,
    widgetName: String?,
    status: String?,
    avatar: String?
)

• Максимальный размер любой строки — 128 символов.
• Метод вызывается столько раз, сколько событий произошло.

2.1.2. Параметры для бейджа

Параметр	Значение	Когда передавать
eventType	SHOW, CLICK, ERROR	Всегда
widgetType	BADGE — карточка бейджа	Всегда
widgetName	"Прайм", "Спасибо" null — при ошибке отображения обоих бейджей	Всегда
status	"Активна", "Подключить" null — при ERROR	При SHOW / CLICK
avatar	null	Всегда (для бейджа не используется)

Примечание:

• Если ошибка произошла только в одном бейдже — в widgetName передаем его название ("Прайм" или "Спасибо").
• Если ошибка произошла сразу в обоих бейджах — в widgetName передаем null.

2.1.3. Примеры вызовов

// Показ бейджа Прайм (статус: Активна)
SID.Events.sendElkEvent(SHOW, "BADGE", "Прайм", "Активна", null)

// Показ бейджа Спасибо (статус: Подключить)
SID.Events.sendElkEvent(SHOW, "BADGE", "Спасибо", "Подключить", null)

// Клик на бейдж Прайм
SID.Events.sendElkEvent(CLICK, "BADGE", "Прайм", "Активна", null)

// Ошибка отображения обоих бейджей
SID.Events.sendElkEvent(ERROR, "BADGE", null, null, null)

// Показ бейджа Прайм (статус: Активна)
SID.Events.sendElkEvent(eventType: .show, widgetType: "BADGE", widgetName: "Прайм", status: "Активна", avatar: nil)

// Показ бейджа Спасибо (статус: Подключить)
SID.Events.sendElkEvent(eventType: .show, widgetType: "BADGE", widgetName: "Спасибо", status: "Подключить", avatar: nil)

// Клик на бейдж Прайм
SID.Events.sendElkEvent(eventType: .click, widgetType: "BADGE", widgetName: "Прайм", status: "Активна", avatar: nil)

// Ошибка отображения бейджа
SID.Events.sendElkEvent(eventType: .error, widgetType: "BADGE", widgetName: nil, status: nil, avatar: nil)

Важно

Событие SHOW отправляется каждый раз, когда в цикле анимации показывается новый бейдж (например, 3 поворота карусели = 3 вызова SHOW).

2.2 Web / mWeb

(Раздел в разработке, инструкции по отправке метрик для веб-платформ будут добавлены позже)