--- title: "Connecteur Amplitude" description: "Guide complet d'intégration Amplitude pour synchroniser événements d'analyse produit, propriétés utilisateur et cohortes comportementales avec Brevo via Tajo." url: https://tajo.io/fr/docs/connectors/custom/amplitude/ markdown: https://tajo.io/fr/docs/connectors/custom/amplitude.md lang: fr-FR robots: noindex --- Demandez un accès anticipé Indiquez votre prénom et votre adresse e-mail professionnelle. Nous vous enverrons un lien pour confirmer votre demande d’accès à Tajo. # Connecteur Amplitude Statut du connecteur: Prévu Pas encore construit. Tajo n'exécute pas ce connecteur aujourd'hui. | Champ source | Champ de destination | Valeur d’exemple | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | 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 | Propriété | Valeur | | --- | --- | | **Plateforme** | Amplitude | | **Catégorie** | Analytics (Custom) | | **Complexité d’installation** | Moyenne | | **Intégration officielle** | Non | | **Données synchronisées** | Événements, utilisateurs, cohortes, propriétés | | **Skills disponibles** | 6 | ## 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. ```bash # 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 : ```bash 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 ```yaml 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 : ```yaml 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 : ```yaml 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 | Méthode | Endpoint | Description | | --- | --- | --- | | `POST` | `/2/httpapi` | Envoyer des événements (HTTP V2 API) | | `POST` | `/batch` | Envoi groupé d’événements (Batch API) | | `POST` | `/identify` | Définir les propriétés utilisateur | | `POST` | `/groupidentify` | Définir les propriétés de groupe | | `GET` | `/2/export` | Exporter les données d’événements brutes | | `GET` | `/2/usersearch` | Rechercher des utilisateurs | | `GET` | `/2/useractivity` | Obtenir la timeline d’activité utilisateur | | `POST` | `/api/3/cohort/export` | Exporter les membres d’une cohorte | | `GET` | `/api/3/chart/{chart_id}/query` | Interroger les données d’un graphique enregistré | ## Exemples de code ### Initialiser le connecteur Amplitude ```javascript 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 ```javascript // 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: "jane@example.com", plan_type: "premium" } }, time: Date.now() } ] }) }); // Réponse attendue : { "code": 200, "events_ingested": 1 } ``` ### Synchroniser une cohorte vers une liste Brevo ```javascript // 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 | API | Limite | Détails | | --- | --- | --- | | **HTTP V2 API** | 1 000 événements/s | Par projet, burst jusqu’à 2 000/s | | **Batch API** | 1 000 événements/lot | Max 20 lots/s | | **Identify API** | 1 000 req/s | Par projet | | **Export API** | 360 requêtes/heure | Par projet | | **Cohort Export** | 1 export simultané | Par cohorte | | **Dashboard REST API** | 360 requêtes/heure | Par projet | Limites de taille d'événement Chaque charge utile d’événement ne peut pas dépasser 1 Mo. L’API HTTP V2 accepte jusqu’à 2 000 événements par requête avec une taille de corps maximum de 20 Mo. ## Dépannage | Problème | Cause | Solution | | --- | --- | --- | | Les événements renvoient un statut `invalid` | Champs requis manquants | Assurez-vous que `user_id` ou `device_id` est défini sur chaque événement | | Les propriétés utilisateur ne se synchronisent pas | Mauvais opérateur de propriété | Utilisez `$set` pour définir, `$setOnce` pour les valeurs first-touch | | Export de cohorte vide | Cohorte en cours de calcul | Attendez la fin du calcul de la cohorte avant l’export | | 429 Too Many Requests | Limite de débit dépassée | Implémentez un backoff exponentiel et utilisez l’API batch | | Les revenus ne sont pas suivis | Champs de revenus manquants | Incluez `price`, `quantity` et `revenue` dans les propriétés d’événement | | Les données UE ne sont pas routées | Mauvais centre de données | Définissez `data_center: "EU"` et utilisez `api.eu.amplitude.com` | ## 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](https://tajo.io/fr/docs/connectors/custom/segment) - [Connecteur Mixpanel](https://tajo.io/fr/docs/connectors/custom/mixpanel) - [Skill de synchronisation client](https://tajo.io/fr/docs/skills/data-sync/customer-sync) - [API Events Brevo](https://tajo.io/fr/docs/events-engagement/create-event)