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 requise | 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é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 les 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 devrez synchroniser votre identifiant d’appareil Amplitude avec l’identifiant d’appareil Braze dans le SDK. Par exemple :
amplitude.setDeviceId(Appboy.getInstance(context).getDeviceId();)
Vous pouvez exporter deux types d’événements vers Amplitude : les événements d’engagement lié aux messages, composés des événements Braze directement liés à l’envoi de messages, et les événements de comportement client, incluant d’autres activités liées à l’application ou au site web telles que les sessions, les événements personnalisés et les achats suivis via la plateforme. Tous les événements standard sont préfixés par [Appboy], et tous les événements personnalisés sont préfixés par [Appboy] [Custom Event]. Les propriétés d’événement personnalisé et d’achat sont respectivement préfixées par [Custom event property] et [Purchase property].
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 lié au SDK ou à l’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 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, 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 5 jours, les événements du connecteur seront abandonné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, la clé API d’export Amplitude et la 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 dispose d’une limite de débit de 30 événements/seconde par appareil et d’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, il est possible que vous constatiez un retard dans l’affichage des événements de tous les appareils 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 fréquence d’événements ne devrait se produire qu’en raison d’une intégration mal configurée. Pour éviter ce type de retard, assurez-vous que votre intégration SDK enregistre les événements à un rythme normal, comme 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.