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.
Prérequis
| Condition | Description |
|---|---|
| Compte Amplitude | Un compte Amplitude est nécessaire pour tirer parti de ce partenariat. |
| Currents | Pour exporter des données vers Amplitude, vous devez avoir configuré Braze Currents pour votre compte. |
Intégration d’exportation de données
Une liste complète des événements et des propriétés d’événement pouvant être exportés de Braze vers Amplitude se trouve dans les sections suivantes. Tous les événements envoyés à Amplitude incluront l’external_user_id de l’utilisateur comme identifiant utilisateur Amplitude. Les propriétés d’événement spécifiques à Braze seront envoyées sous la clé event_properties dans les données transmises à Amplitude.
Pour utiliser cette fonctionnalité, votre identifiant utilisateur Amplitude doit correspondre à l’ID externe Braze.
Braze n’enverra des données d’événement que pour les utilisateurs dont l’external_user_id est défini ou les utilisateurs anonymes dont le device_id est défini. Pour les utilisateurs anonymes, vous devrez synchroniser votre identifiant d’appareil Amplitude avec l’identifiant 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 liés aux messages, qui comprennent les événements Braze directement liés à l’envoi de messages, et les événements de comportement client, qui incluent d’autres activités de l’application ou du site web telles que les sessions, les custom events et les achats suivis via la plateforme. Tous les événements standard sont préfixés par [Appboy], et tous les custom events sont préfixés par [Appboy] [Custom Event]. Les propriétés des custom events et des événements d’achat sont préfixées respectivement par [Custom event property] et [Purchase property].
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 Braze.
Contactez votre gestionnaire de compte ou ouvrez un ticket d’assistance si vous avez besoin d’accéder à des droits d’événement supplémentaires.
Étape 1 : Configurer l’intégration Amplitude dans Braze
Dans Amplitude, localisez votre clé API d’exportation Amplitude.
Maintenez votre clé API Amplitude à jour. Si les identifiants de votre connecteur expirent, le connecteur cessera d’envoyer des événements. Si cela persiste pendant plus de 48 heures, les événements du connecteur seront supprimés et les données seront définitivement perdues.
Étape 2 : Créer un Current Braze
Dans Braze, accédez à Currents > + Create Current > Create Amplitude Export. Fournissez un nom d’intégration, une adresse e-mail de contact, une clé API d’exportation Amplitude et une région Amplitude dans les champs indiqué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 seront comptabilisés dans votre quota de volume d’événements Amplitude.
Si vous recevez une erreur « Clé API invalide » lors du collage de votre clé API Amplitude, essayez de saisir la clé manuellement. Certains navigateurs peuvent ajouter des caractères masqués lors du copier-coller, ce qui peut provoquer des erreurs de validation.
Pour plus d’informations, consultez la documentation d’Amplitude sur l’intégration Appboy Amplitude.
Limites de débit
Currents se connecte à l’API HTTP d’Amplitude, qui impose 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 les événements enregistrés via Currents. Si un appareil de votre intégration dépasse cette limite de débit, vous pourriez constater un délai avant que les événements de tous les appareils n’apparaissent dans Amplitude.
Les appareils ne devraient pas signaler plus de 30 événements/seconde ou 500 000 événements/jour dans des circonstances normales, et ce type de comportement ne devrait se produire qu’en raison d’une intégration mal configurée. Pour éviter ce type de délai, assurez-vous que votre intégration SDK signale les événements à un rythme normal, tel que spécifié dans nos instructions d’intégration SDK, et évitez d’exécuter des tests automatisés qui génèrent un grand nombre d’é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 lié aux messages et le glossaire des événements de comportement client.