# Fiche connecteur Amplitude
Catalogue Pipedream : connexion du compte et droits nécessaires. Les actions réellement utilisables sont vérifiées dans Bruno lors de la connexion. Les déclencheurs sont documentés à titre de référence et ne sont pas activés automatiquement dans Bruno.
Les noms et données des exemples sont fictifs ; toute exécution reste soumise aux droits et aux validations du connecteur.

## Amplitude
URL : https://get-bruno.com/features/connectors/amplitude
Référence texte : https://get-bruno.com/features/connectors/amplitude/reference.txt
Origine : Catalogue Pipedream
Statut : Catalogue Pipedream — connexion à vérifier
Catégories : Analyse de données
Description : Amplitude est une plateforme d’analytique produit et d’expérimentation. Elle sert à enregistrer des événements et à lire des analyses sur les cohortes, les utilisateurs, les entonnoirs, la rétention et les segments d’événements.
Authentification : API key
Présentation : Amplitude est une plateforme d’analytique produit et d’expérimentation. Elle sert à enregistrer des événements et à lire des analyses sur les cohortes, les utilisateurs, les entonnoirs, la rétention et les segments d’événements.
Usage : Créer une cohorte statique à partir d’une liste d’utilisateurs
Exemple de demande : Je veux créer une cohorte statique nommée Clients actifs Q3 à partir des identifiants de user@exemple.com et atelier.martin@example.com.
Résultat attendu : Une cohorte statique peut être créée à partir d’une liste explicite d’identifiants.
À préciser : Nom de la cohorte ; Liste d’identifiants utilisateurs ou Amplitude ; Type d’identifiant utilisé
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/amplitude/actions/create-cohort
Usage : Consulter l’activité d’un utilisateur
Exemple de demande : Je veux voir les événements de user@exemple.com pour vérifier son parcours dans l’application.
Résultat attendu : Les événements du profil trouvé sont renvoyés, avec les champs demandés si besoin.
À préciser : Identifiant utilisateur, Amplitude ID ou Device ID ; Nombre d’événements souhaité ; Champs complémentaires éventuels
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/amplitude/actions/search-users ; https://pipedream.com/apps/amplitude/actions/get-user-activity
Usage : Analyser un entonnoir achat
Exemple de demande : Je veux mesurer le passage de Inscription à Achat sur la période du 6 juillet 2024 au 5 août 2024.
Résultat attendu : Un calcul de conversion par étape est renvoyé pour les événements fournis.
À préciser : Définition de chaque étape ; Date de début ; Date de fin
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/amplitude/actions/get-funnel-analysis
Limites propres au service : La création de cohorte ne couvre que les cohortes statiques via l’API documentée ici. Le téléchargement de cohorte suit un enchaînement en trois étapes : demande, statut, téléchargement. L’activité utilisateur nécessite d’abord la résolution de l’utilisateur en Amplitude ID quand l’identifiant fourni n’est pas l’ID numérique. Les lectures d’analyse renvoient des résultats calculés à partir des données existantes, pas des modifications de données.
Vocabulaire français : Créer une cohorte — Crée une cohorte statique à partir d’une liste explicite d’identifiants d’utilisateurs ou d’IDs Amplitude. (https://pipedream.com/apps/amplitude/actions/create-cohort)
Vocabulaire français : Télécharger un fichier de cohorte — Télécharge la liste des membres d’une exportation de cohorte terminée. (https://pipedream.com/apps/amplitude/actions/download-cohort-file)
Vocabulaire français : Obtenir l’état du téléchargement de cohorte — Vérifie si une demande de téléchargement de cohorte est terminée. (https://pipedream.com/apps/amplitude/actions/get-cohort-download-status)
Vocabulaire français : Obtenir l’analyse de segmentation d’événement — Lit les volumes et métriques d’un ou plusieurs événements sur une période donnée. (https://pipedream.com/apps/amplitude/actions/get-event-segmentation)
Vocabulaire français : Obtenir l’analyse d’entonnoir — Lit les taux de conversion entre plusieurs étapes d’un entonnoir sur une période donnée. (https://pipedream.com/apps/amplitude/actions/get-funnel-analysis)
Vocabulaire français : Obtenir l’analyse de rétention — Lit la rétention entre un événement de départ et un événement de retour sur une période donnée. (https://pipedream.com/apps/amplitude/actions/get-retention-analysis)
Vocabulaire français : Obtenir l’activité utilisateur — Récupère le flux d’événements d’un utilisateur à partir de son Amplitude ID numérique. (https://pipedream.com/apps/amplitude/actions/get-user-activity)
Vocabulaire français : Lister les cohortes — Retourne la liste des cohortes du projet, avec leurs identifiants et leurs métadonnées de base. (https://pipedream.com/apps/amplitude/actions/list-cohorts)
Vocabulaire français : Demander le téléchargement d’une cohorte — Lance une demande d’export des membres d’une cohorte comportementale. (https://pipedream.com/apps/amplitude/actions/request-cohort-download)
Vocabulaire français : Rechercher des utilisateurs — Retrouve un utilisateur à partir d’un ID Amplitude, d’un Device ID ou d’un User ID. (https://pipedream.com/apps/amplitude/actions/search-users)
Vocabulaire français : Envoyer des données d’événement — Enregistre un événement analytique pour un utilisateur ou un appareil via l’API HTTP V2. (https://pipedream.com/apps/amplitude/actions/send-event-data)
- action : Create Cohort — Create a static cohort in Amplitude from an explicit list of user or Amplitude IDs via POST /api/3/cohorts/upload (the only REST-documented cohort creation endpoint; behavioral/dynamic cohorts cannot be created via REST). Use List Cohorts to find an existing cohort ID if updating. Example: call with cohortName="Power Users Q3" , appId=849238 , idType="BY_USER_ID" , ids=["user@example.com"] , owner="admin@example.com" -> returns {cohortId: "abc123"} . See the documentation. (https://pipedream.com/apps/amplitude/actions/create-cohort)
- action : Download Cohort File — Download a completed cohort export's member list (step 3 of 3: request -> status -> download). Call Request Cohort Download then Get Cohort Download Status first, and only call this once status is JOB COMPLETED — calling it earlier will fail. Returns one record per member ( amplitude_id / user_id , plus any requested user properties) — not the cohort's own metadata (name, size, definition); use List Cohorts for that. Example: call with requestId="req_456" -> returns {requestId: "req_456", memberCount: 4200, returnedCount: 4200, truncated: false, members: [{amplitude_id: "123456789", user_id: "user@example.com"}, ...]} . See the documentation. (https://pipedream.com/apps/amplitude/actions/download-cohort-file)
- action : Get Cohort Download Status — Check whether a cohort download job has finished (step 2 of 3: request -> status -> download). Call Request Cohort Download first to get a requestId . This action polls internally for up to ~35 seconds before returning, since Amplitude's export jobs commonly take 30-60+ seconds regardless of cohort size. If the returned async_status is still JOB INPROGRESS , call this action again with the same request ID (it may take a few calls) — do not call Download Cohort File until async_status is JOB COMPLETED . Example: call with requestId="req_456" -> returns {request_id: "req_456", cohort_id: "abc123", async_status: "JOB COMPLETED"} . See the documentation. (https://pipedream.com/apps/amplitude/actions/get-cohort-download-status)
- action : Get Event Segmentation — Query event segmentation data (counts, uniques, and other metrics) for one or more events over a date range from the Amplitude Dashboard REST API. Use this to analyze how an event trends over time, optionally broken down by user properties. Example: call with event={"event_type":"Purchase"} , startDate="20240706" , endDate="20240805" , metric="uniques" -> returns {data: {xValues: ["2024-07-06", ...], series: [[42, 51, ...]]}} (one value per day per requested series). See the documentation. (https://pipedream.com/apps/amplitude/actions/get-event-segmentation)
- action : Get Funnel Analysis — Compute conversion rates across an ordered (or unordered/sequential) set of funnel steps over a date range from the Amplitude Dashboard REST API. Provide one event definition per funnel step. Example: call with events=["{\"event_type\":\"Sign Up\"}","{\"event_type\":\"Purchase\"}"] , startDate="20240706" , endDate="20240805" -> returns {data: [{stepByStep: [...], cumulative: [...], eventCount: 4200}, ...]} (one entry per step). See the documentation. (https://pipedream.com/apps/amplitude/actions/get-funnel-analysis)
- action : Get Retention Analysis — Compute retention (return rate) between a start event and a return event over a date range from the Amplitude Dashboard REST API. Example: call with startEvent={"event_type":"_new"} , returnEvent={"event_type":"_active"} , startDate="20240706" , endDate="20240805" -> returns {data: {series: [[...retention counts per interval...]], seriesLabels: [...]}} . See the documentation. (https://pipedream.com/apps/amplitude/actions/get-retention-analysis)
- action : Get User Activity — Fetch the event stream for a single user by their numeric Amplitude ID from the Amplitude Dashboard REST API. Each returned event defaults to just event_type and event_time; pass fields to also get e.g. event_properties , user_properties , uuid , session_id , amplitude_id , device_id (event objects can carry many properties, so these stay opt-in). Amplitude's API caps each request at 1000 events with no cursor; this tool pages offset forward automatically to collect up to limit events (set it above 1000, up to 5000, to fetch more than one page). Use Search Users first to resolve the Amplitude ID. Example: call with user=12345678 , limit=50 -> returns {events: [{event_type: "Purchase", event_time: "2024-08-05 14:22:10"}, ...], userData: {...}, truncated: false} ( truncated: true means more events likely exist beyond what was returned — raise limit / offset to fetch further). See the documentation. (https://pipedream.com/apps/amplitude/actions/get-user-activity)
- action : List Cohorts — List all behavioral cohorts in the Amplitude project. Returns a cohorts array; each entry defaults to id, name, size, lastMod, appId. Pass fields to get more, e.g. description , published , archived , or the large definition (the cohort's filter logic) / owners / viewers (email arrays). Use this to discover valid cohort IDs for Request Cohort Download (step 1 of 3, followed by Get Cohort Download Status and Download Cohort File , to fetch a cohort's member list). Example: call with no parameters -> returns {cohorts: [{id: "abc123", name: "Power Users Q3", size: 4200, lastMod: 1722873600000, appId: 849238}, ...]} . See the documentation. (https://pipedream.com/apps/amplitude/actions/list-cohorts)
- action : Request Cohort Download — Start a behavioral cohort download job (step 1 of 3: request -> status -> download, per Amplitude's Behavioral Cohorts Download API). Returns a request_id — pass it to Get Cohort Download Status to poll until the job completes, then to Download Cohort File to fetch the member list. Use List Cohorts first to discover valid cohort IDs. Example: call with cohortId="abc123" -> returns {request_id: "req_456", cohort_id: "abc123"} . See the documentation. (https://pipedream.com/apps/amplitude/actions/request-cohort-download)
- action : Search Users — Look up Amplitude users by Amplitude ID, Device ID, User ID, or a User ID prefix. Use this before Get User Activity to resolve a user's amplitude_id . Example: call with user="user@example.com" -> returns {matches: [{amplitude_id: 12345678, user_id: "user@example.com"}], type: "user_id"} . See the documentation. (https://pipedream.com/apps/amplitude/actions/search-users)
- action : Send Event Data — Record a single analytics event for a user or device via Amplitude's HTTP V2 API. Use this to send product-usage events (page views, feature use, purchases) as they happen, rather than the read-only Dashboard REST actions in this app (e.g. Get Event Segmentation , Get Retention Analysis ), which only read existing data back. Identify the user with userId and/or deviceId — Amplitude requires at least one. Example: call with userId="user_123" , eventType="Purchase" , eventProperties={"item":"Pro Plan","price":29.99} -> returns {code: 200, events_ingested: 1, payload_size_bytes: 148, server_upload_time: 1722873600000} . See the documentation (https://pipedream.com/apps/amplitude/actions/send-event-data)