Amplitude

Amplitude é uma plataforma líder de análise digital que ajuda equipes a entender o comportamento do usuário, medir o desempenho do produto e tomar decisões baseadas em dados em escala.

A integração do Amplitude no Zoen se conecta com as APIs HTTP e REST do Dashboard do Amplitude usando autenticação com chave de API e chave secreta, permitindo que seus agentes rastreiem eventos, gerenciem propriedades de usuário e consultem dados de análise de forma programática. Essa abordagem baseada em API garante acesso seguro à gama completa de capacidades de análise do Amplitude.

Com a integração do Amplitude, seus agentes podem:

Rastrear eventos: Enviar eventos personalizados para o Amplitude com propriedades ricas, dados de receita e contexto do usuário diretamente de seus fluxos de trabalho
Identificar usuários: Definir e atualizar propriedades de usuário usando operações como $set, $setOnce, $add, $append e $unset para manter perfis de usuário detalhados
Pesquisar usuários: Procurar usuários por ID de Usuário, ID de Dispositivo ou ID do Amplitude para recuperar informações de perfil e metadados
Consultar análise de eventos: Executar consultas de segmentação de eventos com agrupamento, métricas personalizadas (únicos, totais, médias, porcentagens de DAU) e intervalos de datas flexíveis
Monitorar atividade do usuário: Recuperar fluxos de eventos para usuários específicos para entender jornadas individuais de usuário e padrões de comportamento
Analisar usuários ativos: Obter contagens de usuários ativos ou novos ao longo do tempo com granularidade diária, semanal ou mensal
Rastrear receita: Acessar métricas de LTV de receita, incluindo ARPU, ARPPU, receita total e contagem de usuários pagantes

No Zoen, a integração do Amplitude permite cenários de automação de análise poderosos. Seus agentes podem rastrear eventos de produto em tempo real com base em gatilhos de fluxo de trabalho, enriquecer perfis de usuário à medida que novos dados se tornam disponíveis, consultar dados de segmentação para informar decisões subsequentes ou construir fluxos de trabalho de monitoramento que alertam sobre alterações em métricas-chave. Ao conectar o Zoen com o Amplitude, você pode construir agentes inteligentes que preenchem a lacuna entre insights de análise e ações automatizadas, permitindo fluxos de trabalho orientados por dados que respondem a padrões de comportamento do usuário e tendências de desempenho do produto.

Usage Instructions

Integrate Amplitude into your workflow to track events, identify users and groups, search for users, query analytics, analyze funnels and retention, and retrieve revenue data.

Actions

`amplitude_send_event`

Track an event in Amplitude using the HTTP V2 API.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Amplitude API Key
`userId`	string	No	User ID (required if no device_id)
`deviceId`	string	No	Device ID (required if no user_id)
`eventType`	string	Yes	Name of the event (e.g., "page_view", "purchase")
`eventProperties`	string	No	JSON object of custom event properties
`userProperties`	string	No	JSON object of user properties to set (supports $set, $setOnce, $add, $append, $unset)
`time`	string	No	Event timestamp in milliseconds since epoch
`sessionId`	string	No	Session start time in milliseconds since epoch
`insertId`	string	No	Unique ID for deduplication (within 7-day window)
`appVersion`	string	No	Application version string
`platform`	string	No	Platform (e.g., "Web", "iOS", "Android")
`country`	string	No	Two-letter country code
`language`	string	No	Language code (e.g., "en")
`ip`	string	No	IP address for geo-location
`price`	string	No	Price of the item purchased
`quantity`	string	No	Quantity of items purchased
`revenue`	string	No	Revenue amount
`productId`	string	No	Product identifier
`revenueType`	string	No	Revenue type (e.g., "purchase", "refund")
`dataResidency`	string	No	Data residency region: "us" (default) or "eu"

Output

Parameter	Type	Description
`code`	number	Response code (200 for success)
`eventsIngested`	number	Number of events ingested
`payloadSizeBytes`	number	Size of the payload in bytes
`serverUploadTime`	number	Server upload timestamp

