Interrogez les données d'analyse Amazon Pinpoint pour les messages transactionnels

Outre les pages d'analyse de la console Amazon Pinpoint, vous pouvez utiliser Amazon Pinpoint APIs Analytics pour interroger les données d'analyse relatives à un sous-ensemble de mesures standard qui fournissent un aperçu des tendances en matière de diffusion et d'engagement des messages transactionnels envoyés dans le cadre d'un projet.

Chacune de ces métriques est une valeur mesurable, également appelée indicateur de performance clé (KPI), qui peut vous aider à surveiller et à évaluer les performances des messages transactionnels. Par exemple, vous pouvez utiliser une métrique pour savoir combien d'e-mails ou de SMS transactionnels vous avez envoyés, ou combien de ces messages ont été remis aux destinataires. Amazon Pinpoint collecte et regroupe automatiquement ces données pour tous les e-mails et SMS transactionnels que vous envoyez dans le cadre d'un projet. Il stocke les données pendant 90 jours.

Si vous utilisez Amazon Pinpoint Analytics APIs pour interroger des données, vous pouvez choisir différentes options qui définissent l'étendue, les données, le regroupement et les filtres de votre requête. Pour ce faire, utilisez les paramètres qui spécifient le projet et la métrique que vous souhaitez interroger, en plus des filtres basés sur la date que vous souhaitez appliquer.

Cette rubrique explique et fournit des exemples de sélection de ces options et d'interrogation des données de messagerie transactionnelle pour un projet.

Prérequis

Avant d'interroger des données d'analyse pour les messages transactionnels, il est utile de recueillir les informations suivantes, que vous utilisez pour définir votre requête :

• ID du projet : identifiant unique du projet à partir duquel les messages ont été envoyés. Dans l'API Amazon Pinpoint, cette valeur est stockée dans la propriété application-id. Sur la console Amazon Pinpoint, cette valeur s'affiche sous la forme de l'ID de projet sur la page Tous les projets.

• Plage de dates : le cas échéant, premières et dernières date et heure de la plage de dates auxquelles interroger les données. Notez que les plages de dates sont inclusives et doivent être limitées à 31 jours calendaires au plus. En outre, elles doivent commencer dans moins de 90 jours à compter du jour actuel. Si vous ne spécifiez pas de plage de dates, Amazon Pinpoint interroge automatiquement les données des 31 jours civils précédents.

• Métrique : nom de la métrique à interroger, plus précisément la valeur kpi-name de la métrique. Pour obtenir la liste complète des métriques prises en charge et la valeur kpi-name de chacune d'elles, reportez-vous à la section Mesures standard pour les projets, les campagnes et les parcours.

Permet également de déterminer si vous souhaitez regrouper les données selon un champ pertinent. Si c'est le cas, vous pouvez simplifier votre analyse et vos rapports en choisissant une métrique conçue pour regrouper automatiquement les données. Par exemple, Amazon Pinpoint fournit plusieurs métriques standard qui indiquent le nombre de messages SMS transactionnels qui ont été remis aux destinataires. L'une de ces métriques regroupe automatiquement les données par date (txn-sms-delivered-grouped-by-date). Une autre métrique regroupe automatiquement les données par pays ou région (txn-sms-delivered-grouped-by-country). Une troisième métrique renvoie simplement une valeur unique : le nombre de messages qui ont été remis aux destinataires (txn-sms-delivered). Si vous ne trouvez pas de métrique standard qui regroupe les données de la manière souhaitée, vous pouvez développer une série de requêtes qui renvoient les données souhaitées. Vous pouvez ensuite décomposer ou combiner manuellement les résultats de la requête en groupes personnalisés que vous concevez.

Enfin, il est important de vérifier que vous êtes autorisé à accéder aux données que vous souhaitez interroger. Pour de plus amples informations, veuillez consulter Politiques IAM pour l'interrogation de données analytiques Amazon Pinpoint.