Продуктовые сценарии и офферные события

Модуль Product Flow

Для использования функциональности Product Flow подключите модуль io.appmetrica.analytics:analytics-product-flow. Версия модуля должна соответствовать версии библиотеки io.appmetrica.analytics:analytics.

В build.gradle.kts приложения добавьте следующую зависимость:

dependencies {
    implementation("io.appmetrica.analytics:analytics-product-flow:8.4.0")
}

Подробнее о подходе

Product Flow — это новая схема работы типовых событий AppMetrica для приложений с офферами, покупками, оформлением заявок и многошаговыми сценариями оформления продуктов и услуг.

Дополнительную информацию о модуле и полные пользовательские сценарии см. в разделе Архитектура офферных событий в продуктовых сценариях.

Product Flow помогает стандартизировать аналитику следующих сущностей и сценариев:

продуктовые предложения;
маркетинговые офферы;
покупки товаров и услуг;
пользовательские воронки;
шаги оформления;
заявки и результаты одобрения;
асинхронные S2S-результаты.

Рекомендуем использовать подход Product Flow для следующих типов приложений:

банки;
страховые сервисы;
телеком-приложения;
сервисы бронирования и путешествий;
подписочные сервисы;
сервисы доставки;
маркетплейсы;
игровые приложения;
любые приложения с продуктовыми сценариями, покупками и аналитикой воронок.

Не расходуют лимиты custom events и DSA

Новые типовые события не учитываются в следующих лимитах:

custom events;
Data Stream API.

Это позволяет:

постепенно внедрять новую схему разметки;
отправлять больше продуктовых сценариев и шагов;
строить подробные воронки и аналитику без расходования лимитов кастомных событий и DSA.

Основные события

Схема взаимодействия строится на основе четырех основных событий:

Событие	Что означает
`offerShown`	Пользователь увидел оффер или предложение
`flowStart`	Пользователь начал оформление продукта
`flowStep`	Промежуточный шаг оформления
`flowResult`	Итоговый результат

Примеры событий

offerShown

Пользователь увидел баннер: «Вам предварительно одобрен кредит до 500 000 ₽ по ставке от 12.5%».

AppMetrica.reportEvent(
    ProductFlowEvent.offerShown("credit_q1", "financial_product")
        .withProductId("personal_loan")
        .withBenefitType("discount_percentage")
        .withReferrer(
                OfferReferrer.newBuilder()
                    .withType("banner")
                    .withIdentifier("main_screen_credit_banner")
                    .withScreen("main")
                    .build()
        )
        .withPayload(mapOf(
            "campaign_id" to "credit_spring_2026",
            "segment" to "preapproved_users",
            "approved_limit" to "500000",
            "currency" to "RUB",
            "interest_rate" to "12.5"
        ))
        .build()
)

flowStart

Пользователь нажимает на баннер и начинает оформление заявки.

AppMetrica.reportEvent(
    ProductFlowEvent.flowStart("personal_loan")
        .withProductOfferId("credit_q1")
        .build()
)

flowStep

Пользователь загружает документы.

AppMetrica.reportEvent(
    ProductFlowEvent.flowStepForProduct("personal_loan", "documents")
        .withProductOfferId("credit_q1")
        .withStepOption("passport_upload")
        .build()
)

flowResult

Позже банк присылает финальный результат через S2S.

AppMetrica.reportEvent(
    ProductFlowEvent.flowResultForProduct(ProductFlowStatus.SUCCESS, "personal_loan")
        .withProductOfferId("credit_q1")
        .withPayload(mapOf(
            "application_id" to "loan_app_12345",
            "approved_amount" to "430000",
            "currency" to "RUB",
            "decision_source" to "s2s"
        ))
        .build()
)

Если вы не нашли ответ на свой вопрос, то вы можете задать его через форму обратной связи. Пожалуйста, опишите возникшую проблему как можно подробнее. Если возможно, приложите скриншот.

Написать в службу поддержки Предложить улучшение для документации

Была ли статья полезна?

Поддержка отложенных deeplinks

Описание ошибок