`amplitude_identify_user`

Set user properties in Amplitude using the Identify API. Supports $set, $setOnce, $add, $append, $unset operations.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Amplitude API Key
`userId`	string	No	User ID (required if no device_id)
`deviceId`	string	No	Device ID (required if no user_id)
`userProperties`	string	Yes	JSON object of user properties. Use operations like $set, $setOnce, $add, $append, $unset.
`dataResidency`	string	No	Data residency region: "us" (default) or "eu"

Output

Parameter	Type	Description
`code`	number	HTTP response status code
`message`	string	Response message

`amplitude_group_identify`

Set group-level properties in Amplitude. Supports $set, $setOnce, $add, $append, $unset operations.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Amplitude API Key
`groupType`	string	Yes	Group classification (e.g., "company", "org_id")
`groupValue`	string	Yes	Specific group identifier (e.g., "Acme Corp")
`groupProperties`	string	Yes	JSON object of group properties. Use operations like $set, $setOnce, $add, $append, $unset.
`dataResidency`	string	No	Data residency region: "us" (default) or "eu"

Output

Parameter	Type	Description
`code`	number	HTTP response status code
`message`	string	Response message

`amplitude_user_search`

Search for a user by User ID, Device ID, or Amplitude ID using the Dashboard REST API.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Amplitude API Key
`secretKey`	string	Yes	Amplitude Secret Key
`user`	string	Yes	User ID, Device ID, or Amplitude ID to search for
`dataResidency`	string	No	Data residency region: "us" (default) or "eu"

Output

Parameter	Type	Description
`matches`	array	List of matching users
↳ `amplitudeId`	number	Amplitude internal user ID
↳ `userId`	string	External user ID
`type`	string	Match type (e.g., match_user_or_device_id)

`amplitude_user_activity`

Get the event stream for a specific user by their Amplitude ID.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Amplitude API Key
`secretKey`	string	Yes	Amplitude Secret Key
`amplitudeId`	string	Yes	Amplitude internal user ID
`offset`	string	No	Offset for pagination (default 0)
`limit`	string	No	Maximum number of events to return (default 1000, max 1000)
`direction`	string	No	Sort direction: "latest" or "earliest" (default: latest)
`dataResidency`	string	No	Data residency region: "us" (default) or "eu"

Output

Parameter	Type	Description
`events`	array	List of user events
↳ `eventType`	string	Type of event
↳ `eventTime`	string	Event timestamp
↳ `eventProperties`	json	Custom event properties
↳ `userProperties`	json	User properties at event time
↳ `sessionId`	number	Session ID
↳ `platform`	string	Platform
↳ `country`	string	Country
↳ `city`	string	City
`userData`	json	User metadata
↳ `userId`	string	External user ID
↳ `canonicalAmplitudeId`	number	Canonical Amplitude ID
↳ `numEvents`	number	Total event count
↳ `numSessions`	number	Total session count
↳ `platform`	string	Primary platform
↳ `country`	string	Country
↳ `firstUsed`	string	Date the user first appeared
↳ `lastUsed`	string	Date of most recent user activity

`amplitude_user_profile`

Get a user profile including properties, cohort memberships, and computed properties. Not available for EU data-residency projects.

Input

Parameter	Type	Required	Description
`secretKey`	string	Yes	Amplitude Secret Key
`userId`	string	No	External user ID (required if no device_id)
`deviceId`	string	No	Device ID (required if no user_id)
`getAmpProps`	string	No	Include Amplitude user properties (true/false, default: false)
`getCohortIds`	string	No	Include cohort IDs the user belongs to (true/false, default: false)
`getComputations`	string	No	Include computed user properties (true/false, default: false)

Output

Parameter	Type	Description
`userId`	string	External user ID
`deviceId`	string	Device ID
`ampProps`	json	Amplitude user properties (library, first_used, last_used, custom properties)
`cohortIds`	array	List of cohort IDs the user belongs to
`computations`	json	Computed user properties

