Connecteur Amplitude

Connectez Amplitude à Brevo via Tajo pour exploiter les données d’analyse produit dans l’automatisation marketing. Synchronisez cohortes comportementales, propriétés utilisateur et événements produit pour alimenter des campagnes ciblées.

Vue d’ensemble

Fonctionnalités

• Transfert d’événements, Envoyez les événements track d’Amplitude vers Brevo pour déclencher des automatisations marketing
• Synchronisation de cohortes, Exportez les cohortes comportementales Amplitude sous forme de listes de contacts Brevo
• Synchronisation des propriétés utilisateur, Mappez les propriétés utilisateur Amplitude vers les attributs de contact Brevo
• Suivi des revenus, Synchronisez les événements de revenus pour l’analyse de la valeur vie client
• Segmentation comportementale, Utilisez les données d’engagement Amplitude dans les segments Brevo
• Intégration HTTP V2 API, Intégration directe avec l’API d’ingestion HTTP V2 d’Amplitude

Prérequis

Avant de commencer, assurez-vous de disposer de :

1. Un compte Amplitude avec un projet créé
2. Votre API Key et Secret Key Amplitude
3. Un compte Brevo avec accès API
4. Un compte Tajo avec identifiants API

Authentification

Clés API Amplitude

Amplitude utilise des paires API Key et Secret Key pour l’authentification. L’API Key identifie votre projet, tandis que la Secret Key authentifie les requêtes côté serveur.

# Trouvez vos clés dans Amplitude :
# Settings > Projects > [Votre projet] > General

Authentification HTTP V2 API

L’API HTTP V2 utilise la clé API dans le corps de la requête :

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

Configuration

Configuration de base

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

    # Options de synchronisation des données
    sync:
      events: true
      user_properties: true
      cohorts: true
      revenue: true

    # Attribution de listes Brevo
    lists:
      active_users: 10
      power_users: 11
      churning_users: 12

Mappage des événements

Mappez les événements Amplitude vers les déclencheurs d’automatisation Brevo :

event_mapping:
  # Événement Amplitude -> Événement Brevo
  "Purchase": "order_completed"
  "Sign Up": "customer_created"
  "Add to Cart": "cart_updated"
  "Page View": "page_viewed"
  "Feature Click": "feature_used"

  # Événements de revenus
  "Revenue": "revenue_event"
  "Subscription Started": "subscription_created"

Mappage des propriétés utilisateur

Mappez les propriétés utilisateur Amplitude vers les attributs de contact Brevo :

property_mapping:
  # Propriété Amplitude -> Attribut Brevo
  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 API

Exemples de code

Initialiser le connecteur Amplitude

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

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

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

Envoyer des événements via l’API HTTP V2

// Envoyer des événements à Amplitude (transférés automatiquement vers 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: "[email protected]",
            plan_type: "premium"
          }
        },
        time: Date.now()
      }
    ]
  })
});

// Réponse attendue : { "code": 200, "events_ingested": 1 }

Synchroniser une cohorte vers une liste Brevo

// Exporter une cohorte Amplitude et la synchroniser vers Brevo
const cohort = await tajo.connectors.syncCohort('amplitude', {
  cohortId: 'abc123',
  targetList: 11,  // ID de liste Brevo
  syncMode: 'mirror'  // mirror, append, ou remove
});

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

Limites de débit

Dépannage

Bonnes pratiques

1. Utilisez l’API HTTP V2, Préférez l’API V2 à l’ancienne API HTTP pour une meilleure validation et de meilleures réponses d’erreur
2. Groupez les événements, Envoyez les événements par lots de jusqu’à 1 000 pour un débit optimal
3. Définissez les propriétés utilisateur sur les événements, Incluez user_properties sur les événements track pour réduire les appels identify
4. Utilisez les cohortes pour la segmentation, Synchronisez les cohortes comportementales plutôt que de répliquer une logique de segmentation complexe
5. Suivez correctement les événements de revenus, Utilisez les champs revenue, price et productId pour un suivi précis
6. Surveillez la santé de l’ingestion, Consultez le Ingestion Debugger d’Amplitude pour les erreurs de validation d’événements
7. Implémentez le tracking côté serveur, Utilisez des SDK serveur pour une livraison fiable des événements

Sécurité

• HTTPS uniquement, Toutes les communications API requièrent TLS 1.2+
• Rotation des clés API, Faites tourner les Secret Keys périodiquement via les paramètres Amplitude
• Allowlist d’IP, Disponible sur les plans Enterprise
• SOC 2 Type II, Amplitude est certifié SOC 2 Type II
• RGPD/CCPA, Prise en charge des demandes de suppression et d’export de données utilisateur
• Résidence des données UE, Option de centre de données UE disponible

Ressources associées

• Connecteur Segment
• Connecteur Mixpanel
• Skill de synchronisation client
• API Events Brevo