Быстрый старт

appmetrica.online принимает события приложений по HTTP. SDK не нужен: приложение само отправляет session_start, когда выходит на передний план, и session_end, когда уходит в фон. По этим двум системным событиям считаются сессии, их длительность и retention. Свои события со свойствами, например purchase, отправляются в тех же батчах: приславший их человек считается активным, а сами события видны в realtime, в профилях и на вкладке «События»; см. Свои события.

1. Создайте приложениеСкопировать ссылку на раздел

В портфеле нажмите «Добавить приложение», выберите платформы и часовой пояс. Приложение — это один продукт: если он выходит на iOS, Android и в вебе, отметьте все три платформы, а не создавайте три приложения. Часовой пояс задаёт границы суток в отчётах; если сменить его позже, прошлые дни пересчитаются в новом поясе. На каждую платформу создаётся свой write-ключ pk_…, а на вкладке «Интеграция» появятся ключи и готовые сниппеты по каждой платформе. Платформы можно добавить позже в настройках приложения.

Write-ключ не секретный: он вшивается в приложение и виден любому, кто его разберёт. От злоупотреблений защищают лимиты частоты, а скомпрометированный ключ можно отозвать и выпустить новый.

2. Отправьте первое событиеСкопировать ссылку на раздел

Проверьте ключ из терминала. Подставьте его в переменную AM_PK:

export AM_PK="pk_…"

и отправьте одно событие. В примерах документации стоит условный домен analytics.example.com: замените i.analytics.example.com на адрес ingest своей установки, он есть на вкладке «Интеграция».

NOW=$(date -u +"%Y-%m-%dT%H:%M:%S.000Z")
curl -sS https://i.analytics.example.com/v1/events \
  -H "Content-Type: application/json" \
  -H "X-App-Key: $AM_PK" \
  --data-binary @- <<JSON
{
  "sent_at": "$NOW",
  "context": { "platform": "ios", "app_version": "1.0.0", "environment": "development" },
  "events": [
    {
      "insert_id": "$(uuidgen | tr A-Z a-z)",
      "name": "session_start",
      "timestamp": "$NOW",
      "install_id": "$(uuidgen | tr A-Z a-z)",
      "session_id": "$(uuidgen | tr A-Z a-z)"
    }
  ]
}
JSON

Ответ 200 приходит только после записи в хранилище. accepted — число принятых событий, rejected — отклонённые события с кодом причины, warnings — события, принятые с поправкой:

{ "accepted": 1, "rejected": [], "warnings": [], "server_time": "2026-10-14T09:15:02.318Z" }

environment: "development" отделяет тестовые события от боевых: отчёты по умолчанию показывают только production.

3. Встройте отправку в приложениеСкопировать ссылку на раздел

Аналитика создаётся один раз на процесс, а сессия следует за жизненным циклом всего приложения, а не отдельного экрана. Точки входа и хуки для каждой платформы собраны в разделе Где инициализировать метрику.

Затем выберите рецепт для своей платформы. В каждом есть хранение install_id, жизненный цикл сессии и офлайн-очередь:

• iOS (Swift) — URLSession, Keychain, SwiftUI и UIKit;
• Android (Kotlin) — HttpURLConnection, SharedPreferences, ProcessLifecycleOwner;
• Веб (JavaScript) — navigator.sendBeacon, localStorage;
• React Native (TypeScript) — fetch, Keychain и AsyncStorage, AppState;
• Flutter (Dart) — package:http, очередь в файле, WidgetsBindingObserver на телефонах и десктопе;
• Kotlin Multiplatform — Ktor, expect/actual, общий трекер для Android и iOS;
• Боты и бэкенды — Telegram-боты, серверные сессии, context.ip;
• curl — все запросы из терминала: батчи, досыл, gzip, повторы, Read API;
• Go — клиент с повторами для бэкендов, CLI и cron-задач.

Встраиваете с помощью ИИ-агента? Дайте ему /llms.txt: инструкция по интеграции для всех платформ в одном файле. В /llms-full.txt — вся документация одним Markdown-файлом на английском.

4. Проверьте данныеСкопировать ссылку на раздел

На вкладке «Интеграция» видны последние события и ошибки отклонённых событий по версиям приложения. На вкладке «Realtime» событие появится в течение 10 секунд, на вкладке «Аудитория» — DAU и новые пользователи за выбранный период.

Платформа событияСкопировать ссылку на раздел

Одно приложение принимает события со всех своих платформ. Платформа события определяется по порядку:

1. context.platform события или батча; контекст события перекрывает контекст батча;
2. платформа write-ключа, которым отправлен батч;
3. единственная платформа приложения, если она одна;
4. иначе other, и ответ несёт предупреждение platform_missing с индексом события.

Ключи, созданные вместе с приложением, привязаны к своим платформам: вшейте в каждую сборку ключ её платформы, и платформа определится даже без context.platform. В настройках можно выпустить ключ «Любая платформа» — он удобен, когда одна кодовая база собирается под несколько платформ (Flutter, React Native, Kotlin Multiplatform). С таким ключом передавайте context.platform в каждом батче. Событие с платформой, которой нет в наборе приложения, принимается как есть.

Отчёты по умолчанию сводные и считают людей сквозь платформы — см. Люди на нескольких платформах.

Телевизоры, часы и планшетыСкопировать ссылку на раздел

Набор платформ фиксирован: ios, android, web, macos, windows, linux, bot, server и other. Любое другое значение, например tvos, отклоняется с кодом invalid_field. Устройство без собственной платформы отправляет события с платформой своего семейства ОС, своими device_type и os_name и ключом платформы семейства: Apple TV — ключом iOS, Android TV — ключом Android.

Отчёты фильтруются по os_name, а не по device_type, поэтому у телевизоров и часов своё название ОС: фильтр Android TV открывает отчёты только по телевизорам, а разбивка по типу устройства показывает долю каждого типа. На устройствах Apple UIDevice.current.systemName уже возвращает tvOS или visionOS. Как определить тип устройства:

• Swift: UIDevice.current.userInterfaceIdiom, где .pad — планшет, .tv — телевизор, как в рецепте для iOS;
• Kotlin: resources.configuration.uiMode and Configuration.UI_MODE_TYPE_MASK, где UI_MODE_TYPE_TELEVISION — телевизор, UI_MODE_TYPE_WATCH — часы, как в рецепте для Android;
• React Native: DeviceInfo.getDeviceType() из react-native-device-info возвращает Tv;
• Flutter: на Android TV systemFeatures у AndroidDeviceInfo из device_info_plus содержит android.software.leanback;
• веб: user agent браузеров телевизоров содержит SMART-TV, Tizen или Web0S.

Что почитать дальшеСкопировать ссылку на раздел

• Где инициализировать метрику — точки входа и хуки жизненного цикла.
• Идентичность — install_id, user_id и как считаются люди.
• Сессии — когда начинать и заканчивать сессию.
• Свои события — имена и свойства своих событий.
• Время и офлайн-очередь — сбитые часы и досыл через 7 дней.
• Ошибки и повторы — коды ответа и что делать с каждым.
• Приватность и GDPR — что хранится и как удалить данные.
• Ingestion API — полный формат батча.
• Read API — те же отчёты для скриптов по ключу sk_….