`amplitude_event_segmentation`

Query event analytics data with segmentation. Get event counts, uniques, averages, and more.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Amplitude API Key
`secretKey`	string	Yes	Amplitude Secret Key
`eventType`	string	Yes	Event type name to analyze
`start`	string	Yes	Start date in YYYYMMDD format
`end`	string	Yes	End date in YYYYMMDD format
`metric`	string	No	Metric type: uniques, totals, pct_dau, average, histogram, sums, value_avg, or formula (default: uniques)
`interval`	string	No	Time interval: 1 (daily), 7 (weekly), or 30 (monthly)
`groupBy`	string	No	Property name to group by (prefix custom user properties with "gp:")
`groupBy2`	string	No	Second property name to group by (prefix custom user properties with "gp:")
`limit`	string	No	Maximum number of group-by values (max 1000)
`filters`	string	No	JSON array of filter objects applied to the event, e.g. [{"subprop_type":"event","subprop_key":"city","subprop_op":"is","subprop_value":["San Francisco"]}]
`formula`	string	No	Required when metric is "formula", e.g. "UNIQUES(A)/UNIQUES(B)"
`segment`	string	No	JSON segment definition(s) applied to the query
`dataResidency`	string	No	Data residency region: "us" (default) or "eu"

Output

Parameter	Type	Description
`series`	json	Time-series data arrays indexed by series
`seriesLabels`	array	Labels for each data series
`seriesCollapsed`	json	Collapsed aggregate totals per series
`xValues`	array	Date values for the x-axis

`amplitude_get_active_users`

Get active or new user counts over a date range from the Dashboard REST API.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Amplitude API Key
`secretKey`	string	Yes	Amplitude Secret Key
`start`	string	Yes	Start date in YYYYMMDD format
`end`	string	Yes	End date in YYYYMMDD format
`metric`	string	No	Metric type: "active" or "new" (default: active)
`interval`	string	No	Time interval: 1 (daily), 7 (weekly), or 30 (monthly)
`groupBy`	string	No	Property name to group by
`segment`	string	No	JSON segment definition(s) applied to the query
`dataResidency`	string	No	Data residency region: "us" (default) or "eu"

Output

Parameter	Type	Description
`series`	json	Array of data series with user counts per time interval
`seriesMeta`	array	Metadata labels for each data series (e.g., segment names)
`xValues`	array	Date values for the x-axis

`amplitude_realtime_active_users`

Get real-time active user counts at 5-minute granularity for the last 2 days.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Amplitude API Key
`secretKey`	string	Yes	Amplitude Secret Key
`dataResidency`	string	No	Data residency region: "us" (default) or "eu"

Output

Parameter	Type	Description
`series`	json	Array of data series with active user counts at 5-minute intervals
`seriesLabels`	array	Labels for each series (e.g., "Today", "Yesterday")
`xValues`	array	Time values for the x-axis (e.g., "15:00", "15:05")

`amplitude_list_events`

List all event types in the Amplitude project with their weekly totals and unique counts.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Amplitude API Key
`secretKey`	string	Yes	Amplitude Secret Key
`dataResidency`	string	No	Data residency region: "us" (default) or "eu"

Output

Parameter	Type	Description
`events`	array	List of event types in the project
↳ `value`	string	Event type name
↳ `displayName`	string	Event display name
↳ `totals`	number	Weekly total count
↳ `hidden`	boolean	Whether the event is hidden
↳ `deleted`	boolean	Whether the event is deleted
↳ `nonActive`	boolean	Whether the event is excluded from active user calculations
↳ `flowHidden`	boolean	Whether the event is hidden from user flow charts

`amplitude_get_revenue`

