---
title: "Conector Amplitude"
description: "Guia completo de integração do Amplitude para sincronizar eventos de product analytics, propriedades de usuário e cohorts comportamentais com o Brevo através do Tajo."
url: https://tajo.io/pt/docs/connectors/custom/amplitude/
markdown: https://tajo.io/pt/docs/connectors/custom/amplitude.md
lang: pt-BR
robots: noindex
---

Solicite acesso antecipado

Indique o seu nome e endereço de e-mail profissional. Enviaremos um link para confirmar o seu pedido de acesso ao Tajo.

# Conector Amplitude

Status do conector: Planejado Ainda não construído. O Tajo não executa este conector hoje.

| Campo de origem | Campo de destino | Valor de exemplo |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Conecte o Amplitude ao Brevo através do Tajo para aproveitar dados de product analytics em sua automação de marketing. Sincronize cohorts comportamentais, propriedades de usuário e eventos de produto para alimentar campanhas segmentadas.

## Visão geral

| Propriedade | Valor |
| --- | --- |
| **Plataforma** | Amplitude |
| **Categoria** | Analytics (Personalizado) |
| **Complexidade de configuração** | Média |
| **Integração oficial** | Não |
| **Dados sincronizados** | Eventos, Usuários, Cohorts, Propriedades |
| **Skills disponíveis** | 6 |

## Recursos

- **Encaminhamento de eventos** - Envie eventos de track do Amplitude para o Brevo como gatilhos de automação de marketing
- **Sincronização de cohorts** - Exporte cohorts comportamentais do Amplitude como listas de contatos do Brevo
- **Sincronização de propriedades de usuário** - Mapeie propriedades de usuário do Amplitude para atributos de contato do Brevo
- **Rastreamento de receita** - Sincronize eventos de receita para análise de valor vitalício do cliente
- **Segmentação comportamental** - Use dados de engajamento do Amplitude em segmentos do Brevo
- **Integração com HTTP V2 API** - Integração direta com a API de ingestão HTTP V2 do Amplitude

## Pré-requisitos

Antes de começar, certifique-se de que você tem:

1. Uma conta Amplitude com um projeto criado
2. Sua API Key e Secret Key do Amplitude
3. Uma conta Brevo com acesso à API
4. Uma conta Tajo com credenciais de API

## Autenticação

### Chaves de API do Amplitude

O Amplitude usa pares de API Key e Secret Key para autenticação. A API Key identifica seu projeto, enquanto a Secret Key autentica requisições do lado do servidor.

```bash
# Find your keys in Amplitude:
# Settings > Projects > [Your Project] > General
```

### Autenticação da HTTP V2 API

A HTTP V2 API usa a chave de API no corpo da requisição:

```bash
curl -X POST https://api2.amplitude.com/2/httpapi \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_AMPLITUDE_API_KEY",
    "events": [...]
  }'
```

## Configuração

### Configuração básica

```yaml
connectors:
  amplitude:
    enabled: true
    api_key: "your-amplitude-api-key"
    secret_key: "your-amplitude-secret-key"
    data_center: "US"  # or "EU"

    # Data sync options
    sync:
      events: true
      user_properties: true
      cohorts: true
      revenue: true

    # Brevo list assignment
    lists:
      active_users: 10
      power_users: 11
      churning_users: 12
```

### Mapeamento de eventos

Mapeie eventos do Amplitude para gatilhos de automação do Brevo:

```yaml
event_mapping:
  # Amplitude event -> Brevo event
  "Purchase": "order_completed"
  "Sign Up": "customer_created"
  "Add to Cart": "cart_updated"
  "Page View": "page_viewed"
  "Feature Click": "feature_used"

  # Revenue events
  "Revenue": "revenue_event"
  "Subscription Started": "subscription_created"
```

### Mapeamento de propriedades de usuário

Mapeie propriedades de usuário do Amplitude para atributos de contato do Brevo:

```yaml
property_mapping:
  # Amplitude property -> Brevo attribute
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS
  plan_type: PLAN
  signup_date: SIGNUP_DATE
  total_purchases: ORDER_COUNT
  lifetime_revenue: LTV
  last_active: LAST_ACTIVE
  device_type: DEVICE
```

## Endpoints da API

| Método | Endpoint | Descrição |
| --- | --- | --- |
| `POST` | `/2/httpapi` | Enviar eventos (HTTP V2 API) |
| `POST` | `/batch` | Enviar eventos em massa (Batch API) |
| `POST` | `/identify` | Definir propriedades de usuário |
| `POST` | `/groupidentify` | Definir propriedades de grupo |
| `GET` | `/2/export` | Exportar dados brutos de eventos |
| `GET` | `/2/usersearch` | Buscar usuários |
| `GET` | `/2/useractivity` | Obter timeline de atividade do usuário |
| `POST` | `/api/3/cohort/export` | Exportar membros de cohort |
| `GET` | `/api/3/chart/{chart_id}/query` | Consultar dados de chart salvo |

