Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Outre les pages d'analyse de la console Amazon Pinpoint, vous pouvez utiliser Amazon Pinpoint APIs Analytics pour interroger les données d'analyse d'un sous-ensemble de mesures standard qui fournissent des informations sur les tendances liées à l'engagement des utilisateurs, à la portée des campagnes, etc. Ces indicateurs, également appelés indicateurs de performance clés (KPIs), sont des valeurs mesurables qui peuvent vous aider à surveiller et à évaluer les performances de vos projets, campagnes et parcours.
Si vous utilisez le APIs pour interroger des données d'analyse, vous pouvez analyser les données à l'aide de l'outil de reporting de votre choix, sans avoir à vous connecter à la console Amazon Pinpoint ou à analyser les données d'événements brutes provenant de sources telles que les flux Amazon Kinesis. Par exemple, vous pouvez créer un tableau de bord personnalisé qui affiche les résultats hebdomadaires des campagnes ou fournit des analyses approfondies des taux de diffusion de vos campagnes.
Vous pouvez interroger les données à l'aide de l'API REST Amazon Pinpoint, du AWS Command Line Interface (AWS CLI) ou d'un AWS SDK. Pour interroger les données, vous envoyez une demande à l'API Amazon Pinpoint et utilisez les paramètres pris en charge pour spécifier les données que vous voulez et les filtres que vous souhaitez appliquer. Une fois que vous avez soumis votre requête, Amazon Pinpoint renvoie les résultats de la requête dans une réponse JSON. Vous pouvez alors transmettre les résultats à un autre service ou une autre application pour une analyse plus approfondie, ou encore à des fins de stockage ou de génération de rapports.
Amazon Pinpoint collecte et regroupe automatiquement les données pour tous les types de métriques pris en charge ainsi que pour l'ensemble de vos projets, campagnes et parcours. En outre, les données sont mises à jour de façon continue, ce qui se traduit par une période de latence des données, limitée à deux heures environ. Notez toutefois qu'il peut y avoir une latence supplémentaire des données pour certaines métriques. En effet, les données de certaines métriques sont basées sur des informations reçues de la part des fournisseurs de messagerie des destinataires. Certains fournisseurs nous envoient ces informations immédiatement, tandis que d’autres les envoient plus rarement.
Amazon Pinpoint stocke les données pendant 90 jours. Pour stocker les données pendant plus de 90 jours ou pour accéder aux données analytiques brutes en temps réel, vous pouvez configurer un projet Amazon Pinpoint afin de diffuser les données d'événements vers Amazon Kinesis Data Streams ou Amazon Data Firehose. Pour plus d'informations sur la configuration des flux d'événements, consultez Diffusez les données d'événements des applications via Kinesis et Firehose à l'aide d'Amazon Pinpoint.
Composants et paramètres de requête pour les métriques dans Amazon Pinpoint
Pour interroger les données d'une métrique, vous envoyez une demande get à la ressource de métrique appropriée de l'API Amazon Pinpoint. Dans votre demande, vous définissez votre requête en utilisant les paramètres pris en charge pour les composants de requête suivants :
-
Projet : spécifiez un projet en fournissant l'ID du projet comme valeur du paramètre
application-id. Ce paramètre est requis pour toutes les métriques. -
Campagne : spécifiez une campagne en fournissant l'ID de campagne comme valeur du paramètre
campaign-id. Ce paramètre n'est requis que pour les métriques de campagne. -
Parcours : spécifiez un parcours en fournissant l'ID du parcours en tant que valeur du paramètre
journey-id. Ce paramètre est obligatoire uniquement pour les métriques d'engagement et d'exécution du parcours, ainsi que pour les mesures d'exécution de l'activité du parcours. -
Activité du parcours : spécifiez une activité du parcours en fournissant l'ID d'activité du parcours en tant que valeur du paramètre
journey-activity-id. Ce paramètre est obligatoire uniquement pour les métriques d'exécution de l'activité du parcours. -
Plage de dates : pour filtrer éventuellement les données par plage de dates, indiquez la première et la dernière date et heure de la plage de dates à l'aide des paramètres d'heure de début et de fin pris en charge. Les valeurs doivent être au format ISO 8601 étendu et utiliser le temps universel coordonné (UTC) : par exemple,
2019-07-19T20:00:00Zpour 20h00 UTC le 19 juillet 2019.Notez que les plages de dates sont inclusives et doivent être limitées à 31 jours calendaires au plus. En outre, les premières date et heure doivent être inférieures à 90 jours à compter du jour actuel. Si vous ne spécifiez pas de plage de dates, Amazon Pinpoint renvoie les données des 31 jours civils précédents. Les paramètres de plage de dates sont pris en charge par toutes les métriques, à l'exception des métriques d'exécution du parcours et des mesures d'exécution de l'activité du parcours.
-
Métrique : spécifiez la métrique en fournissant son nom comme valeur du paramètre
kpi-name. Cette valeur décrit la métrique associée et se compose de deux termes ou plus, composés de caractères alphanumériques minuscules, séparés par un trait d'union. Par exemple,email-open-rateetsuccessful-delivery-rate. Ce paramètre est obligatoire uniquement pour toutes les métriques, à l'exception des métriques d'exécution du parcours et des mesures d'exécution de l'activité du parcours. Pour obtenir la liste complète des métriques prises en charge et la valeurkpi-nameà utiliser pour chacune d'elles, consultez Mesures standard pour les projets, les campagnes et les parcours.
Une fois que vous avez envoyé votre requête, Amazon Pinpoint renvoie les résultats de la requête dans une réponse JSON. Dans la réponse, la structure des résultats varie en fonction de la métrique que vous avez interrogée.
Certaines métriques ne fournissent qu'une seule valeur : par exemple, le nombre de messages envoyés par une campagne. D'autres métriques fournissent plusieurs valeurs et ces valeurs sont généralement regroupées selon un champ pertinent : par exemple, le nombre de messages remis par chaque exécution d'une campagne, regroupés par exécution de campagne. Si une métrique fournit et regroupe plusieurs valeurs, la réponse JSON inclut un champ qui indique celui utilisé pour regrouper les données. Pour en savoir plus sur la structure des résultats de requête, reportez-vous à la section Utiliser les résultats des requêtes JSON.