Get revenue LTV data including ARPU, ARPPU, total revenue, and paying user counts.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Amplitude API Key
`secretKey`	string	Yes	Amplitude Secret Key
`start`	string	Yes	Start date in YYYYMMDD format
`end`	string	Yes	End date in YYYYMMDD format
`metric`	string	No	Metric: 0 (ARPU), 1 (ARPPU), 2 (Total Revenue), 3 (Paying Users)
`interval`	string	No	Time interval: 1 (daily), 7 (weekly), or 30 (monthly)
`groupBy`	string	No	Property name to group by (limit: one)
`segment`	string	No	JSON segment definition(s) applied to the query
`dataResidency`	string	No	Data residency region: "us" (default) or "eu"

Output

Parameter	Type	Description
`series`	array	Revenue data series [{dates: [YYYY-MM-DD], values: {<date>: {r1d..r90d, count, paid, total_amount}}}]
↳ `dates`	array	Dates covered by this series
↳ `values`	json	Per-date metric values keyed by date (r1d..r90d, count, paid, total_amount)
`seriesLabels`	array	Labels for each data series

`amplitude_funnels`

Analyze conversion rates and drop-off between a sequence of events.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Amplitude API Key
`secretKey`	string	Yes	Amplitude Secret Key
`events`	string	Yes	JSON array of event objects, one per funnel step in order, e.g. [{"event_type":"signup"},{"event_type":"purchase"}]
`start`	string	Yes	Start date in YYYYMMDD format
`end`	string	Yes	End date in YYYYMMDD format
`mode`	string	No	Funnel ordering: "ordered", "unordered", or "sequential" (default: ordered)
`userType`	string	No	User type: "new" or "active" (default: active)
`interval`	string	No	Time interval: -300000 (real-time), -3600000 (hourly), 1 (daily), 7 (weekly), or 30 (monthly)
`conversionWindowSeconds`	string	No	Conversion window in seconds (default: 2592000, i.e. 30 days)
`groupBy`	string	No	Property to group by (limit: one; prefix custom properties with "gp:")
`limit`	string	No	Maximum number of group-by values (default: 100, max: 1000)
`segment`	string	No	JSON segment definition(s) applied to the query
`dataResidency`	string	No	Data residency region: "us" (default) or "eu"

Output

Parameter	Type	Description
`funnels`	array	Funnel results, one entry per segment
↳ `stepByStep`	json	Conversion count at each step
↳ `cumulative`	json	Cumulative conversion percentage at each step
↳ `cumulativeRaw`	json	Cumulative conversion count at each step
↳ `medianTransTimes`	json	Median transition time between steps (ms)
↳ `avgTransTimes`	json	Average transition time between steps (ms)
↳ `events`	json	Event names for each funnel step
↳ `dayFunnels`	json	Daily funnel breakdown {series, xValues}

`amplitude_retention`

Measure how many users return to perform an action after a starting action.

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Amplitude API Key
`secretKey`	string	Yes	Amplitude Secret Key
`startEvent`	string	Yes	JSON starting event object, e.g. {"event_type":"_new"} or {"event_type":"_active"}
`returnEvent`	string	Yes	JSON returning event object, e.g. {"event_type":"_all"} or {"event_type":"_active"}
`start`	string	Yes	Start date in YYYYMMDD format
`end`	string	Yes	End date in YYYYMMDD format
`retentionMode`	string	No	Retention type: "bracket", "rolling", or "n-day" (default: n-day)
`retentionBrackets`	string	No	Required when Retention Mode is "bracket". Day ranges, e.g. [[0,4]]
`interval`	string	No	Time interval: 1 (daily), 7 (weekly), or 30 (monthly)
`groupBy`	string	No	Property to group by (limit: one; prefix custom properties with "gp:")
`segment`	string	No	JSON segment definition(s) applied to the query
`dataResidency`	string	No	Data residency region: "us" (default) or "eu"

Output

Parameter	Type	Description
`series`	array	Retention data series [{dates, values: {<date>: [{count, outof, incomplete}]}, combined: [{count, outof, incomplete}]}]
↳ `dates`	array	Cohort dates
↳ `values`	json	Per-cohort-date retention counts keyed by date
↳ `combined`	json	Deduplicated aggregate retention across all cohorts
`seriesMeta`	array	Segment/event index metadata for each series entry

Amplitude

On this page