Amplitude
Отслеживание событий и запрос аналитики из Amplitude
Amplitude — это ведущая платформа цифровой аналитики, которая помогает командам понимать поведение пользователей, измерять производительность продукта и принимать решения на основе данных в масштабе.
Интеграция Amplitude в AACFlow подключается к HTTP и Dashboard REST API Amplitude с использованием аутентификации по API-ключу и секретному ключу, позволяя вашим агентам отслеживать события, управлять свойствами пользователей и запрашивать аналитические данные программно. Этот подход на основе API обеспечивает безопасный доступ ко всему набору аналитических возможностей Amplitude.
С интеграцией Amplitude ваши агенты могут:
- Отслеживать события: Отправлять пользовательские события в Amplitude с богатыми свойствами, данными о доходах и контекстом пользователя непосредственно из ваших рабочих процессов
- Идентифицировать пользователей: Устанавливать и обновлять свойства пользователей с использованием операций $set, $setOnce, $add, $append и $unset для поддержания детальных профилей пользователей
- Искать пользователей: Искать пользователей по User ID, Device ID или Amplitude ID для получения информации о профиле и метаданных
- Запрашивать аналитику событий: Выполнять запросы сегментации событий с группировкой, пользовательскими метриками (уникальные, общие, средние, проценты DAU) и гибкими диапазонами дат
- Мониторить активность пользователей: Получать потоки событий для конкретных пользователей для понимания индивидуальных путей пользователей и паттернов поведения
- Анализировать активных пользователей: Получать количество активных или новых пользователей с течением времени с ежедневной, еженедельной или ежемесячной детализацией
- Отслеживать доходы: Получать доступ к метрикам LTV доходов, включая ARPU, ARPPU, общий доход и количество платящих пользователей
В AACFlow интеграция с Amplitude позволяет реализовать мощные сценарии автоматизации аналитики. Ваши агенты могут отслеживать события продукта в реальном времени на основе триггеров рабочих процессов, обогащать профили пользователей по мере появления новых данных, запрашивать данные сегментации для информирования последующих решений или создавать рабочие процессы мониторинга, которые предупреждают об изменениях ключевых метрик. Подключая AACFlow к Amplitude, вы можете создавать интеллектуальных агентов, которые устраняют разрыв между аналитическими инсайтами и автоматизированными действиями, обеспечивая рабочие процессы на основе данных, которые реагируют на паттерны поведения пользователей и тенденции производительности продукта.
Интегрируйте Amplitude в ваш рабочий процесс для отслеживания событий, идентификации пользователей и групп, поиска пользователей, запроса аналитики и получения данных о доходах.
Отслеживание события в Amplitude с использованием HTTP V2 API.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ Amplitude |
userId | string | Нет | Идентификатор пользователя (обязателен, если нет device_id) |
deviceId | string | Нет | Идентификатор устройства (обязателен, если нет user_id) |
eventType | string | Да | Название события (например, "page_view", "purchase") |
eventProperties | string | Нет | JSON-объект пользовательских свойств события |
userProperties | string | Нет | JSON-объект свойств пользователя для установки (поддерживает $set, $setOnce, $add, $append, $unset) |
time | string | Нет | Временная метка события в миллисекундах с эпохи |
sessionId | string | Нет | Время начала сессии в миллисекундах с эпохи |
insertId | string | Нет | Уникальный идентификатор для дедупликации (в пределах 7-дневного окна) |
appVersion | string | Нет | Строка версии приложения |
platform | string | Нет | Платформа (например, "Web", "iOS", "Android") |
country | string | Нет | Двухбуквенный код страны |
language | string | Нет | Код языка (например, "en") |
ip | string | Нет | IP-адрес для геолокации |
price | string | Нет | Цена приобретенного товара |
quantity | string | Нет | Количество приобретенных товаров |
revenue | string | Нет | Сумма дохода |
productId | string | Нет | Идентификатор продукта |
revenueType | string | Нет | Тип дохода (например, "purchase", "refund") |
| Параметр | Тип | Описание |
|---|
code | number | Код ответа (200 для успеха) |
eventsIngested | number | Количество обработанных событий |
payloadSizeBytes | number | Размер полезной нагрузки в байтах |
serverUploadTime | number | Временная метка загрузки на сервер |
Установка свойств пользователя в Amplitude с использованием Identify API. Поддерживает операции $set, $setOnce, $add, $append, $unset.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ Amplitude |
userId | string | Нет | Идентификатор пользователя (обязателен, если нет device_id) |
deviceId | string | Нет | Идентификатор устройства (обязателен, если нет user_id) |
userProperties | string | Да | JSON-объект свойств пользователя. Используйте операции $set, $setOnce, $add, $append, $unset. |
| Параметр | Тип | Описание |
|---|
code | number | HTTP-код статуса ответа |
message | string | Сообщение ответа |
Установка свойств на уровне группы в Amplitude. Поддерживает операции $set, $setOnce, $add, $append, $unset.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ Amplitude |
groupType | string | Да | Классификация группы (например, "company", "org_id") |
groupValue | string | Да | Конкретный идентификатор группы (например, "Acme Corp") |
groupProperties | string | Да | JSON-объект свойств группы. Используйте операции $set, $setOnce, $add, $append, $unset. |
| Параметр | Тип | Описание |
|---|
code | number | HTTP-код статуса ответа |
message | string | Сообщение ответа |
Поиск пользователя по User ID, Device ID или Amplitude ID с использованием Dashboard REST API.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ Amplitude |
secretKey | string | Да | Секретный ключ Amplitude |
user | string | Да | User ID, Device ID или Amplitude ID для поиска |
| Параметр | Тип | Описание |
|---|
matches | array | Список соответствующих пользователей |
↳ amplitudeId | number | Внутренний идентификатор пользователя Amplitude |
↳ userId | string | Внешний идентификатор пользователя |
type | string | Тип соответствия (например, match_user_or_device_id) |
Получение потока событий для конкретного пользователя по его Amplitude ID.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ Amplitude |
secretKey | string | Да | Секретный ключ Amplitude |
amplitudeId | string | Да | Внутренний идентификатор пользователя Amplitude |
offset | string | Нет | Смещение для пагинации (по умолчанию 0) |
limit | string | Нет | Максимальное количество возвращаемых событий (по умолчанию 1000, максимум 1000) |
direction | string | Нет | Направление сортировки: "latest" или "earliest" (по умолчанию: latest) |
| Параметр | Тип | Описание |
|---|
events | array | Список событий пользователя |
↳ eventType | string | Тип события |
↳ eventTime | string | Временная метка события |
↳ eventProperties | json | Пользовательские свойства события |
↳ userProperties | json | Свойства пользователя на момент события |
↳ sessionId | number | Идентификатор сессии |
↳ platform | string | Платформа |
↳ country | string | Страна |
↳ city | string | Город |
userData | json | Метаданные пользователя |
↳ userId | string | Внешний идентификатор пользователя |
↳ canonicalAmplitudeId | number | Канонический идентификатор Amplitude |
↳ numEvents | number | Общее количество событий |
↳ numSessions | number | Общее количество сессий |
↳ platform | string | Основная платформа |
↳ country | string | Страна |
Получение профиля пользователя, включая свойства, членства в когортах и вычисляемые свойства.
| Параметр | Тип | Обязательный | Описание |
|---|
secretKey | string | Да | Секретный ключ Amplitude |
userId | string | Нет | Внешний идентификатор пользователя (обязателен, если нет device_id) |
deviceId | string | Нет | Идентификатор устройства (обязателен, если нет user_id) |
getAmpProps | string | Нет | Включать свойства пользователя Amplitude (true/false, по умолчанию: false) |
getCohortIds | string | Нет | Включать идентификаторы когорт, к которым принадлежит пользователь (true/false, по умолчанию: false) |
getComputations | string | Нет | Включать вычисляемые свойства пользователя (true/false, по умолчанию: false) |
| Параметр | Тип | Описание |
|---|
userId | string | Внешний идентификатор пользователя |
deviceId | string | Идентификатор устройства |
ampProps | json | Свойства пользователя Amplitude (библиотека, first_used, last_used, пользовательские свойства) |
cohortIds | array | Список идентификаторов когорт, к которым принадлежит пользователь |
computations | json | Вычисляемые свойства пользователя |
Запрос аналитических данных событий с сегментацией. Получение количества событий, уникальных значений, средних значений и других метрик.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ Amplitude |
secretKey | string | Да | Секретный ключ Amplitude |
eventType | string | Да | Название типа события для анализа |
start | string | Да | Дата начала в формате YYYYMMDD |
end | string | Да | Дата окончания в формате YYYYMMDD |
metric | string | Нет | Тип метрики: uniques, totals, pct_dau, average, histogram, sums, value_avg или formula (по умолчанию: uniques) |
interval | string | Нет | Временной интервал: 1 (ежедневно), 7 (еженедельно) или 30 (ежемесячно) |
groupBy | string | Нет | Название свойства для группировки (префикс пользовательских свойств пользователя с "gp:") |
limit | string | Нет | Максимальное количество значений группировки (максимум 1000) |
| Параметр | Тип | Описание |
|---|
series | json | Массивы данных временных рядов, индексированные по сериям |
seriesLabels | array | Метки для каждой серии данных |
seriesCollapsed | json | Свернутые агрегированные итоги по сериям |
xValues | array | Значения дат для оси X |
Получение количества активных или новых пользователей за диапазон дат из Dashboard REST API.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ Amplitude |
secretKey | string | Да | Секретный ключ Amplitude |
start | string | Да | Дата начала в формате YYYYMMDD |
end | string | Да | Дата окончания в формате YYYYMMDD |
metric | string | Нет | Тип метрики: "active" или "new" (по умолчанию: active) |
interval | string | Нет | Временной интервал: 1 (ежедневно), 7 (еженедельно) или 30 (ежемесячно) |
| Параметр | Тип | Описание |
|---|
series | json | Массив серий данных с количеством пользователей за временной интервал |
seriesMeta | array | Метки метаданных для каждой серии данных (например, названия сегментов) |
xValues | array | Значения дат для оси X |
Получение количества активных пользователей в реальном времени с детализацией 5 минут за последние 2 дня.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ Amplitude |
secretKey | string | Да | Секретный ключ Amplitude |
| Параметр | Тип | Описание |
|---|
series | json | Массив серий данных с количеством активных пользователей с интервалом 5 минут |
seriesLabels | array | Метки для каждой серии (например, "Сегодня", "Вчера") |
xValues | array | Значения времени для оси X (например, "15:00", "15:05") |
Список всех типов событий в проекте Amplitude с их еженедельными итогами и уникальными количествами.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ Amplitude |
secretKey | string | Да | Секретный ключ Amplitude |
| Параметр | Тип | Описание |
|---|
events | array | Список типов событий в проекте |
↳ value | string | Название типа события |
↳ displayName | string | Отображаемое название события |
↳ totals | number | Еженедельное общее количество |
↳ hidden | boolean | Скрыто ли событие |
↳ deleted | boolean | Удалено ли событие |
Получение данных LTV доходов, включая ARPU, ARPPU, общий доход и количество платящих пользователей.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | API-ключ Amplitude |
secretKey | string | Да | Секретный ключ Amplitude |
start | string | Да | Дата начала в формате YYYYMMDD |
end | string | Да | Дата окончания в формате YYYYMMDD |
metric | string | Нет | Метрика: 0 (ARPU), 1 (ARPPU), 2 (Total Revenue), 3 (Paying Users) |
interval | string | Нет | Временной интервал: 1 (ежедневно), 7 (еженедельно) или 30 (ежемесячно) |
| Параметр | Тип | Описание |
|---|
series | json | Массив серий данных о доходах |
seriesLabels | array | Метки для каждой серии данных |
xValues | array | Значения дат для оси X |
