Amplitude pour Currents
Amplitude est une plateforme d’analyse de produits et d’aide à la décision.
L’intégration bidirectionnelle entre Braze et Amplitude vous permet de synchroniser vos cohortes Amplitude, traits d’utilisateurs et événements dans Braze, ainsi que d’exploiter Braze Currents pour exporter vos événements Braze vers Amplitude afin de réaliser des analyses plus approfondies de vos données produit et marketing.
Conditions préalables
| Condition | Description |
|---|---|
| Compte Amplitude | Un compte Amplitude est nécessaire pour bénéficier de ce partenariat. |
| Currents | Pour pouvoir exporter des données dans Amplitude, vous devez avoir configuré Braze Currents pour votre compte. |
Intégration de l’exportation des données
Vous trouverez une liste complète des événements et propriétés d’événement pouvant être exportés de Braze vers Amplitude dans les sections suivantes. Tous les événements envoyés à Amplitude contiendront le paramètre external_user_id de l’utilisateur comme ID d’utilisateur Amplitude. Les propriétés d’événement propres à Braze seront envoyées sous la clé event_properties dans les données transmises à Amplitude.
Pour utiliser cette fonctionnalité, votre ID d’utilisateur Amplitude doit correspondre à l’ID externe de Braze.
Braze n’enverra des données d’événement que pour les utilisateurs dont l’external_user_id est défini ou pour les utilisateurs anonymes dont le device_id est défini. Pour les utilisateurs anonymes, vous devez synchroniser votre ID d’appareil Amplitude avec l’ID d’appareil Braze dans le SDK. Par exemple :
1
amplitude.setDeviceId(Appboy.getInstance(context).getDeviceId();)
Vous pouvez exporter deux types d’événements vers Amplitude : les événements d’engagement des messages, constitués des événements Braze directement liés à l’envoi de messages, et les événements de comportement des clients, incluant d’autres activités de l’application ou du site web telles que les sessions, les événements personnalisés et les achats suivis via la plateforme. Tous les événements réguliers sont précédés du préfixe [Appboy], et tous les événements personnalisés sont précédés du préfixe [Appboy] [Custom Event]. Les propriétés d’événements personnalisés et d’achats sont précédées des préfixes [Custom event property] et [Purchase property], respectivement.
Toutes les cohortes nommées et importées dans Braze seront préfixées par [Amplitude] et suffixées par leur cohort_id. Cela signifie qu’une cohorte nommée « TEST_COHORT » avec le cohort_id « abcd1234 » sera intitulée [Amplitude] TEST_COHORT: abcd1234 dans les filtres de Braze.
Contactez votre gestionnaire de compte ou ouvrez un ticket d’assistance si vous avez besoin d’accéder à des droits d’événements supplémentaires.
Étape 1 : Configurer l’intégration Amplitude dans Braze
Dans Amplitude, recherchez votre clé API d’exportation Amplitude.
Maintenez votre clé API Amplitude à jour. Si les informations d’identification de votre connecteur expirent, le connecteur cessera d’envoyer des événements. Si cette situation persiste pendant plus de 48 heures, les événements du connecteur seront abandonnés et les données seront définitivement perdues.
Étape 2 : Créer un flux Currents Braze
Dans Braze, naviguez vers Currents > + Create Current > Create Amplitude Export. Fournissez un nom d’intégration, un e-mail de contact, une clé API d’exportation Amplitude et une région Amplitude dans les champs répertoriés. Ensuite, sélectionnez les événements que vous souhaitez suivre ; une liste des événements disponibles est fournie. Enfin, cliquez sur Launch Current.
Les événements envoyés de Braze Currents vers Amplitude sont comptabilisés dans votre quota de volume d’événements Amplitude.
Consultez la documentation sur l’intégration d’Amplitude pour en savoir plus.
Limites de débit
Currents se connecte à l’API HTTP d’Amplitude, qui a une limite de débit de 30 événements/seconde par appareil et une limite non documentée de 500 000 événements/jour par appareil. Si ces seuils sont dépassés, Amplitude limitera le nombre d’événements enregistrés via Currents. Si un appareil de votre intégration dépasse cette limite de débit, il se peut que les événements de tous les appareils apparaissent avec un certain retard dans Amplitude.
Les appareils ne devraient pas signaler plus de 30 événements par seconde ou 500 000 événements par jour dans des circonstances normales, et ce schéma ne devrait se produire qu’en raison d’une intégration mal configurée. Pour éviter ce type de retard, veillez à ce que votre intégration SDK signale les événements à un rythme normal, comme indiqué dans nos instructions d’intégration SDK, et évitez d’exécuter des tests automatisés qui génèrent de nombreux événements pour un seul appareil.
Événements Currents pris en charge
Braze prend en charge l’exportation des événements suivants vers Amplitude :
Pour la structure du payload de chaque événement, sélectionnez l’onglet Amplitude dans le glossaire des événements d’engagement des messages et le glossaire des événements de comportement des clients.