## Exemplos de código

### Inicializar o conector Amplitude

```javascript
import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Connect Amplitude project
await tajo.connectors.connect('amplitude', {
  apiKey: process.env.AMPLITUDE_API_KEY,
  secretKey: process.env.AMPLITUDE_SECRET_KEY,
  dataCenter: 'US'
});
```

### Enviar eventos via HTTP V2 API

```javascript
// Send events to Amplitude (automatically forwarded to Brevo)
const response = await fetch('https://api2.amplitude.com/2/httpapi', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    api_key: process.env.AMPLITUDE_API_KEY,
    events: [
      {
        user_id: "user_123",
        event_type: "Purchase",
        event_properties: {
          revenue: 89.99,
          product_id: "SKU-001",
          product_name: "Widget Pro"
        },
        user_properties: {
          $set: {
            email: "jane@example.com",
            plan_type: "premium"
          }
        },
        time: Date.now()
      }
    ]
  })
});

// Expected response: { "code": 200, "events_ingested": 1 }
```

### Sincronizar cohort para lista do Brevo

```javascript
// Export an Amplitude cohort and sync to Brevo
const cohort = await tajo.connectors.syncCohort('amplitude', {
  cohortId: 'abc123',
  targetList: 11,  // Brevo list ID
  syncMode: 'mirror'  // mirror, append, or remove
});

console.log(cohort);
// {
//   cohortName: "Power Users",
//   membersCount: 2450,
//   syncedToBrevo: 2450,
//   listId: 11
// }
```

## Limites de taxa

| API | Limite | Detalhes |
| --- | --- | --- |
| **HTTP V2 API** | 1.000 eventos/seg | Por projeto, burst até 2.000/seg |
| **Batch API** | 1.000 eventos/lote | Máx 20 lotes/seg |
| **Identify API** | 1.000 req/seg | Por projeto |
| **Export API** | 360 requisições/hora | Por projeto |
| **Cohort Export** | 1 exportação concorrente | Por cohort |
| **Dashboard REST API** | 360 requisições/hora | Por projeto |

Limites de tamanho de evento

Cada payload de evento não pode exceder 1 MB. A HTTP V2 API aceita até 2.000 eventos por requisição com um tamanho máximo de corpo de 20 MB.

## Solução de problemas

| Problema | Causa | Solução |
| --- | --- | --- |
| Eventos retornam status `invalid` | Campos obrigatórios ausentes | Garanta que `user_id` ou `device_id` esteja definido em cada evento |
| Propriedades de usuário não sincronizam | Operador de propriedade errado | Use `$set` para definir, `$setOnce` para valores de primeiro toque |
| Exportação de cohort vazia | Cohort ainda em cálculo | Aguarde a conclusão do cálculo do cohort antes da exportação |
| 429 Too Many Requests | Limite de taxa excedido | Implemente backoff exponencial e use a Batch API |
| Receita não rastreando | Campos de receita ausentes | Inclua `price`, `quantity` e `revenue` nas propriedades do evento |
| Dados da UE não roteando | Data center errado | Defina `data_center: "EU"` e use `api.eu.amplitude.com` |

## Melhores práticas

1. **Use a HTTP V2 API** - Prefira a V2 API em vez da HTTP API antiga para melhor validação e respostas de erro
2. **Agrupe eventos em lotes** - Envie eventos em lotes de até 1.000 para throughput ideal
3. **Defina propriedades de usuário nos eventos** - Inclua `user_properties` em eventos de track para reduzir chamadas de identify
4. **Use cohorts para segmentação** - Sincronize cohorts comportamentais em vez de replicar lógica de segmentação complexa
5. **Rastreie eventos de receita corretamente** - Use os campos `revenue`, `price` e `productId` para rastreamento preciso de receita
6. **Monitore a saúde da ingestão** - Verifique o Ingestion Debugger do Amplitude para erros de validação de evento
7. **Implemente rastreamento do lado do servidor** - Use SDKs do lado do servidor para entrega confiável de eventos

## Segurança

- **Somente HTTPS** - Toda comunicação com a API exige TLS 1.2+
- **Rotação de chave de API** - Rotacione as Secret Keys periodicamente via configurações do Amplitude
- **Allowlisting de IP** - Disponível em planos Enterprise
- **SOC 2 Type II** - O Amplitude é certificado SOC 2 Type II
- **GDPR/CCPA** - Suporte a solicitações de exclusão e exportação de dados do usuário
- **Residência de dados na UE** - Opção de data center na UE disponível

## Recursos relacionados

- [Conector Segment](https://tajo.io/pt/docs/connectors/custom/segment)
- [Conector Mixpanel](https://tajo.io/pt/docs/connectors/custom/mixpanel)
- [Skill de sincronização de clientes](https://tajo.io/pt/docs/skills/data-sync/customer-sync)
- [API de eventos do Brevo](https://tajo.io/pt/docs/events-engagement/create-event)