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’export de données
Une liste complète des événements et des propriétés d’événements qui peuvent ê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énements 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 les données d’événements 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 comprenant les événements Braze directement liés à l’envoi de messages, et les événements de comportement client, incluant 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 réguliers 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 par [Custom event property] et [Purchase property], respectivement.
Braze Currents applique le préfixe [Appboy] lors de l’export des événements vers Amplitude. Ce libellé fait référence à l’ancien nom de produit de Braze. Il s’agit d’un comportement attendu et cela n’indique pas un problème de SDK ou d’intégration.
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 de support 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, localisez votre clé API d’export 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 Braze Current
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’export 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 « Invalid API key » 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 enregistrer plus de 30 événements/seconde ou 500 000 événements/jour dans des circonstances normales, et ce type de schéma d’événements 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 enregistre les événements à un rythme normal, conformément aux instructions de notre 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.