**Avis de fin de support :** le 30 octobre 2026, le support d'Amazon Pinpoint AWS prendra fin. Après le 30 octobre 2026, vous ne pourrez plus accéder à la console Amazon Pinpoint ni aux ressources Amazon Pinpoint (points de terminaison, segments, campagnes, parcours et analytique). Pour plus d’informations, consultez [Fin de la prise en charge d’Amazon Pinpoint](https://docs.aws.amazon.com/console/pinpoint/migration-guide). **Remarque :** en ce qui APIs concerne les SMS, la voix, le push mobile, l'OTP et la validation des numéros de téléphone ne sont pas concernés par cette modification et sont pris en charge par AWS la messagerie utilisateur final.
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.
# Interrogez les données d'analyse Amazon Pinpoint
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](event-streams.md).
## 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:00Z` pour 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-rate` et `successful-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 valeur `kpi-name` à utiliser pour chacune d'elles, consultez [Mesures standard pour les projets, les campagnes et les parcours](analytics-standard-metrics.md).
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](analytics-query-results.md).
# Politiques IAM pour l'interrogation de données analytiques Amazon Pinpoint
À l'aide de l'API Amazon Pinpoint, vous pouvez interroger les données d'analyse pour un sous-ensemble de mesures standard, également appelées *indicateurs de performance clés (KPIs)* qui s'appliquent aux projets, campagnes et parcours Amazon Pinpoint. Ces métriques peuvent vous aider à surveiller et à évaluer les performances des projets, campagnes et parcours.
Pour gérer l'accès à ces données, vous pouvez créer des politiques Gestion des identités et des accès AWS (IAM) qui définissent les autorisations pour les rôles IAM ou les utilisateurs autorisés à accéder aux données. Pour prendre en charge le contrôle granulaire de l'accès à ces données, Amazon Pinpoint fournit plusieurs actions distinctes que vous pouvez spécifier dans les politiques IAM. Il existe une action distincte pour afficher les données analytiques sur la console Amazon Pinpoint (`mobiletargeting:GetReports`), et il existe d'autres actions pour accéder aux données analytiques par programmation à l'aide de l'API Amazon Pinpoint.
Pour créer des politiques IAM qui gèrent l'accès aux données d'analyse, vous pouvez utiliser l' AWS Management Console API AWS CLI, ou l'API IAM. Notez que l'onglet **Éditeur visuel** de la AWS Management Console n'inclut pas actuellement les actions permettant d'afficher ou d'interroger les données analytiques Amazon Pinpoint. Toutefois, vous pouvez ajouter manuellement les actions nécessaires aux stratégies IAM à l'aide de l'onglet **JSON** de la console.
Par exemple, la politique suivante autorise l'accès programmatique à toutes les données d'analyse pour tous vos projets, campagnes et voyages dans toutes les AWS régions :
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "QueryAllAnalytics",
"Effect": "Allow",
"Action": [
"mobiletargeting:GetApplicationDateRangeKpi",
"mobiletargeting:GetCampaignDateRangeKpi",
"mobiletargeting:GetJourneyDateRangeKpi",
"mobiletargeting:GetJourneyExecutionMetrics",
"mobiletargeting:GetJourneyExecutionActivityMetrics"
],
"Resource": [
"arn:aws:mobiletargeting:*:111122223333:apps/*/kpis/*",
"arn:aws:mobiletargeting:*:111122223333:apps/*/campaigns/*/kpis/*",
"arn:aws:mobiletargeting:*:111122223333:apps/*/journeys/*/kpis/*",
"arn:aws:mobiletargeting:*:111122223333:apps/*/journeys/*/execution-metrics",
"arn:aws:mobiletargeting:*:111122223333:apps/*/journeys/*/activities/*/execution-metrics"
]
}
]
}
```
------
Où se *accountId* trouve votre identifiant de AWS compte ?
Cependant, une bonne pratique consiste à créer des stratégies qui suivent le principe du *moindre privilège*. En d'autres termes, vous devez créer des stratégies qui incluent uniquement les autorisations requises pour effectuer une tâche spécifique. Pour soutenir cette pratique et mettre en œuvre un contrôle plus précis, vous pouvez restreindre l'accès programmatique aux données analytiques uniquement pour un projet spécifique dans une AWS région spécifique, par exemple :
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "QueryProjectAnalytics",
"Effect": "Allow",
"Action": [
"mobiletargeting:GetApplicationDateRangeKpi",
"mobiletargeting:GetCampaignDateRangeKpi",
"mobiletargeting:GetJourneyDateRangeKpi",
"mobiletargeting:GetJourneyExecutionMetrics",
"mobiletargeting:GetJourneyExecutionActivityMetrics"
],
"Resource": [
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/kpis/*",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/campaigns/*/kpis/*",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/*/kpis/*",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/*/execution-metrics",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/*/activities/*/execution-metrics"
]
}
]
}
```
------
Où :
+ *region*est le nom de la AWS région qui héberge le projet.
+ *accountId*est votre identifiant de AWS compte.
+ *projectId*est l'identifiant du projet auquel vous souhaitez donner accès.
De même, l'exemple de stratégie suivant autorise l'accès par programmation aux données analytiques pour une campagne donnée uniquement :
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "QueryCampaignAnalytics",
"Effect": "Allow",
"Action": "mobiletargeting:GetCampaignDateRangeKpi",
"Resource": "arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/campaigns/campaignId/kpis/*"
}
]
}
```
------
Où :
+ *region*est le nom de la AWS région qui héberge le projet.
+ *accountId*est votre Compte AWS identifiant.
+ *projectId*est l'identifiant du projet associé à la campagne.
+ *campaignId*est l'identifiant de la campagne à laquelle vous souhaitez donner accès.
Et l'exemple de stratégie suivant permet l'accès programmatique à toutes les données d'analyse, les données d'engagement et d'exécution, pour un parcours particulier et les activités qui composent ce parcours :
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "QueryJourneyAnalytics",
"Effect": "Allow",
"Action": [
"mobiletargeting:GetJourneyDateRangeKpi",
"mobiletargeting:GetJourneyExecutionMetrics",
"mobiletargeting:GetJourneyExecutionActivityMetrics"
],
"Resource": [
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/journeyId/kpis/*",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/journeyId/execution-metrics",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/journeyId/activities/*/execution-metrics"
]
}
]
}
```
------
Où :
+ *region*est le nom de la AWS région qui héberge le projet.
+ *accountId*est votre identifiant de AWS compte.
+ *projectId*est l'identifiant du projet associé au voyage.
+ *journeyId*est l'identifiant du trajet auquel vous souhaitez donner accès.
Pour obtenir la liste complète des actions d'API Amazon Pinpoint que vous pouvez utiliser dans les politiques IAM, reportez-vous à la section [Actions Amazon Pinpoint pour les politiques IAM](permissions-actions.md). Pour plus d'informations sur la création et la gestion de politiques IAM, consultez le [Guide de l'utilisateur IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/).
# Mesures standard qui s'appliquent aux projets, campagnes et parcours Amazon Pinpoint
Vous pouvez utiliser Amazon Pinpoint Analytics APIs pour interroger les données d'analyse d'un sous-ensemble de métriques standard qui s'appliquent aux projets, campagnes et parcours Amazon Pinpoint. Ces indicateurs, également appelés *indicateurs de performance clés (KPIs)*, sont des valeurs mesurables qui peuvent vous aider à suivre et à évaluer les performances des projets, des campagnes et des parcours.
Amazon Pinpoint fournit un accès programmatique aux données analytiques pour plusieurs types de métriques standard :
+ **Métriques d'application** : ces métriques fournissent des informations sur les tendances pour les campagnes et les messages transactionnels associés à un projet, également appelé *application*. Par exemple, vous pouvez utiliser une métrique d'application pour voir le détail du nombre de messages de campagne ayant été ouverts par les destinataires pour chaque campagne associée à un projet.
+ **Métriques de campagne** : ces métriques fournissent des informations sur les performances de chaque campagne. Par exemple, vous pouvez utiliser une métrique de campagne pour consulter les données sur le nombre de points de terminaison auxquels un message de campagne a été envoyé ou le nombre de ces messages qui ont été remis aux points de terminaison ciblés.
+ **Métriques d'engagement du parcours** : ces métriques offrent un aperçu des performances des parcours individuels. Par exemple, vous pouvez utiliser une métrique d'engagement du parcours pour obtenir le détail du nombre de messages ouverts par les participants dans chaque activité d'un parcours.
+ **Métriques d'exécution des parcours** : ces métriques fournissent un aperçu des tendances de participation pour les différents parcours. Par exemple, vous pouvez utiliser une métrique d'exécution du parcours pour déterminer le nombre de participants commençant une activité.
+ **Métriques d'exécution des activités de parcours** : ces métriques fournissent un aperçu des tendances de participation aux activités individuelles d'un parcours. Par exemple, vous pouvez utiliser une métrique d'exécution du parcours pour déterminer le nombre de participants ayant commencé une activité et le nombre ayant terminé chaque chemin d'une activité.
Les rubriques de cette section répertorient et décrivent les mesures individuelles que vous pouvez interroger pour chaque type de métrique.
**Topics**
+ [Statistiques relatives aux applications Amazon Pinpoint pour les campagnes](application-metrics-campaigns.md)
+ [Statistiques de l'application Amazon Pinpoint pour les e-mails transactionnels](application-metrics-txn-email.md)
+ [Statistiques de l'application Amazon Pinpoint pour les SMS transactionnels](application-metrics-txn-sms.md)
+ [Statistiques de campagne Amazon Pinpoint](campaign-metrics.md)
+ [Indicateurs d'engagement liés au parcours Amazon Pinpoint](journey-metrics-engagement-email.md)
+ [Indicateurs d'exécution du parcours Amazon Pinpoint](journey-metrics-execution.md)
+ [Mesures d'exécution des activités liées au parcours Amazon Pinpoint](journey-metrics-activity-execution.md)
+ [Statistiques relatives au parcours et à l'exécution des campagnes Amazon Pinpoint](journey-run-metrics-activity-execution.md)
# Statistiques relatives aux applications Amazon Pinpoint pour les campagnes
Le tableau suivant répertorie et décrit les métriques d'application standard que vous pouvez interroger pour évaluer les tendances de toutes les campagnes associées à un projet Amazon Pinpoint. Afin d'interroger les données pour ces métriques, utilisez la ressource [Métriques d'application](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) de l'API Amazon Pinpoint. La colonne **kpi-name** de la table indique la valeur à utiliser pour le paramètre `kpi-name` de votre requête.
| Métrique | Kpi-name | Description |
| --- | --- | --- |
| Delivery rate (Taux de remise) | `successful-delivery-rate` | Pour toutes les campagnes associées à un projet, pourcentage de messages ayant été remis aux destinataires. Cette métrique est calculée de la façon suivante : le nombre de messages qui ont été envoyés par l'ensemble des campagnes pour un projet et remis aux destinataires, divisé par le nombre de messages qui ont été envoyés par l'ensemble de ces campagnes. |
| Delivery rate, grouped by date (Taux de remise, regroupement par date) | `successful-delivery-rate-grouped-by-date` | Pour toutes les campagnes associées à un projet, pourcentage de messages ayant été remis aux destinataires pour chaque jour de la plage de dates spécifiée. Cette métrique est calculée de la façon suivante : le nombre de messages envoyés par toutes les campagnes pour un projet et remis aux destinataires, divisé par le nombre de messages qui ont été envoyés par l'ensemble de ces campagnes, pour chaque jour de la plage de dates spécifiée. Les résultats de la requête pour cette métrique sont regroupés par jour calendaire, au format étendu ISO 8601. |
| Email open rate (Taux d’ouverture d’e-mail) | `email-open-rate` | Pour toutes les campagnes associées à un projet, pourcentage d'e-mails ayant été ouverts par les destinataires. Cette métrique est calculée de la façon suivante : le nombre d'e-mails envoyés par toutes les campagnes pour un projet et ouverts par les destinataires, divisé par le nombre d'e-mails qui ont été envoyés par l'ensemble de ces campagnes et remis aux destinataires. |
| Email open rate, grouped by campaign (Taux d'ouverture d'e-mail, regroupement par campagne) | `email-open-rate-grouped-by-campaign` | Pour chaque campagne associée à un projet, pourcentage d'e-mails ayant été ouverts par les destinataires. Cette métrique est calculée de la façon suivante : le nombre d'e-mails envoyés par une campagne et ouverts par les destinataires, divisé par le nombre d'e-mails qui ont été envoyés par la campagne et remis aux destinataires. Les résultats de la requête pour cette métrique sont regroupés par ID de campagne (`CampaignId`), une chaîne qui identifie de façon unique une campagne. |
| Endpoint deliveries (Remises au point de terminaison) | `unique-deliveries` | Pour toutes les campagnes associées à un projet, nombre de points de terminaison uniques auxquels les messages ont été envoyés. |
| Endpoint deliveries, grouped by campaign (Remises au point de terminaison, regroupement par campagne) | `unique-deliveries-grouped-by-campaign` | Pour chaque campagne associée à un projet, nombre de points de terminaison uniques auxquels les messages ont été envoyés. Les résultats de la requête pour cette métrique sont regroupés par ID de campagne (`CampaignId`), une chaîne qui identifie de façon unique une campagne. |
| Endpoint deliveries, grouped by date (Remises au point de terminaison, regroupement par date) | `unique-deliveries-grouped-by-date` | Pour toutes les campagnes associées à un projet, nombre de points de terminaison uniques auxquels les messages ont été envoyés, pour chaque jour de la plage de dates spécifiée. Les résultats de la requête pour cette métrique sont regroupés par jour calendaire, au format étendu ISO 8601. |
| Messages delivered, grouped by campaign (Messages remis, regroupement par campagne) | `successful-deliveries-grouped-by-campaign` | Pour chaque campagne associée à un projet, nombre de messages ayant été remis aux destinataires. Cette métrique est calculée de la façon suivante : le nombre de messages envoyés par une campagne, moins le nombre de messages ayant été envoyés par la campagne et qui n'ont pas été remis aux destinataires du fait d'un message d'erreur définitif. Les résultats de la requête pour cette métrique sont regroupés par ID de campagne (`CampaignId`), une chaîne qui identifie de façon unique une campagne. |
| Push open rate (Taux d’ouverture des notifications push) | `push-open-rate` | Pour toutes les campagnes associées à un projet, pourcentage de notifications push ayant été ouvertes par les destinataires. Cette métrique est calculée de la façon suivante : le nombre de notifications push envoyées par toutes les campagnes pour un projet et ouvertes par les destinataires, divisé par le nombre de notifications push qui ont été envoyées par l'ensemble de ces campagnes et remises aux destinataires. |
| Push open rate, grouped by campaign (Taux d'ouverture de notifications push, regroupement par campagne) | `push-open-rate-grouped-by-campaign` | Pour chaque campagne associée à un projet, pourcentage de notifications push ayant été ouvertes par les destinataires. Cette métrique est calculée de la façon suivante : le nombre de notifications push envoyées par une campagne et ouvertes par les destinataires, divisé par le nombre de notifications push qui ont été envoyées par la campagne remises aux destinataires. Les résultats de la requête pour cette métrique sont regroupés par ID de campagne (`CampaignId`), une chaîne qui identifie de façon unique une campagne. |
# Statistiques de l'application Amazon Pinpoint pour les e-mails transactionnels
Le tableau suivant répertorie et décrit les métriques d'application standard que vous pouvez interroger pour en savoir plus sur les tendances de tous les e-mails transactionnels associés à un projet Amazon Pinpoint. Afin d'interroger les données pour ces métriques, utilisez la ressource [Métriques d'application](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) de l'API Amazon Pinpoint. La colonne **kpi-name** de la table indique la valeur à utiliser pour le paramètre `kpi-name` de votre requête.
Notez que ces métriques ne fournissent pas de données sur les e-mails envoyés par les campagnes. Elles fournissent des données sur les e-mails transactionnels uniquement. Pour interroger les données pour les messages envoyés par une ou plusieurs campagnes, utilisez une [métrique de campagne](campaign-metrics.md) ou une [métrique d'application pour les campagnes](application-metrics-campaigns.md).
| Métrique | Kpi-name | Description |
| --- | --- | --- |
| Clics | `txn-emails-clicked` | Nombre de fois où les destinataires ont cliqué sur les liens dans les messages. Si un seul destinataire a cliqué sur plusieurs liens dans un message, ou s'il a cliqué sur le même lien plusieurs fois, chaque clic est inclus dans le total. |
| Clics, regroupés par date | `txn-emails-clicked-grouped-by-date` | Nombre de fois où les destinataires ont cliqué sur des liens dans les messages, pour chaque jour de la plage de dates spécifiée. Si un seul destinataire a cliqué sur plusieurs liens dans un message, ou s'il a cliqué sur le même lien plusieurs fois, chaque clic est inclus dans le total. Les résultats de la requête pour cette métrique sont regroupés par jour calendaire, au format étendu ISO 8601. |
| Complaint rate (Taux de réclamations) | `txn-emails-complaint-rate` | Pourcentage de messages signalés par les destinataires comme des e-mails non souhaités ou indésirables. Cette métrique est calculée en fonction du nombre de messages signalés par les destinataires comme étant des e-mails non souhaités ou indésirables, divisé par le nombre de messages envoyés. |
| Taux de réclamations, regroupé par date | `txn-emails-complaint-rate-grouped-by-date` | Pourcentage de messages signalés par les destinataires comme des e-mails non souhaités ou indésirables, pour chaque jour de la plage de dates spécifiée. Cette métrique est calculée en fonction du nombre de messages signalés par les destinataires comme étant des e-mails non souhaités ou indésirables divisé par le nombre de messages envoyés, pour chaque jour de la plage de dates spécifiée. Les résultats de la requête pour cette métrique sont regroupés par jour calendaire, au format étendu ISO 8601. |
| Réclamations | `txn-emails-with-complaints` | Nombre de messages signalés par les destinataires comme des e-mails non souhaités ou indésirables. |
| Réclamations, regroupées par date | `txn-emails-with-complaints-grouped-by-date` | Nombre de messages signalés par les destinataires comme des e-mails non souhaités ou indésirables, pour chaque jour de la plage de dates spécifiée.Les résultats de la requête pour cette métrique sont regroupés par jour calendaire, au format étendu ISO 8601. |
| Messages délivrés | `txn-emails-delivered` | Nombre de messages remis à leurs destinataires prévus. Cette métrique est calculée en fonction du nombre de messages envoyés moins le nombre de messages qui n'ont pas pu être remis en raison d'une non-remise temporaire ou définitive, ou parce qu'ils ont été rejetés. Un message est rejeté si Amazon Pinpoint détermine qu'il contient un logiciel malveillant. Amazon Pinpoint n'essaie pas d'envoyer des messages rejetés. |
| Livraisons, regroupées par date | `txn-emails-delivered-grouped-by-date` | Nombre de messages remis aux destinataires, pour chaque jour de la plage de dates spécifiée. Cette métrique est calculée en fonction du nombre de messages envoyés moins le nombre de messages qui n'ont pas pu être remis en raison d'une non-remise temporaire ou définitive, ou parce qu'ils ont été rejetés, pour chaque jour de la plage de dates spécifiée. Un message est rejeté si Amazon Pinpoint détermine qu'il contient un logiciel malveillant. Amazon Pinpoint n'essaie pas d'envoyer des messages rejetés. Les résultats de la requête pour cette métrique sont regroupés par jour calendaire, au format étendu ISO 8601. |
| Delivery rate (Taux de remise) | `txn-emails-delivery-rate` | Pourcentage de messages remis aux destinataires. Cette métrique est calculée en fonction du nombre de messages envoyés et remis aux destinataires, divisé par le nombre de messages envoyés. |
| Delivery rate, grouped by date (Taux de remise, regroupement par date) | `txn-emails-delivery-rate-grouped-by-date` | Pourcentage de messages remis aux destinataires, pour chaque jour de la plage de dates spécifiée. Cette métrique est calculée en fonction du nombre de messages envoyés et remis aux destinataires, divisé par le nombre de messages envoyés, pour chaque jour de la plage de dates spécifiée. Les résultats de la requête pour cette métrique sont regroupés par jour calendaire, au format étendu ISO 8601. |
| Messages d'erreur définitifs | `txn-emails-hard-bounced` | Nombre de messages qui n'ont pas pu être remis aux destinataires en raison d'une non-remise définitive. Un message d'erreur définitif est renvoyé si un problème persistant empêche la remise d'un message, par exemple, si l'adresse e-mail d'un destinataire n'existe pas. |
| Non-remises définitives, regroupées par date | `txn-emails-hard-bounced-grouped-by-date` | Nombre de messages qui n'ont pas pu être remis aux destinataires en raison d'une non-remise définitive, pour chaque jour de la plage de dates spécifiée. Un message d'erreur définitif est renvoyé si un problème persistant empêche la remise d'un message, par exemple, si l'adresse e-mail d'un destinataire n'existe pas. Les résultats de la requête pour cette métrique sont regroupés par jour calendaire, au format étendu ISO 8601. |
| Messages ouverts | `txn-emails-opened` | Nombre de messages ouverts par les destinataires. |
| Messages ouverts, regroupés par date | `txn-emails-opened-grouped-by-date` | Nombre de messages ouverts par les destinataires, pour chaque jour de la plage de dates spécifiée. Les résultats de la requête pour cette métrique sont regroupés par jour calendaire, au format étendu ISO 8601. |
| Envois | `txn-emails-sent` | Nombre de messages envoyés. |
| Envois, regroupés par date | `txn-emails-sent-grouped-by-date` | Nombre de messages envoyés, pour chaque jour de la plage de dates spécifiée. Les résultats de la requête pour cette métrique sont regroupés par jour calendaire, au format étendu ISO 8601. |
| Erreurs de remise temporaire | `txn-emails-soft-bounced` | Nombre de messages qui n'ont pas pu être remis aux destinataires en raison d'une erreur de remise temporaire. Un message d'erreur temporaire est renvoyé lorsqu'un problème temporaire empêche la remise d'un message, par exemple si la boîte de réception du destinataire est pleine ou si le serveur de réception est temporairement indisponible. |
| Erreurs de remise temporaire, regroupées par date | `txn-emails-soft-bounced-grouped-by-date` | Nombre de messages qui n'ont pas pu être remis aux destinataires en raison d'une erreur de remise temporaire, pour chaque jour de la plage de dates spécifiée. Un message d'erreur temporaire est renvoyé lorsqu'un problème temporaire empêche la remise d'un message, par exemple si la boîte de réception du destinataire est pleine ou si le serveur de réception est temporairement indisponible. Les résultats de la requête pour cette métrique sont regroupés par jour calendaire, au format étendu ISO 8601. |
| Événements de clics utilisateur uniques | `txn-emails-unique-clicks` | Nombre de destinataires uniques (points de terminaison) ayant cliqué sur des liens dans des messages. Contrairement à la métrique **Clicks (Clics)**, cette métrique indique le nombre de destinataires uniques ayant cliqué sur des liens, et non le nombre d'événements de clics qui se sont produits. Par exemple, si un seul destinataire a cliqué sur plusieurs liens dans le même message ou cliqué sur le même lien plusieurs fois, cette métrique ne rapporte qu'un seul événement de clic pour ce destinataire. |
| Événements de clics utilisateur uniques, regroupés par date | `txn-emails-unique-clicks-grouped-by-date` | Nombre de destinataires uniques (points de terminaison) ayant cliqué sur des liens dans des messages, pour chaque jour de la plage de dates spécifiée. Contrairement à la métrique **Clicks, grouped by date (Clics, regroupés par date)**, cette métrique indique le nombre de destinataires uniques ayant cliqué sur des liens, et non le nombre d'événements de clic qui se sont produits. Par exemple, si un seul destinataire a cliqué sur plusieurs liens dans le même message ou cliqué sur le même lien plusieurs fois, cette métrique ne rapporte qu'un seul événement de clic pour ce destinataire. Les résultats de la requête pour cette métrique sont regroupés par jour calendaire, au format étendu ISO 8601. |
| Événements d'ouverture utilisateur uniques | `txn-emails-unique-opens` | Nombre de destinataires uniques (points de terminaison) ayant ouvert des messages. Contrairement à la métrique **Ouvertures**, cette métrique indique le nombre de destinataires uniques ayant ouvert des messages, et non le nombre d'événements d'ouverture qui se sont produits. Par exemple, si un seul destinataire ouvre le même message plusieurs fois, cette métrique indique un seul événement d'ouverture pour ce destinataire. |
| Événements d'ouverture utilisateur uniques, regroupés par date | `txn-emails-unique-opens-grouped-by-date` | Nombre de destinataires uniques (points de terminaison) ayant ouvert des messages, pour chaque jour de la plage de dates spécifiée. Contrairement à la métrique **Ouvertures, regroupées par date**, cette métrique indique le nombre de destinataires uniques ayant ouvert des messages, et non le nombre d'événements d'ouverture qui se sont produits. Par exemple, si un seul destinataire ouvre le même message plusieurs fois, cette métrique indique un seul événement d'ouverture pour ce destinataire. Les résultats de la requête pour cette métrique sont regroupés par jour calendaire, au format étendu ISO 8601. |
# Statistiques de l'application Amazon Pinpoint pour les SMS transactionnels
Le tableau suivant répertorie et décrit les métriques d’application standard que vous pouvez interroger pour surveiller les tendances de tous les SMS transactionnels associés à un projet Amazon Pinpoint. Afin d'interroger les données pour ces métriques, utilisez la ressource [Métriques d'application](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) de l'API Amazon Pinpoint. La colonne **kpi-name** de la table indique la valeur à utiliser pour le paramètre `kpi-name` de votre requête.
Notez que ces métriques ne fournissent pas de données sur les SMS envoyés par les campagnes. Elles fournissent des données sur les SMS transactionnels uniquement. Pour interroger les données pour les messages envoyés par une ou plusieurs campagnes, utilisez une [métrique de campagne](campaign-metrics.md) ou une [métrique d'application pour les campagnes](application-metrics-campaigns.md).
| Métrique | Kpi-name | Description |
| --- | --- | --- |
| Prix moyen par message, regroupé par pays | `txn-sms-average-price-grouped-by-country` | Coût moyen de l'envoi de chaque message, pour chaque pays ou région où les messages ont été envoyés. Le prix est indiqué en millièmes d'un cent des États-Unis. Par exemple, si la valeur de cet attribut est 645, nous vous avons facturé 0,645 ¢ pour envoyer le message (645 / 1000 = 0,645 ¢ = 0,00645 \$1). Cette métrique est calculée comme le coût total de tous les messages envoyés aux destinataires dans chaque pays ou région, divisé par le nombre de messages envoyés aux destinataires dans chacun de ces pays et régions. Les résultats de la requête pour cette métrique sont regroupés par pays ou région, au format ISO 3166-1 alpha-2. |
| Prix moyen par partie de message, regroupé par pays | `txn-sms-average-price-by-parts-grouped-by-country` | Coût moyen de l'envoi de chaque partie d'un message, pour chaque pays ou région où les messages ont été envoyés. Une partie de message représente une partie d'un message SMS. Le prix est indiqué en millièmes d'un cent des États-Unis. Par exemple, si la valeur de cet attribut est 645, nous vous avons facturé 0,645 ¢ pour envoyer le message (645 / 1000 = 0,645 ¢ = 0,00645 \$1). Cette métrique est calculée comme le coût total de toutes les parties de message envoyées aux destinataires dans chaque pays ou région, divisé par le nombre de parties de message envoyées aux destinataires dans chacun de ces pays et régions. Les résultats de la requête pour cette métrique sont regroupés par pays ou région, au format ISO 3166-1 alpha-2. |
| Messages délivrés | `txn-sms-delivered` | Nombre de messages remis à leurs destinataires prévus. |
| Livraisons, regroupées par pays | `txn-sms-delivered-grouped-by-country` | Nombre de messages remis aux destinataires, pour chaque pays ou région où les messages ont été envoyés. Les résultats de la requête pour cette métrique sont regroupés par pays ou région, au format ISO 3166-1 alpha-2. |
| Livraisons, regroupées par date | `txn-sms-delivered-grouped-by-date` | Nombre de messages remis aux destinataires, pour chaque jour de la plage de dates spécifiée. Les résultats de la requête pour cette métrique sont regroupés par jour calendaire, au format étendu ISO 8601. |
| Erreurs de livraison | `txn-sms-error-distribution` | Nombre de fois où une erreur s'est produite lors des tentatives de livraison des messages, pour chaque type d'erreur qui s'est produite. Les résultats de la requête pour cette métrique sont regroupés par code d'erreur, pour chaque type d'erreur qui s'est produite. |
| Delivery rate (Taux de remise) | `txn-sms-delivery-rate` | Pourcentage de messages remis aux destinataires. Cette métrique est calculée en fonction du nombre de messages envoyés et remis aux destinataires, divisé par le nombre de messages envoyés. |
| Delivery rate, grouped by date (Taux de remise, regroupement par date) | `txn-sms-delivery-rate-grouped-by-date` | Pourcentage de messages remis aux destinataires, pour chaque jour de la plage de dates spécifiée. Cette métrique est calculée en fonction du nombre de messages envoyés et remis aux destinataires, divisé par le nombre de messages envoyés, pour chaque jour de la plage de dates spécifiée. Les résultats de la requête pour cette métrique sont regroupés par jour calendaire, au format étendu ISO 8601. |
| Parties de message remises | `txn-sms-delivered-by-parts` | Nombre de parties de message remises. Une *partie de message* représente une partie d'un message SMS. Si un SMS contient plus de caractères que le protocole SMS ne le permet, Amazon Pinpoint divise le message en autant de parties que nécessaire pour l'envoyer à un destinataire. |
| Parties de message remises, regroupées par pays | `txn-sms-delivered-by-parts-grouped-by-country` | Nombre de parties de message remises, pour chaque pays ou région où les messages ont été envoyés. Une *partie de message* représente une partie d'un message SMS. Les résultats de la requête pour cette métrique sont regroupés par pays ou région, au format ISO 3166-1 alpha-2. |
| Parties de message envoyées | `txn-sms-sent-by-parts` | Nombre de parties de message envoyées. Une *partie de message* représente une partie d'un message SMS. Si un SMS contient plus de caractères que le protocole SMS ne le permet, Amazon Pinpoint divise le message en autant de parties que nécessaire pour l'envoyer à un destinataire. |
| Parties de message envoyées, regroupées par pays | `txn-sms-sent-by-parts-grouped-by-country` | Nombre de parties de message envoyées, pour chaque pays ou région où les messages ont été envoyés. Une *partie de message* représente une partie d'un message SMS. Les résultats de la requête pour cette métrique sont regroupés par pays ou région, au format ISO 3166-1 alpha-2. |
| Messages sent (Messages envoyés) | `txn-sms-sent` | Nombre de messages envoyés. |
| Messages envoyés, regroupés par pays | `txn-sms-sent-grouped-by-country` | Nombre de messages envoyés, pour chaque pays ou région où les messages ont été envoyés. Les résultats de la requête pour cette métrique sont regroupés par pays ou région, au format ISO 3166-1 alpha-2. |
| Messages envoyés, regroupés par date | `txn-sms-sent-grouped-by-date` | Nombre de messages envoyés, pour chaque jour de la plage de dates spécifiée. Les résultats de la requête pour cette métrique sont regroupés par jour calendaire, au format étendu ISO 8601. |
| Prix total, regroupé par pays | `txn-sms-total-price-grouped-by-country` | Coût total de l'envoi des messages, pour chaque pays ou région où les messages ont été envoyés. Le prix est indiqué en millièmes d'un cent des États-Unis. Par exemple, si la valeur de cet attribut est 645, nous vous avons facturé 0,645 ¢ pour envoyer le message (645 / 1000 = 0,645 ¢ = 0,00645 \$1). Les résultats de la requête pour cette métrique sont regroupés par pays ou région, au format ISO 3166-1 alpha-2. |
# Statistiques de campagne Amazon Pinpoint
Le tableau suivant répertorie et décrit les métriques de campagne standard que vous pouvez interroger pour en savoir plus sur les tendances d'une campagne individuelle. Pour interroger les données pour ces métriques, vous utilisez la ressource [Métriques](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html) de campagne de l'API Amazon Pinpoint. Dans la table, la colonne **kpi-name** indique la valeur à utiliser pour le paramètre `kpi-name` de votre requête.
| Métrique | Kpi-name | Description |
| --- | --- | --- |
| Bounce rate (Taux de retours à l’expéditeur) | `hard-bounce-rate` | Pour l'ensemble des exécutions de campagnes, pourcentage d'e-mails n'ayant pas pu être remis aux destinataires. Cette métrique mesure uniquement les messages d'erreur définitifs, c'est-à-dire les messages dans lesquels l'adresse e-mail du destinataire a rencontré un problème permanent ayant empêché la remise du message. Cette métrique est calculée de la façon suivante : le nombre d'e-mails non remis qui ont été envoyés par toutes les exécutions de campagnes, divisé par le nombre d'e-mails qui ont été envoyés par l'ensemble de ces exécutions de campagnes. |
| Bounce rate, grouped by campaign (Taux de retours à l'expéditeur, regroupement par campagne) | `hard-bounce-rate-grouped-by-campaign-activity` | Pour chaque exécution de campagne, pourcentage d'e-mails n'ayant pas pu être remis aux destinataires. Cette métrique mesure uniquement les messages d'erreur définitifs, c'est-à-dire les messages dans lesquels l'adresse e-mail du destinataire a rencontré un problème permanent ayant empêché la remise du message. Cette métrique est calculée de la façon suivante : le nombre d'e-mails non remis qui ont été envoyés par une exécution de campagne, divisé par le nombre d'e-mails qui ont été envoyés par cette exécution de campagne. Les résultats de la requête pour cette métrique sont regroupés par ID d'activité de campagne (`CampaignActivityId`), une chaîne qui identifie de façon unique une campagne. |
| Delivery rate (Taux de remise) | `successful-delivery-rate` | Pour l'ensemble des exécutions de campagnes, pourcentage de messages ayant été remis aux destinataires. Cette métrique est calculée en fonction du nombre de messages envoyés par toutes les exécutions de campagnes et remis aux destinataires, divisé par le nombre de messages qui ont été envoyés par l'ensemble de ces exécutions de campagnes. |
| Delivery rate, grouped by campaign run (Taux de remise, regroupement par exécution de campagne) | `successful-delivery-rate-grouped-by-campaign-activity` | Pour chaque exécution de campagne, pourcentage de messages ayant été remis aux destinataires. Cette métrique est calculée de la façon suivante : le nombre de messages envoyés par une exécution de campagne et remis aux destinataires, divisé par le nombre de messages qui ont été envoyés par cette exécution de campagne. Les résultats de la requête pour cette métrique sont regroupés par ID d'activité de campagne (`CampaignActivityId`), une chaîne qui identifie de façon unique une campagne. |
| Delivery rate, grouped by date (Taux de remise, regroupement par date) | `successful-delivery-rate-grouped-by-date` | Pour l'ensemble des exécutions de campagnes, pourcentage de messages ayant été remis aux destinataires, pour chaque jour de la plage de dates spécifiée. Cette métrique est calculée de la façon suivante : le nombre de messages envoyés par toutes les exécutions de campagnes et remis aux destinataires, divisé par le nombre de messages qui ont été envoyés par l'ensemble de ces exécutions de campagnes, pour chaque jour de la plage de dates spécifiée. Les résultats de la requête pour cette métrique sont regroupés par jour calendaire, au format étendu ISO 8601. |
| Email open rate (Taux d’ouverture d’e-mail) | `email-open-rate` | Pour l'ensemble des exécutions de campagnes, pourcentage d'e-mails ayant été ouverts par les destinataires.Cette métrique est calculée de la façon suivante : le nombre d'e-mails envoyés par toutes les exécutions de campagnes pour un projet et ouverts par les destinataires, divisé par le nombre d'e-mails qui ont été envoyés par l'ensemble de ces exécutions de campagnes et remis aux destinataires. |
| Email open rate, grouped by campaign run (Taux d'ouverture d'e-mail, regroupement par exécution de campagne) | `email-open-rate-grouped-by-campaign-activity` | Pour chaque exécution de campagne, pourcentage d'e-mails ayant été ouverts par les destinataires. Cette métrique est calculée de la façon suivante : le nombre d'e-mails envoyés par une exécution de campagne et ouverts par les destinataires, divisé par le nombre d'e-mails qui ont été envoyés par l'exécution de campagne et remis aux destinataires. Les résultats de la requête pour cette métrique sont regroupés par ID d'activité de campagne (`CampaignActivityId`), une chaîne qui identifie de façon unique une campagne. |
| Emails opened, grouped by campaign run (E-mails ouverts, regroupement par exécution de campagne) | `direct-email-opens-grouped-by-campaign-activity` | Pour chaque exécution de campagne, nombre d'e-mails ayant été ouverts par les destinataires. Les résultats de la requête pour cette métrique sont regroupés par ID d'activité de campagne (`CampaignActivityId`), une chaîne qui identifie de façon unique une campagne. |
| Endpoint deliveries (Remises au point de terminaison) | `unique-deliveries` | Pour l'ensemble des exécutions de campagnes, nombre de points de terminaison uniques auxquels les messages ont été envoyés. |
| Endpoint deliveries, grouped by campaign run (Remises au point de terminaison, regroupement par exécution de campagne) | `unique-deliveries-grouped-by-campaign-activity` | Pour chaque exécution de campagne, nombre de points de terminaison uniques auxquels les messages ont été envoyés. Les résultats de la requête pour cette métrique sont regroupés par ID d'activité de campagne (`CampaignActivityId`), une chaîne qui identifie de façon unique une campagne. |
| Endpoint deliveries, grouped by date (Remises au point de terminaison, regroupement par date) | `unique-deliveries-grouped-by-date` | Pour l'ensemble des exécutions de campagnes, nombre de points de terminaison uniques auxquels les messages ont été remis, pour chaque jour de la plage de dates spécifiée. Les résultats de la requête pour cette métrique sont regroupés par jour calendaire, au format étendu ISO 8601. |
| Links clicked, grouped by campaign run (Liens activés, regroupement par exécution de campagne) | `clicks-grouped-by-campaign-activity` | Pour chaque exécution de campagne, nombre de fois où les destinataires ont cliqué sur les liens dans l'e-mail. Si un seul destinataire a cliqué sur plusieurs liens dans le message, ou s'il a cliqué sur le même lien plusieurs fois, chaque clic est inclus dans le total. Les résultats de la requête pour cette métrique sont regroupés par ID d'activité de campagne (`CampaignActivityId`), une chaîne qui identifie de façon unique une campagne. |
| Messages delivered, grouped by campaign run (Messages remis, regroupement par exécution de campagne) | `successful-deliveries-grouped-by-campaign-activity` | Pour chaque exécution de campagne, nombre de messages ayant été remis aux destinataires. Cette métrique est calculée de la façon suivante : le nombre de messages envoyés par une exécution de campagne, moins le nombre de messages n'ayant pas été remis aux destinataires de l'exécution du fait d'un message d'erreur définitif. Les résultats de la requête pour cette métrique sont regroupés par ID d'activité de campagne (`CampaignActivityId`), une chaîne qui identifie de façon unique une campagne. |
| Messages sent, grouped by campagne run (Messages envoyés, regroupement par exécution de campagne) | `attempted-deliveries-grouped-by-campaign-activity` | Pour chaque exécution de campagne, nombre de messages ayant été envoyés. Les résultats de la requête pour cette métrique sont regroupés par ID d'activité de campagne (`CampaignActivityId`), une chaîne qui identifie de façon unique une campagne. |
| Push open rate (Taux d’ouverture des notifications push) | `push-open-rate` | Pour l'ensemble des exécutions de campagnes, pourcentage de notifications push ayant été ouvertes par les destinataires. Cette métrique est calculée de la façon suivante : le nombre de notifications push envoyées par toutes les exécutions de campagnes et ouvertes par les destinataires, divisé par le nombre de notifications push qui ont été envoyées par l'ensemble de ces exécutions de campagnes et remises aux destinataires. |
| Push open rate, grouped by campaign run (Taux d'ouverture des notifications push, regroupement par exécution de campagne) | `push-open-rate-grouped-by-campaign-activity` | Pour chaque exécution de campagne, pourcentage de notifications push ayant été ouvertes par les destinataires. Cette métrique est calculée de la façon suivante : le nombre de notifications push envoyées par une exécution de campagne et ouvertes par les destinataires, divisé par le nombre de notifications push qui ont été envoyées par l'exécution de campagne. Les résultats de la requête pour cette métrique sont regroupés par ID d'activité de campagne (`CampaignActivityId`), une chaîne qui identifie de façon unique une campagne. |
| Total push opened, grouped by campaign run (Nombre total d'ouvertures de notifications push, regroupement par exécution de campagne) | `direct-push-opens-grouped-by-campaign-activity` | Pour chaque exécution de campagne, nombre de notifications push ayant été ouvertes par les destinataires. Les résultats de la requête pour cette métrique sont regroupés par ID d'activité de campagne (`CampaignActivityId`), une chaîne qui identifie de façon unique une campagne. |
| Total SMS spend (Total des dépenses en SMS) | sms-spend | Pour toutes les campagnes, le montant total, en millième de cents, dépensé pour envoyer des SMS. |
# Indicateurs d'engagement liés au parcours Amazon Pinpoint
Le tableau suivant répertorie et décrit les métriques d'engagement du parcours standard que vous pouvez interroger pour en savoir plus sur les tendances de tous les e-mails envoyés par un parcours Amazon Pinpoint. Pour interroger les données de ces métriques, utilisez la ressource [Métriques d'engagement du parcours](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-journeys-journey-id-kpis-daterange-kpi-name.html) de l'API Amazon Pinpoint. La colonne **kpi-name** de la table indique la valeur à utiliser pour le paramètre `kpi-name` de votre requête.
| Métrique | Kpi-name | Description |
| --- | --- | --- |
| Clics | `journey-emails-clicked` | Nombre de fois où les destinataires ont cliqué sur des liens dans les messages. Si un seul participant a cliqué sur plusieurs liens dans un message, ou s'il a cliqué sur le même lien plusieurs fois, chaque clic est inclus dans le total. |
| Clics, regroupés par activité | `emails-clicked-grouped-by-journey-activity` | Pour chaque activité du parcours, le nombre de fois où les participants ont cliqué sur des liens dans les messages. Si un seul participant a cliqué sur plusieurs liens dans un message, ou s'il a cliqué sur le même lien plusieurs fois, chaque clic est inclus dans le total. Les résultats de la requête pour cette métrique sont regroupés par ID d'activité (`JourneyActivityId`), une chaîne qui identifie de façon unique une activité. |
| Réclamations | `journey-emails-complained` | Nombre de messages signalés par les participants comme des e-mails indésirables. |
| Réclamations, regroupées par activité | `emails-complained-grouped-by-journey-activity` | Pour chaque activité du parcours, le nombre de messages signalés par les participants comme des e-mails indésirables.Les résultats de la requête pour cette métrique sont regroupés par ID d'activité (`JourneyActivityId`), une chaîne qui identifie de façon unique une activité. |
| Messages délivrés | `journey-emails-delivered` | Nombre de messages remis aux participants. Cette métrique est calculée en fonction du nombre de messages envoyés moins le nombre de messages qui n'ont pas pu être remis en raison d'une non-remise temporaire ou définitive, ou parce qu'ils ont été rejetés. |
| Messages remis, regroupés par activité | `emails-delivered-grouped-by-journey-activity` | Pour chaque activité du parcours, le nombre de messages ayant été remis aux participants. Cette métrique est calculée en fonction du nombre de messages envoyés moins le nombre de messages qui n'ont pas pu être remis en raison d'une erreur de remise temporaire ou d'un retour à l'expéditeur, ou parce qu'ils ont été rejetés, pour chaque activité du parcours. Les résultats de la requête pour cette métrique sont regroupés par ID d'activité (`JourneyActivityId`), une chaîne qui identifie de façon unique une activité. |
| Messages d'erreur définitifs | `journey-emails-hardbounced` | Nombre de messages n'ayant pas pu être remis aux participants en raison d'un retour à l'expéditeur. Un message d'erreur définitif est renvoyé si un problème persistant empêche la remise d'un message, par exemple, si l'adresse e-mail d'un participant n'existe pas. |
| Retours à l'expéditeur, regroupés par date | `emails-hardbounced-grouped-by-journey-activity` | Pour chaque activité du parcours, le nombre de messages n'ayant pas pu être remis aux participants en raison d'un retour à l'expéditeur. Un message d'erreur définitif est renvoyé si un problème persistant empêche la remise d'un message, par exemple, si l'adresse e-mail d'un participant n'existe pas. Les résultats de la requête pour cette métrique sont regroupés par ID d'activité (`JourneyActivityId`), une chaîne qui identifie de façon unique une activité. |
| Messages ouverts | `journey-emails-opened` | Nombre de messages ouverts par les participants. |
| Messages ouverts, regroupés par activité | `emails-opened-grouped-by-journey-activity` | Pour chaque activité du parcours, le nombre de messages ayant été ouverts par les participants. Les résultats de la requête pour cette métrique sont regroupés par ID d'activité (`JourneyActivityId`), une chaîne qui identifie de façon unique une activité. |
| Rejets | `journey-emails-rejected` | Nombre de messages n'ayant pas été envoyés aux participants parce qu'ils ont été rejetés. Un message est rejeté si Amazon Pinpoint détermine qu'il contient un logiciel malveillant. Amazon Pinpoint n'essaie pas d'envoyer des messages rejetés. |
| Messages rejetés, regroupés par activité | `emails-rejected-grouped-by-journey-activity` | Pour chaque activité, le nombre de messages n'ayant pas été envoyés aux participants parce qu'ils ont été rejetés. Un message est rejeté si Amazon Pinpoint détermine qu'il contient un logiciel malveillant. Amazon Pinpoint n'essaie pas d'envoyer des messages rejetés. Les résultats de la requête pour cette métrique sont regroupés par ID d'activité (`JourneyActivityId`), une chaîne qui identifie de façon unique une activité. |
| Envois | `journey-emails-sent` | Nombre de messages envoyés. |
| Messages envoyés, regroupés par activité | `emails-sent-grouped-by-journey-activity` | Pour chaque activité du parcours, le nombre de messages envoyés. Les résultats de la requête pour cette métrique sont regroupés par ID d'activité (`JourneyActivityId`), une chaîne qui identifie de façon unique une activité. |
| Erreurs de remise temporaire | `journey-emails-softbounced` | Nombre de messages n'ayant pas pu être remis aux participants en raison d'une erreur de remise temporaire. Un message d'erreur temporaire est renvoyé si un problème temporaire empêche la distribution d'un message, par exemple, si la boîte de réception d'un participant est pleine ou si le serveur de réception est temporairement indisponible. |
| Erreurs de remise temporaire, regroupées par activité | `emails-softbounced-grouped-by-journey-activity` | Pour chaque activité du parcours, le nombre de messages n'ayant pas pu être remis aux participants en raison d'une erreur de remise temporaire. Un message d'erreur temporaire est renvoyé si un problème temporaire empêche la distribution d'un message, par exemple, si la boîte de réception d'un participant est pleine ou si le serveur de réception est temporairement indisponible. Les résultats de la requête pour cette métrique sont regroupés par ID d'activité (`JourneyActivityId`), une chaîne qui identifie de façon unique une activité. |
| Désabonnement | `journey-emails-unsubscribed` | Nombre de fois où les participants ont cliqué sur des liens de désinscription dans les messages. Si un participant a cliqué plusieurs fois sur le même lien de désabonnement, chaque clic est inclus dans le total. |
| Désabonnements, regroupés par activité | `emails-unsubscribed-grouped-by-journey-activity` | Pour chaque activité du parcours, le nombre de fois où les participants ont cliqué sur des liens de désabonnement dans les messages. Si un participant a cliqué plusieurs fois sur le même lien de désabonnement, chaque clic est inclus dans le total. Les résultats de la requête pour cette métrique sont regroupés par ID d'activité (`JourneyActivityId`), une chaîne qui identifie de façon unique une activité. |
# Indicateurs d'exécution du parcours Amazon Pinpoint
Le tableau suivant répertorie et décrit les métriques d'exécution standard que vous pouvez interroger pour évaluer le statut des participants dans un parcours Amazon Pinpoint. Pour interroger les données de ces métriques, utilisez la ressource [Métriques d'exécution du parcours](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-journeys-journey-id-execution-metrics.html) de l'API Amazon Pinpoint. La colonne **Field (Champ)** du tableau identifie le nom du champ qui s'affiche dans les résultats de la requête pour chaque métrique.
| Métrique | Champ | Description |
| --- | --- | --- |
| Participants actifs | `ENDPOINT_ACTIVE` | Nombre de participants poursuivant activement les activités du parcours. Cette métrique est calculée de la façon suivante : nombre de participants qui ont commencé le parcours, moins nombre de participants ayant quitté le parcours et le nombre de participants qui ont été exclus du parcours. |
| Annulations des participants | `CANCELLED` | Nombre de participants n'ayant pas terminé le parcours en raison de son annulation. |
| Départs des participants | `ENDPOINT_LEFT` | Nombre de participants ayant quitté le parcours. |
| Admissions des participants | `ENDPOINT_ENTERED` | Nombre de participants ayant commencé le parcours. |
| Exceptions des participants, limites de réadmission | `REENTRY_CAP_EXCEEDED` | Nombre de participants n'ayant pas terminé le parcours parce qu'ils auraient dépassé le nombre maximum de fois qu'un seul participant peut accéder au parcours. |
| Exceptions des participants, rejets | `ACTIVE_ENDPOINT_REJECTED` | Nombre de participants qui ne peuvent pas commencer le parcours parce qu'ils sont déjà des participants actifs au parcours. Un participant est rejeté s'il commence un parcours et que vous mettez ensuite à jour la définition de son point de terminaison d'une façon qui affecte son inclusion dans un segment (en fonction des critères du segment) ou un parcours (en fonction des conditions de l'activité). |
# Mesures d'exécution des activités liées au parcours Amazon Pinpoint
Le tableau suivant répertorie et décrit les métriques d'exécution standard que vous pouvez interroger pour évaluer le statut des participants dans chaque type d'activité individuelle d'un parcours Amazon Pinpoint. Pour interroger les données de ces métriques, utilisez la ressource [Métriques d'exécution des activités du parcours](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-journeys-journey-id-activities-journey-activity-id-execution-metrics.html) de l'API Amazon Pinpoint. La colonne **Metrics (Métriques)** du tableau répertorie les champs qui s'affichent dans les résultats de la requête pour chaque type d'activité. Elle fournit également une brève description de chaque champ.
| Type d'activité | Métriques |
| --- | --- |
| Yes/no split (Répartition Oui/Non) (`CONDITIONAL_SPLIT`) | Les métriques sont les suivantes : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/pinpoint/latest/developerguide/journey-metrics-activity-execution.html) Des métriques supplémentaires sont disponibles pour chaque chemin de l'activité. Pour de plus amples informations sur ces métriques, veuillez consulter la ligne de ce tableau correspondant à ce type d'activité. |
| Holdout (Exclusion) (`HOLDOUT`) | Les métriques sont les suivantes : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/pinpoint/latest/developerguide/journey-metrics-activity-execution.html) |
| Email (E-mail) (`MESSAGE`) | Les métriques sont les suivantes : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/pinpoint/latest/developerguide/journey-metrics-activity-execution.html) |
| Multivariate split (Répartition multivariée) (`MULTI_CONDITIONAL_SPLIT`) | Pour chaque chemin de l'activité, le nombre de participants qui se sont dirigés vers l'activité sur le chemin. Les résultats des requêtes pour cette métrique sont regroupés par chemin, `Branch_#` où *\$1* est l'identifiant numérique d'un chemin, par exemple, `Branch_1` pour le premier chemin de l'activité. Des métriques supplémentaires sont disponibles pour chaque chemin de l'activité. Pour de plus amples informations sur ces métriques, veuillez consulter la ligne de ce tableau correspondant à ce type d'activité. |
| Random split (Répartition aléatoire) (`RANDOM_SPLIT`) | Pour chaque chemin de l'activité, le nombre de participants qui se sont dirigés vers l'activité sur le chemin. Les résultats des requêtes pour cette métrique sont regroupés par chemin, `Branch_#` où *\$1* est l'identifiant numérique d'un chemin, par exemple, `Branch_1` pour le premier chemin de l'activité. Des métriques supplémentaires sont disponibles pour chaque chemin de l'activité. Pour de plus amples informations sur ces métriques, veuillez consulter la ligne de ce tableau correspondant à ce type d'activité. |
| Wait (Attente) (`WAIT`) | Les métriques sont les suivantes : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/pinpoint/latest/developerguide/journey-metrics-activity-execution.html) |
| Centre de contact (`CONTACT_CENTER`) | Les métriques sont les suivantes : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/pinpoint/latest/developerguide/journey-metrics-activity-execution.html) |
# Statistiques relatives au parcours et à l'exécution des campagnes Amazon Pinpoint
Vous pouvez interroger les mesures d'exécution standard pour évaluer le statut des participants à chaque type d'activité individuelle pour un parcours ou une campagne Amazon Pinpoint. Pour interroger les données de ces métriques, utilisez la ressource [Métriques d'exécution des activités du parcours](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-journeys-journey-id-runs-run-id-activities-journey-activity-id-execution-metrics.html) ou la ressource [Métriques de campagnes](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html) de l'API Amazon Pinpoint. Le tableau suivant répertorie les champs qui s'affichent dans les résultats de la requête pour chaque type d'activité.
****
| Nom de la métrique | S'applique aux parcours, aux campagnes ou aux deux | Description |
| --- | --- | --- |
| ENDPOINT\$1PRODUCED | les deux | Le nombre de points de terminaison initialement produits à partir du segment ou de l'événement avant tout filtrage. |
| ENDPOINTS\$1FROM\$1USER | les deux | Si le client possède un segment contenant uniquement un ID utilisateur, tous les points de terminaison de ces utilisateurs seront ajoutés. Cette métrique mesure le nombre de points de terminaison ajoutés de cette manière. |
| ENDPOINT\$1OPT\$1OUT | les deux | Le point de terminaison a été désactivé et n'a pas participé à la campagne ou au parcours. |
| ENDPOINT\$1INACTIVE | les deux | Le point de terminaison est désactivé et n'a pas participé à la campagne ou au parcours. |
| FILTERED\$1OUT\$1BY\$1SEGMENT | les deux | Le point de terminaison ne correspondait pas aux filtres de segment et n'a pas participé à la campagne ou au parcours. |
| ENDPOINT\$1MISSING\$1ADDRESS | les deux | Il manquait une adresse au point de terminaison et il n'a pas participé à la campagne ou au parcours. |
| ENDPOINT\$1MISSING\$1CHANNEL | les deux | Il manquait un canal au point de terminaison et il n'a pas participé à la campagne ou au parcours. |
| ENDPOINT\$1MISSING\$1TIMEZONE | les deux | Il manquait une valeur de fuseau horaire au point de terminaison et il a été exclu du filtrage. Cela se produit uniquement lorsqu'une valeur de fuseau horaire est requise. |
| ENDPOINT\$1TIMEZONE\$1MISMATCH | les deux | Le point de terminaison se trouvait dans un fuseau horaire qui n'était pas inclus dans l'exécution à ce moment-là. |
| ENDPOINT\$1CHANNEL\$1MISMATCH | Campagnes | Aucun message n'est configuré pour le type de canal de ce point de terminaison. |
| DUPLICATE\$1ENDPOINT | les deux | Des points de terminaison dupliqués ont été trouvés et dédupliqués. |
| DUPLICATE\$1USER | les deux | Des utilisateurs dupliqués ont été trouvés et dédupliqués à partir d'un segment contenant uniquement des ID d'utilisateur. S'ils ont le même ID utilisateur, une métrique de 1 sera émise. |
| PAUSED | Parcours | Supprimé de l'exécution car le parcours a été suspendu. |
| ENDED | Parcours | Supprimé de l'exécution car le parcours a été supprimé. |
| TREATMENT\$1HOLDOUT | Campagnes | Cela est émis dans les A/B campagnes, pour les paramètres dont les cohortes ne correspondent pas au traitement actuel. Par exemple, dans un A/B partage 50/50, 50 % des points de terminaison émettront cette métrique pour chaque traitement |
| ENDPOINT\$1ESTIMATED\$1TIMEZONE | Parcours | L'estimation du fuseau horaire a permis d'estimer un fuseau horaire pour le point de terminaison. |
# Interrogez les données d'analyse Amazon Pinpoint pour les campagnes
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 des informations sur les tendances en matière de diffusion et d'engagement pour les campagnes.
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 d'une ou plusieurs campagnes. Par exemple, vous pouvez utiliser une métrique pour connaître le nombre de points de terminaison auxquels un message de campagne a été envoyé ou le nombre de ces messages qui ont été remis aux points de terminaison prévus.
Amazon Pinpoint collecte et regroupe automatiquement ces données pour toutes vos campagnes. Il stocke les données pendant 90 jours. Si vous avez intégré une application mobile à Amazon Pinpoint à l'aide d'un SDK AWS mobile, Amazon Pinpoint étend cette prise en charge pour inclure des statistiques supplémentaires, telles que le pourcentage de notifications push ouvertes par les destinataires. Pour plus d'informations sur l'intégration d'une application mobile, reportez-vous à la section [Intégrez Amazon Pinpoint à votre application](integrate.md).
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, la campagne et la mesure 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 pour une ou plusieurs campagnes.
## Conditions préalables
Avant d'interroger les données d'analyse d'une ou de plusieurs campagnes, il est utile de recueillir les informations suivantes, que vous utilisez pour définir votre requête :
+ **ID de projet** : identifiant unique du projet associé à la ou aux campagnes. 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**.
+ **ID de campagne** : identifiant unique de la campagne, si vous souhaitez interroger les données d'une seule campagne. Dans l'API Amazon Pinpoint, cette valeur est stockée dans la propriété `campaign-id`. Cette valeur n'est pas affichée sur la console.
+ **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.
+ **Type de métrique** : type de métrique à interroger. Il existe deux types : les *métriques d'application* et les *métriques de campagne*. Une *métrique d'application* fournit les données de toutes les campagnes associées à un projet, également appelée *application*. Une *métrique de campagne* fournit les données pour une seule campagne.
+ **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](analytics-standard-metrics.md).
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 pourcentage de messages remis aux destinataires d'une campagne. L'une de ces métriques regroupe automatiquement les données par date (`successful-delivery-rate-grouped-by-date`). Une autre métrique regroupe automatiquement les données par exécution de campagne (`successful-delivery-rate-grouped-by-campaign-activity`). Une troisième métrique renvoie simplement une valeur unique : le pourcentage de messages remis aux destinataires par toutes les exécutions de la campagne (`successful-delivery-rate`).
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](analytics-permissions.md).
# Interrogez les données Amazon Pinpoint pour une campagne
Pour interroger les données d'une campagne, utilisez l'API [Métriques de campagne](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html) et spécifiez les valeurs des paramètres requis suivants :
+ **application-id** : ID du projet, qui est l'identifiant unique du projet associé à la campagne. Dans Amazon Pinpoint, les termes *projet* et *application* ont la même signification.
+ **campaign-id** : identifiant unique de la campagne.
+ **kpi-name** : nom de la métrique à interroger. 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. 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](analytics-standard-metrics.md).
Vous pouvez également appliquer un filtre qui interroge les données pour une plage de dates spécifique. Si vous ne spécifiez pas de plage de dates, Amazon Pinpoint renvoie les données des 31 jours civils précédents. Pour filtrer les données selon différentes dates, utilisez les paramètres de plage de dates pris en charge pour spécifier les premières et dernières date et heure de la plage de dates. Les valeurs doivent être au format ISO 8601 étendu et utiliser le temps universel coordonné (UTC) : par exemple, `2019-07-19T20:00:00Z` pour 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.
Les exemples suivants montrent comment interroger des données d'analyse pour une campagne à l'aide de l'API REST Amazon Pinpoint, du AWS CLI, et du. AWS SDK pour Java Vous pouvez utiliser n'importe quel AWS SDK compatible pour interroger les données d'analyse d'une campagne. Les AWS CLI exemples sont formatés pour Microsoft Windows. Pour Unix, Linux et macOS, remplacez le caractère caret (^) de continuation de ligne par une barre oblique inverse (\$1).
------
#### [ REST API ]
Pour interroger les données analytiques d'une campagne à l'aide de l'API REST Amazon Pinpoint, envoyez une demande HTTP(S) GET à l'URI des [métriques de campagne](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html). Dans l'URI, spécifiez les valeurs appropriées pour les paramètres de chemin requis :
```
https://endpoint/v1/apps/application-id/campaigns/campaign-id/kpis/daterange/kpi-name
```
Où :
+ *endpoint*est le point de terminaison Amazon Pinpoint pour la AWS région qui héberge le projet associé à la campagne.
+ *application-id* est l'identifiant unique du projet associé à la campagne.
+ *campaign-id* est l'identifiant unique de la campagne.
+ *kpi-name*est la `kpi-name` valeur de la métrique à interroger.
Tous les paramètres doivent être codés par URL.
Pour appliquer un filtre qui interroge les données pour une plage de dates spécifique, ajoutez les paramètres `start-time` et `end-time` et leurs valeurs à l'URI. À l'aide de ces paramètres, vous pouvez spécifier les premières et dernières date et l'heure, au format ISO 8601 étendu, d'une plage de dates incluse pour récupérer les données. Utilisez une esperluette (&) pour séparer les paramètres.
Par exemple, la demande suivante extrait le nombre de points de terminaison uniques auxquels les messages ont été remis, par toutes les exécutions d'une campagne, du 19 juillet 2019 au 26 juillet 2019 :
```
https://pinpoint.us-east-1.amazonaws.com/v1/apps/1234567890123456789012345example/campaigns/80b8efd84042ff8d9c96ce2f8example/kpis/daterange/unique-deliveries?start-time=2019-07-19T00:00:00Z&end-time=2019-07-26T23:59:59Z
```
Où :
+ `pinpoint.us-east-1.amazonaws.com` est le point de terminaison Amazon Pinpoint de la région AWS qui héberge le projet.
+ `1234567890123456789012345example` est l'identifiant unique du projet associé à la campagne.
+ `80b8efd84042ff8d9c96ce2f8example` est l'identifiant unique de la campagne.
+ `unique-deliveries` est la valeur `kpi-name` de la métrique de campagne *endpoint deliveries (remises de points de terminaison)*. Cette métrique indique le nombre de points de terminaison uniques auxquels les messages ont été remis, pour toutes les exécutions d'une campagne.
+ `2019-07-19T00:00:00Z` est la première date et heure à laquelle récupérer les données, dans le cadre d'une plage de dates inclusive.
+ `2019-07-26T23:59:59Z` est la dernière date et heure auxquelles récupérer les données, dans le cadre d'une plage de dates inclusive.
------
#### [ AWS CLI ]
Pour interroger les données d'analyse d'une campagne à l'aide de AWS CLI, utilisez la **get-campaign-date-range-kpi** commande et spécifiez les valeurs appropriées pour les paramètres requis :
```
C:\> aws pinpoint get-campaign-date-range-kpi ^
--application-id application-id ^
--campaign-id campaign-id ^
--kpi-name kpi-name
```
Où :
+ *application-id* est l'identifiant unique du projet associé à la campagne.
+ *campaign-id* est l'identifiant unique de la campagne.
+ *kpi-name*est la `kpi-name` valeur de la métrique à interroger.
Pour appliquer un filtre qui interroge les données pour une plage de dates spécifique, ajoutez les paramètres `start-time` et`end-time` et leurs valeurs à votre requête. À l'aide de ces paramètres, vous pouvez spécifier les premières et dernières date et l'heure, au format ISO 8601 étendu, d'une plage de dates incluse pour récupérer les données. Par exemple, la demande suivante extrait le nombre de points de terminaison uniques auxquels les messages ont été remis, par toutes les exécutions d'une campagne, du 19 juillet 2019 au 26 juillet 2019 :
```
C:\> aws pinpoint get-campaign-date-range-kpi ^
--application-id 1234567890123456789012345example ^
--campaign-id 80b8efd84042ff8d9c96ce2f8example ^
--kpi-name unique-deliveries ^
--start-time 2019-07-19T00:00:00Z ^
--end-time 2019-07-26T23:59:59Z
```
Où :
+ `1234567890123456789012345example` est l'identifiant unique du projet associé à la campagne.
+ `80b8efd84042ff8d9c96ce2f8example` est l'identifiant unique de la campagne.
+ `unique-deliveries` est la valeur `kpi-name` de la métrique de campagne *endpoint deliveries (remises de points de terminaison)*. Cette métrique indique le nombre de points de terminaison uniques auxquels les messages ont été remis, pour toutes les exécutions d'une campagne.
+ `2019-07-19T00:00:00Z` est la première date et heure à laquelle récupérer les données, dans le cadre d'une plage de dates inclusive.
+ `2019-07-26T23:59:59Z` est la dernière date et heure auxquelles récupérer les données, dans le cadre d'une plage de dates inclusive.
------
#### [ SDK for Java ]
Pour interroger les données d'analyse d'une campagne à l'aide de AWS SDK pour Java, utilisez la **GetCampaignDateRangeKpiRequest** méthode de l'API [Campaign Metrics](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html). Spécifiez les valeurs appropriées pour les paramètres requis :
```
GetCampaignDateRangeKpiRequest request = new GetCampaignDateRangeKpiRequest()
.withApplicationId("applicationId")
.withCampaignId("campaignId")
.withKpiName("kpiName")
```
Où :
+ *applicationId* est l'identifiant unique du projet associé à la campagne.
+ *campaignId* est l'identifiant unique de la campagne.
+ *kpiName*est la `kpi-name` valeur de la métrique à interroger.
Pour appliquer un filtre qui interroge les données pour une plage de dates spécifique, incluez les paramètres `startTime` et`endTime` et leurs valeurs dans votre requête. À l'aide de ces paramètres, vous pouvez spécifier les premières et dernières date et l'heure, au format ISO 8601 étendu, d'une plage de dates incluse pour récupérer les données. Par exemple, la demande suivante extrait le nombre de points de terminaison uniques auxquels les messages ont été remis, par toutes les exécutions d'une campagne, du 19 juillet 2019 au 26 juillet 2019 :
```
GetCampaignDateRangeKpiRequest request = new GetCampaignDateRangeKpiRequest()
.withApplicationId("1234567890123456789012345example")
.withCampaignId("80b8efd84042ff8d9c96ce2f8example")
.withKpiName("unique-deliveries")
.withStartTime(Date.from(Instant.parse("2019-07-19T00:00:00Z")))
.withEndTime(Date.from(Instant.parse("2019-07-26T23:59:59Z")));
```
Où :
+ `1234567890123456789012345example` est l'identifiant unique du projet associé à la campagne.
+ `80b8efd84042ff8d9c96ce2f8example` est l'identifiant unique de la campagne.
+ `unique-deliveries` est la valeur `kpi-name` de la métrique de campagne *endpoint deliveries (remises de points de terminaison)*. Cette métrique indique le nombre de points de terminaison uniques auxquels les messages ont été remis, pour toutes les exécutions d'une campagne.
+ `2019-07-19T00:00:00Z` est la première date et heure à laquelle récupérer les données, dans le cadre d'une plage de dates inclusive.
+ `2019-07-26T23:59:59Z` est la dernière date et heure auxquelles récupérer les données, dans le cadre d'une plage de dates inclusive.
------
Une fois que vous avez envoyé votre requête, Amazon Pinpoint renvoie les résultats de la requête dans une réponse JSON. La structure des résultats varie en fonction de la métrique que vous avez interrogée. Certaines mesures ne renvoient qu'une seule valeur. Par exemple, la métrique d'application *remises au point de terminaison* (`unique-deliveries`), utilisée dans les exemples précédents, renvoie une seule valeur : le nombre de points de terminaison uniques auxquels les messages ont été remis, pour toutes les exécutions d'une campagne. Dans ce cas, la réponse JSON est la suivante :
```
{
"CampaignDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"CampaignId":"80b8efd84042ff8d9c96ce2f8example",
"EndTime":"2019-07-26T23:59:59Z",
"KpiName":"unique-deliveries",
"KpiResult":{
"Rows":[
{
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"123.0"
}
]
}
]
},
"StartTime":"2019-07-19T00:00:00Z"
}
}
```
D'autres métriques renvoient plusieurs valeurs et regroupent les valeurs selon un champ pertinent. Si une mesure renvoie plusieurs valeurs, la réponse JSON inclut un champ qui indique quel champ a été 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](analytics-query-results.md).
# Interrogez les données Amazon Pinpoint pour plusieurs campagnes
Il existe deux façons d'interroger les données pour plusieurs campagnes. La meilleure façon dépend de votre souhait d'interroger les données pour toutes les campagnes associées au même projet. Dans ce cas, cela dépend également de votre souhait d'interroger les données pour l'ensemble ou un sous-ensemble de ces campagnes.
Pour interroger les données des campagnes associées à différents projets ou pour un sous-ensemble de campagnes associées au même projet, la meilleure approche consiste à créer et à exécuter une série de requêtes individuelles, une pour chaque campagne pour laquelle vous souhaitez interroger les données. La section précédente explique comment interroger les données pour une seule campagne.
Pour interroger les données de toutes les campagnes associées au même projet, vous pouvez utiliser l'API [métriques d'application](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html). Spécifiez des valeurs pour les paramètres obligatoires suivants :
+ **application-id** : ID du projet, qui est l'identifiant unique du projet. Dans Amazon Pinpoint, les termes *projet* et *application* ont la même signification.
+ **kpi-name** : nom de la métrique à interroger. 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. 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](analytics-standard-metrics.md).
Vous pouvez également filtrer les données par plage de dates. Si vous ne spécifiez pas de plage de dates, Amazon Pinpoint renvoie les données des 31 jours civils précédents. Pour filtrer les données selon différentes dates, utilisez les paramètres de plage de dates pris en charge pour spécifier les premières et dernières date et heure de la plage de dates. Les valeurs doivent être au format ISO 8601 étendu et utiliser le temps universel coordonné (UTC) : par exemple, `2019-07-19T20:00:00Z` pour 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.
Les exemples suivants montrent comment interroger des données d'analyse pour une campagne à l'aide de l'API REST Amazon Pinpoint, du AWS CLI, et du. AWS SDK pour Java Vous pouvez utiliser n'importe quel AWS SDK compatible pour interroger les données d'analyse d'une campagne. Les AWS CLI exemples sont formatés pour Microsoft Windows. Pour Unix, Linux et macOS, remplacez le caractère caret (^) de continuation de ligne par une barre oblique inverse (\$1).
------
#### [ REST API ]
Pour interroger les données analytiques de plusieurs campagnes à l'aide de l'API REST Amazon Pinpoint, envoyez une demande HTTP(S) GET à l'URI des [métriques d'application](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html). Dans l'URI, spécifiez les valeurs appropriées pour les paramètres de chemin requis :
```
https://endpoint/v1/apps/application-id/kpis/daterange/kpi-name
```
Où :
+ *endpoint*est le point de terminaison Amazon Pinpoint pour la AWS région qui héberge le projet associé aux campagnes.
+ *application-id* est l'identifiant unique du projet associé aux campagnes.
+ *kpi-name*est la `kpi-name` valeur de la métrique à interroger.
Tous les paramètres doivent être codés par URL.
Pour appliquer un filtre qui extrait les données d'une plage de dates spécifique, ajoutez les paramètres de requête `start-time` et `end-time` et leurs valeurs à l'URI. À l'aide de ces paramètres, vous pouvez spécifier les premières et dernières date et l'heure, au format ISO 8601 étendu, d'une plage de dates incluse pour récupérer les données. Utilisez une esperluette (&) pour séparer les paramètres.
Par exemple, la demande suivante extrait le nombre de points de terminaison uniques auxquels les messages ont été remis, par chacune des campagnes d'un projet, du 19 juillet 2019 au 26 juillet 2019 :
```
https://pinpoint.us-east-1.amazonaws.com/v1/apps/1234567890123456789012345example/kpis/daterange/unique-deliveries-grouped-by-campaign?start-time=2019-07-19T00:00:00Z&end-time=2019-07-26T23:59:59Z
```
Où :
+ `pinpoint.us-east-1.amazonaws.com` est le point de terminaison Amazon Pinpoint de la région AWS qui héberge le projet.
+ `1234567890123456789012345example` est l'identifiant unique du projet associé aux campagnes.
+ `unique-deliveries-grouped-by-campaign` est la valeur `kpi-name` de la métrique de campagne *endpoint deliveries (remises de points de terminaison)*. Cette métrique indique le nombre de points de terminaison uniques auxquels les messages ont été remis, pour chaque campagne.
+ `2019-07-19T00:00:00Z` est la première date et heure à laquelle récupérer les données, dans le cadre d'une plage de dates inclusive.
+ `2019-07-26T23:59:59Z` est la dernière date et heure auxquelles récupérer les données, dans le cadre d'une plage de dates inclusive.
------
#### [ AWS CLI ]
Pour interroger les données d'analyse de plusieurs campagnes à l'aide de AWS CLI, utilisez la **get-application-date-range-kpi** commande et spécifiez les valeurs appropriées pour les paramètres requis :
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id application-id ^
--kpi-name kpi-name
```
Où :
+ *application-id* est l'identifiant unique du projet associé aux campagnes.
+ *kpi-name*est la `kpi-name` valeur de la métrique à interroger.
Pour appliquer un filtre qui extrait les données d'une plage de dates spécifique, incluez les paramètres `start-time` et `end-time` et leurs valeurs dans votre requête. À l'aide de ces paramètres, vous pouvez spécifier les premières et dernières date et l'heure, au format ISO 8601 étendu, d'une plage de dates incluse pour récupérer les données. Par exemple, la demande suivante extrait le nombre de points de terminaison uniques auxquels les messages ont été remis, par chacune des campagnes d'un projet, du 19 juillet 2019 au 26 juillet 2019 :
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id 1234567890123456789012345example ^
--kpi-name unique-deliveries-grouped-by-campaign ^
--start-time 2019-07-19T00:00:00Z ^
--end-time 2019-07-26T23:59:59Z
```
Où :
+ `1234567890123456789012345example` est l'identifiant unique du projet associé à la campagne.
+ `unique-deliveries-grouped-by-campaign` est la valeur `kpi-name` de la métrique de campagne *endpoint deliveries (remises de points de terminaison)*. Cette métrique indique le nombre de points de terminaison uniques auxquels les messages ont été remis, pour chaque campagne.
+ `2019-07-19T00:00:00Z` est la première date et heure à laquelle récupérer les données, dans le cadre d'une plage de dates inclusive.
+ `2019-07-26T23:59:59Z` est la dernière date et heure auxquelles récupérer les données, dans le cadre d'une plage de dates inclusive.
------
#### [ SDK for Java ]
Pour interroger les données d'analyse de plusieurs campagnes à l'aide de AWS SDK pour Java, utilisez la **GetApplicationDateRangeKpiRequest** méthode de l'API [Application Metrics](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html). Spécifiez les valeurs appropriées pour les paramètres requis :
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("applicationId")
.withKpiName("kpiName")
```
Où :
+ *applicationId* est l'identifiant unique du projet associé aux campagnes.
+ *kpiName*est la `kpi-name` valeur de la métrique à interroger.
Pour appliquer un filtre qui extrait les données d'une plage de dates spécifique, incluez les paramètres `startTime` et `endTime` et leurs valeurs dans votre requête. À l'aide de ces paramètres, vous pouvez spécifier les premières et dernières date et l'heure, au format ISO 8601 étendu, d'une plage de dates incluse pour récupérer les données. Par exemple, la demande suivante extrait le nombre de points de terminaison uniques auxquels les messages ont été remis, par chacune des campagnes d'un projet, du 19 juillet 2019 au 26 juillet 2019 :
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("1234567890123456789012345example")
.withKpiName("unique-deliveries-grouped-by-campaign")
.withStartTime(Date.from(Instant.parse("2019-07-19T00:00:00Z")))
.withEndTime(Date.from(Instant.parse("2019-07-26T23:59:59Z")));
```
Où :
+ `1234567890123456789012345example` est l'identifiant unique du projet associé aux campagnes.
+ `unique-deliveries-grouped-by-campaign` est la valeur `kpi-name` de la métrique de campagne *endpoint deliveries (remises de points de terminaison)*. Cette métrique indique le nombre de points de terminaison uniques auxquels les messages ont été remis, pour chaque campagne.
+ `2019-07-19T00:00:00Z` est la première date et heure à laquelle récupérer les données, dans le cadre d'une plage de dates inclusive.
+ `2019-07-26T23:59:59Z` est la dernière date et heure auxquelles récupérer les données, dans le cadre d'une plage de dates inclusive.
------
Une fois que vous avez envoyé votre requête, Amazon Pinpoint renvoie les résultats de la requête dans une réponse JSON. La structure des résultats varie en fonction de la métrique que vous avez interrogée. Certaines mesures ne renvoient qu'une seule valeur. D'autres métriques renvoient plusieurs valeurs, regroupées selon un champ pertinent. Si une mesure renvoie plusieurs valeurs, la réponse JSON inclut un champ qui indique quel champ a été utilisé pour regrouper les données.
Par exemple, la métrique d'application des *remises de point de terminaison, regroupées par campagne* (`unique-deliveries-grouped-by-campaign`), utilisée dans les exemples précédents, renvoie plusieurs valeurs : le nombre de points de terminaison uniques auxquels les messages ont été remis, pour chaque campagne associée à un projet. Dans ce cas, la réponse JSON est la suivante :
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"EndTime":"2019-07-26T23:59:59Z",
"KpiName":"unique-deliveries-grouped-by-campaign",
"KpiResult":{
"Rows":[
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"80b8efd84042ff8d9c96ce2f8example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"123.0"
}
]
},
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"810c7aab86d42fb2b56c8c966example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"456.0"
}
]
},
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"42d8c7eb0990a57ba1d5476a3example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"789.0"
}
]
}
]
},
"StartTime":"2019-07-19T00:00:00Z"
}
}
```
Dans ce cas, le champ `GroupedBys` indique que les valeurs sont regroupées par ID de campagne (`CampaignId`).
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](analytics-query-results.md).
# 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.
## Conditions préalables
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](analytics-standard-metrics.md).
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](analytics-permissions.md).
# Interrogez les données Amazon Pinpoint pour les e-mails transactionnels
Pour interroger les données des messages électroniques transactionnels envoyés pour un projet, utilisez l'API [Application Metrics](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) et spécifiez les valeurs pour les paramètres requis suivants :
+ **application-id** : ID du projet, qui est l'identifiant unique du projet. Dans Amazon Pinpoint, les termes *projet* et *application* ont la même signification.
+ **kpi-name** : nom de la métrique à interroger. 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. 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](analytics-standard-metrics.md).
Vous pouvez également appliquer un filtre qui interroge les données pour une plage de dates spécifique. Si vous ne spécifiez pas de plage de dates, Amazon Pinpoint renvoie les données des 31 jours civils précédents. Pour filtrer les données selon différentes dates, utilisez les paramètres de plage de dates pris en charge pour spécifier les premières et dernières date et heure de la plage de dates. Les valeurs doivent être au format ISO 8601 étendu et utiliser le temps universel coordonné (UTC). Par exemple, `2019-09-06T20:00:00Z` pour le 6 septembre 2019 à 20h00 UTC. 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.
Les exemples suivants montrent comment interroger des données d'analyse pour des e-mails transactionnels à l'aide de l'API REST Amazon Pinpoint, AWS CLI du, et du. AWS SDK pour Java Vous pouvez utiliser n'importe quel kit SDK AWS pris en charge pour interroger les données d'analyse pour les messages transactionnels. Les AWS CLI exemples sont formatés pour Microsoft Windows. Pour Unix, Linux et macOS, remplacez le caractère caret (^) de continuation de ligne par une barre oblique inverse (\$1).
------
#### [ REST API ]
Pour interroger les données analytiques des e-mails transactionnels à l'aide de l'API REST Amazon Pinpoint, envoyez une demande HTTP(S) GET à l'URI des [Métriques d'application](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html). Dans l'URI, spécifiez les valeurs appropriées pour les paramètres de chemin requis :
```
https://endpoint/v1/apps/application-id/kpis/daterange/kpi-name
```
Où :
+ *endpoint*est le point de terminaison Amazon Pinpoint pour la AWS région qui héberge le projet.
+ *application-id* est l'identifiant unique du projet.
+ *kpi-name*est la `kpi-name` valeur de la métrique à interroger.
Tous les paramètres doivent être codés par URL.
Pour appliquer un filtre qui interroge les données pour une plage de dates spécifique, ajoutez les paramètres `start-time` et `end-time` et leurs valeurs à l'URI. À l'aide de ces paramètres, vous pouvez spécifier les premières et dernières date et l'heure, au format ISO 8601 étendu, d'une plage de dates incluse pour récupérer les données. Utilisez une esperluette (&) pour séparer les paramètres.
Par exemple, la demande suivante récupère le nombre de messages électroniques transactionnels envoyés pour un projet du 6 septembre 2019 au 13 septembre 2019 :
```
https://pinpoint.us-east-1.amazonaws.com/v1/apps/1234567890123456789012345example/kpis/daterange/txn-emails-sent?start-time=2019-09-06T00:00:00Z&end-time=2019-09-13T23:59:59Z
```
Où :
+ `pinpoint.us-east-1.amazonaws.com` est le point de terminaison Amazon Pinpoint de la région AWS qui héberge le projet.
+ `1234567890123456789012345example` est l'identifiant unique du projet.
+ `txn-emails-sent` est la valeur `kpi-name` de la métrique *sends (envois)* de l'application. Cette métrique indique le nombre de messages électroniques transactionnels envoyés pour un projet.
+ `2019-09-06T00:00:00Z` est la première date et heure à laquelle récupérer les données, dans le cadre d'une plage de dates inclusive.
+ `2019-09-13T23:59:59Z` est la dernière date et heure auxquelles récupérer les données, dans le cadre d'une plage de dates inclusive.
------
#### [ AWS CLI ]
Pour interroger les données d'analyse des e-mails transactionnels à l'aide de AWS CLI, utilisez la **get-application-date-range-kpi** commande et spécifiez les valeurs appropriées pour les paramètres requis :
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id application-id ^
--kpi-name kpi-name
```
Où :
+ *application-id* est l'identifiant unique du projet.
+ *kpi-name*est la `kpi-name` valeur de la métrique à interroger.
Pour appliquer un filtre qui interroge les données pour une plage de dates spécifique, ajoutez les paramètres `start-time` et`end-time` et leurs valeurs à votre requête. À l'aide de ces paramètres, vous pouvez spécifier les premières et dernières date et l'heure, au format ISO 8601 étendu, d'une plage de dates incluse pour récupérer les données. Par exemple, la demande suivante récupère le nombre de messages électroniques transactionnels envoyés pour un projet du 6 septembre 2019 au 13 septembre 2019 :
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id 1234567890123456789012345example ^
--kpi-name txn-emails-sent ^
--start-time 2019-09-06T00:00:00Z ^
--end-time 2019-09-13T23:59:59Z
```
Où :
+ `1234567890123456789012345example` est l'identifiant unique du projet.
+ `txn-emails-sent` est la valeur `kpi-name` de la métrique *sends (envois)* de l'application. Cette métrique indique le nombre de messages électroniques transactionnels envoyés pour un projet.
+ `2019-09-06T00:00:00Z` est la première date et heure à laquelle récupérer les données, dans le cadre d'une plage de dates inclusive.
+ `2019-09-13T23:59:59Z` est la dernière date et heure auxquelles récupérer les données, dans le cadre d'une plage de dates inclusive.
------
#### [ SDK for Java ]
Pour interroger les données d'analyse des e-mails transactionnels à l'aide de AWS SDK pour Java, utilisez la **GetApplicationDateRangeKpiRequest** méthode de l'API [Application Metrics](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html). Spécifiez les valeurs appropriées pour les paramètres requis :
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("applicationId")
.withKpiName("kpiName")
```
Où :
+ *applicationId* est l'identifiant unique du projet.
+ *kpiName*est la `kpi-name` valeur de la métrique à interroger.
Pour appliquer un filtre qui interroge les données pour une plage de dates spécifique, incluez les paramètres `startTime` et`endTime` et leurs valeurs dans votre requête. À l'aide de ces paramètres, vous pouvez spécifier les premières et dernières date et l'heure, au format ISO 8601 étendu, d'une plage de dates incluse pour récupérer les données. Par exemple, la demande suivante récupère le nombre de messages électroniques transactionnels envoyés pour un projet du 6 septembre 2019 au 13 septembre 2019 :
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("1234567890123456789012345example")
.withKpiName("txn-emails-sent")
.withStartTime(Date.from(Instant.parse("2019-09-06T00:00:00Z")))
.withEndTime(Date.from(Instant.parse("2019-09-13T23:59:59Z")));
```
Où :
+ `1234567890123456789012345example` est l'identifiant unique du projet.
+ `txn-emails-sent` est la valeur `kpi-name` de la métrique *sends (envois)* de l'application. Cette métrique indique le nombre de messages électroniques transactionnels envoyés pour un projet.
+ `2019-09-06T00:00:00Z` est la première date et heure à laquelle récupérer les données, dans le cadre d'une plage de dates inclusive.
+ `2019-09-13T23:59:59Z` est la dernière date et heure auxquelles récupérer les données, dans le cadre d'une plage de dates inclusive.
------
Une fois que vous avez envoyé votre requête, Amazon Pinpoint renvoie les résultats de la requête dans une réponse JSON. La structure des résultats varie en fonction de la métrique que vous avez interrogée. Certaines mesures ne renvoient qu'une seule valeur. Par exemple, la métrique d'application *envois* (`txn-emails-sent`), utilisée dans les exemples précédents, renvoie une seule valeur : le nombre d'e-mails transactionnels envoyés à partir d'un projet. Dans ce cas, la réponse JSON est la suivante :
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"EndTime":"2019-09-13T23:59:59Z",
"KpiName":"txn-emails-sent",
"KpiResult":{
"Rows":[
{
"Values":[
{
"Key":"TxnEmailsSent",
"Type":"Double",
"Value":"62.0"
}
]
}
]
},
"StartTime":"2019-09-06T00:00:00Z"
}
}
```
D'autres métriques renvoient plusieurs valeurs et regroupent les valeurs selon un champ pertinent. Si une mesure renvoie plusieurs valeurs, la réponse JSON inclut un champ qui indique quel champ a été 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](analytics-query-results.md).
# Interrogez les données Amazon Pinpoint pour les SMS transactionnels
Pour interroger les données des messages SMS transactionnels envoyés pour un projet, utilisez l'API des [métriques d'application](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) et spécifiez les valeurs pour les paramètres requis suivants :
+ **application-id** : ID du projet, qui est l'identifiant unique du projet. Dans Amazon Pinpoint, les termes *projet* et *application* ont la même signification.
+ **kpi-name** : nom de la métrique à interroger. 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. 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](analytics-standard-metrics.md).
Vous pouvez également appliquer un filtre qui interroge les données pour une plage de dates spécifique. Si vous ne spécifiez pas de plage de dates, Amazon Pinpoint renvoie les données des 31 jours civils précédents. Pour filtrer les données selon différentes dates, utilisez les paramètres de plage de dates pris en charge pour spécifier les premières et dernières date et heure de la plage de dates. Les valeurs doivent être au format ISO 8601 étendu et utiliser le temps universel coordonné (UTC). Par exemple, `2019-09-06T20:00:00Z` pour le 6 septembre 2019 à 20h00 UTC. 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.
Les exemples suivants montrent comment interroger des données d'analyse pour des messages SMS transactionnels à l'aide de l'API REST Amazon Pinpoint, AWS CLI du, et du. AWS SDK pour Java Vous pouvez utiliser n'importe quel AWS SDK compatible pour interroger les données d'analyse des messages transactionnels. Les AWS CLI exemples sont formatés pour Microsoft Windows. Pour Unix, Linux et macOS, remplacez le caractère caret (^) de continuation de ligne par une barre oblique inverse (\$1).
------
#### [ REST API ]
Pour interroger les données analytiques des messages SMS transactionnels à l'aide de l'API REST Amazon Pinpoint, envoyez une demande HTTP(S) GET à l'URI des [Métriques d'application](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html). Dans l'URI, spécifiez les valeurs appropriées pour les paramètres de chemin requis :
```
https://endpoint/v1/apps/application-id/kpis/daterange/kpi-name
```
Où :
+ *endpoint*est le point de terminaison Amazon Pinpoint pour la AWS région qui héberge le projet.
+ *application-id* est l'identifiant unique du projet.
+ *kpi-name*est la `kpi-name` valeur de la métrique à interroger.
Tous les paramètres doivent être codés par URL.
Pour appliquer un filtre qui extrait les données d'une plage de dates spécifique, ajoutez les paramètres de requête `start-time` et `end-time` et leurs valeurs à l'URI. À l'aide de ces paramètres, vous pouvez spécifier les premières et dernières date et l'heure, au format ISO 8601 étendu, d'une plage de dates incluse pour récupérer les données. Utilisez une esperluette (&) pour séparer les paramètres.
Par exemple, la demande suivante récupère le nombre de messages SMS transactionnels envoyés chaque jour du 6 septembre 2019 au 8 septembre 2019 :
```
https://pinpoint.us-east-1.amazonaws.com/v1/apps/1234567890123456789012345example/kpis/daterange/txn-sms-sent-grouped-by-date?start-time=2019-09-06T00:00:00Z&end-time=2019-09-08T23:59:59Z
```
Où :
+ `pinpoint.us-east-1.amazonaws.com` est le point de terminaison Amazon Pinpoint de la région AWS qui héberge le projet.
+ `1234567890123456789012345example` est l'identifiant unique du projet.
+ `txn-sms-sent-grouped-by-date` est la valeur `kpi-name` de la métrique *sends, grouped by date (envois, regroupés par date)* de l'application. Cette métrique renvoie le nombre de messages SMS transactionnels envoyés au cours de chaque jour de la plage de dates.
+ `2019-09-06T00:00:00Z` est la première date et heure à laquelle récupérer les données, dans le cadre d'une plage de dates inclusive.
+ `2019-09-08T23:59:59Z` est la dernière date et heure auxquelles récupérer les données, dans le cadre d'une plage de dates inclusive.
------
#### [ AWS CLI ]
Pour interroger les données d'analyse des messages SMS transactionnels à l'aide de AWS CLI, utilisez la **get-application-date-range-kpi** commande et spécifiez les valeurs appropriées pour les paramètres requis :
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id application-id ^
--kpi-name kpi-name
```
Où :
+ *application-id* est l'identifiant unique du projet.
+ *kpi-name*est la `kpi-name` valeur de la métrique à interroger.
Pour appliquer un filtre qui extrait les données d'une plage de dates spécifique, incluez les paramètres `start-time` et `end-time` et leurs valeurs dans votre requête. À l'aide de ces paramètres, vous pouvez spécifier les premières et dernières date et l'heure, au format ISO 8601 étendu, d'une plage de dates incluse pour récupérer les données. Par exemple, la demande suivante récupère le nombre de messages SMS transactionnels envoyés chaque jour du 6 septembre 2019 au 8 septembre 2019 :
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id 1234567890123456789012345example ^
--kpi-name txn-sms-sent-grouped-by-date ^
--start-time 2019-09-06T00:00:00Z ^
--end-time 2019-09-08T23:59:59Z
```
Où :
+ `1234567890123456789012345example` est l'identifiant unique du projet.
+ `txn-sms-sent-grouped-by-date` est la valeur `kpi-name` de la métrique *sends, grouped by date (envois, regroupés par date)* de l'application. Cette métrique renvoie le nombre de messages SMS transactionnels envoyés au cours de chaque jour de la plage de dates.
+ `2019-09-06T00:00:00Z` est la première date et heure à laquelle récupérer les données, dans le cadre d'une plage de dates inclusive.
+ `2019-09-08T23:59:59Z` est la dernière date et heure auxquelles récupérer les données, dans le cadre d'une plage de dates inclusive.
------
#### [ SDK for Java ]
Pour interroger les données d'analyse des messages SMS transactionnels à l'aide de AWS SDK pour Java, utilisez la **GetApplicationDateRangeKpiRequest** méthode de l'API [Application Metrics](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) et spécifiez les valeurs appropriées pour les paramètres requis :
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("applicationId")
.withKpiName("kpiName")
```
Où :
+ *applicationId* est l'identifiant unique du projet.
+ *kpiName*est la `kpi-name` valeur de la métrique à interroger.
Pour appliquer un filtre qui extrait les données d'une plage de dates spécifique, incluez les paramètres `startTime` et `endTime` et leurs valeurs dans votre requête. À l'aide de ces paramètres, vous pouvez spécifier les premières et dernières date et l'heure, au format ISO 8601 étendu, d'une plage de dates incluse pour récupérer les données. Par exemple, la demande suivante récupère le nombre de messages SMS transactionnels envoyés chaque jour du 6 septembre 2019 au 8 septembre 2019 :
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("1234567890123456789012345example")
.withKpiName("txn-sms-sent-grouped-by-date")
.withStartTime(Date.from(Instant.parse("2019-09-06T00:00:00Z")))
.withEndTime(Date.from(Instant.parse("2019-09-08T23:59:59Z")));
```
Où :
+ `1234567890123456789012345example` est l'identifiant unique du projet.
+ `txn-sms-sent-grouped-by-date` est la valeur `kpi-name` de la métrique *sends, grouped by date (envois, regroupés par date)* de l'application. Cette métrique renvoie le nombre de messages SMS transactionnels envoyés au cours de chaque jour de la plage de dates.
+ `2019-09-06T00:00:00Z` est la première date et heure à laquelle récupérer les données, dans le cadre d'une plage de dates inclusive.
+ `2019-09-08T23:59:59Z` est la dernière date et heure auxquelles récupérer les données, dans le cadre d'une plage de dates inclusive.
------
Une fois que vous avez envoyé votre requête, Amazon Pinpoint renvoie les résultats de la requête dans une réponse JSON. La structure des résultats varie en fonction de la métrique que vous avez interrogée. Certaines mesures ne renvoient qu'une seule valeur. D'autres métriques renvoient plusieurs valeurs et regroupent ces valeurs selon un champ pertinent. Si une mesure renvoie plusieurs valeurs, la réponse JSON inclut un champ qui indique quel champ a été utilisé pour regrouper les données.
Par exemple, la métrique d'application des *envois, regroupés par date* (`txn-sms-sent-grouped-by-date`) utilisée dans les exemples précédents, renvoie plusieurs valeurs : nombre de messages SMS transactionnels envoyés au cours de chaque jour de la plage de dates spécifiée. Dans ce cas, la réponse JSON est la suivante :
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"EndTime":"2019-09-08T23:59:59Z",
"KpiName":"txn-sms-sent-grouped-by-date",
"KpiResult":{
"Rows":[
{
"GroupedBys":[
{
"Key":"Date",
"Type":"String",
"Value":"2019-09-06"
}
],
"Values":[
{
"Key":"TxnSmsSent",
"Type":"Double",
"Value":"29.0"
}
]
},
{
"GroupedBys":[
{
"Key":"Date",
"Type":"String",
"Value":"2019-09-07"
}
],
"Values":[
{
"Key":"TxnSmsSent",
"Type":"Double",
"Value":"35.0"
}
]
},
{
"GroupedBys":[
{
"Key":"Date",
"Type":"String",
"Value":"2019-09-08"
}
],
"Values":[
{
"Key":"TxnSmsSent",
"Type":"Double",
"Value":"10.0"
}
]
}
]
},
"StartTime":"2019-09-06T00:00:00Z"
}
}
```
Dans ce cas, le champ `GroupedBys` indique que les valeurs sont regroupées par jour calendaire (`Date`). Cela signifie que :
+ 29 messages ont été envoyés le 6 septembre 2019.
+ 35 messages ont été envoyés le 7 septembre 2019.
+ 10 messages ont été envoyés le 8 septembre 2019.
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](analytics-query-results.md).
# Utiliser les résultats des requêtes JSON d'Amazon Pinpoint Analytics
Lorsque vous utilisez Amazon Pinpoint Analytics APIs pour interroger des données d'analyse, Amazon Pinpoint renvoie les résultats dans une réponse JSON. Pour les métriques d'application, de campagne et d'engagement du parcours, les données de la réponse sont conformes à un schéma JSON standard pour le reporting des données analytiques Amazon Pinpoint.
Cela signifie que vous pouvez utiliser le langage de programmation ou l'outil de votre choix pour implémenter une solution personnalisée qui interroge les données pour une ou plusieurs de ces mesures, capture les résultats de chaque requête, puis écrit les résultats dans une table, un objet ou un autre emplacement. Vous pouvez ensuite utiliser les résultats de la requête dans cet emplacement à l'aide d'un autre service ou application.
Par exemple, vous pouvez effectuer les actions suivantes :
+ Créez un tableau de bord personnalisé qui interroge régulièrement un ensemble de métriques et affiche les résultats à l'aide de votre infrastructure de visualisation de données préférée.
+ Créez un rapport qui suit les taux d'engagement en interrogeant les métriques appropriées et en affichant les résultats dans un graphique ou un autre type de rapport que vous concevez.
+ Analysez et écrivez les données analytiques dans un format de stockage particulier, puis portez les résultats vers une solution de stockage à long terme.
Notez qu'Amazon Pinpoint Analytics n'est APIs pas conçu pour créer ou stocker des objets persistants que vous pouvez ensuite lire ou utiliser dans un projet Amazon Pinpoint ou dans votre compte Amazon Pinpoint. Ils APIs sont plutôt conçus pour vous aider à récupérer des données analytiques et à les transférer vers d'autres services et applications pour une analyse, un stockage ou des rapports plus approfondis. Ils le font en partie en utilisant la même structure de réponse JSON et le même schéma pour toutes les données d'analyse que vous pouvez interroger par programmation pour les métriques d'application, de campagne et d'engagement du parcours.
Cette rubrique explique la structure, les objets et les champs d'une réponse JSON à une requête pour une métrique d'application, de campagne ou d'engagement du parcours. Pour de plus amples informations sur les champs d'une réponse JSON à une requête pour une métrique d'exécution du parcours ou d'exécution de l'activité du parcours, veuillez consulter [Mesures standard qui s'appliquent aux projets, campagnes et parcours Amazon Pinpoint](analytics-standard-metrics.md).
## Structure JSON
Pour vous aider à analyser et à utiliser les résultats des requêtes, Amazon Pinpoint APIs Analytics utilise la même structure de réponse JSON pour toutes les données d'analyse Amazon Pinpoint que vous pouvez interroger par programmation pour obtenir des statistiques d'application, des statistiques de campagne et des statistiques d'engagement sur le parcours. Chaque réponse JSON spécifie les valeurs ayant défini la requête, telles que l'ID de projet (`ApplicationId`). La réponse inclut également un (et un seul) objet `KpiResult`. L'objet `KpiResult` contient le jeu de résultats global d'une requête.
Chaque objet `KpiResult` contient un objet `Rows`. Il s'agit d'un tableau d'objets contenant des résultats de requête et des métadonnées pertinentes sur les valeurs de ces résultats. La structure et le contenu d'un objet `Rows` présentent les caractéristiques générales suivantes :
+ Chaque ligne de résultats de requête est un objet JSON distinct, nommé `Values`, dans l'objet `Rows`. Par exemple, si une requête renvoie trois valeurs, l'objet `Rows` contient trois objets `Values`. Chaque objet `Values` contient un résultat individuel pour la requête.
+ Chaque colonne de résultats de requête est une propriété de l'objet `Values` auquel elle s'applique. Le nom de la colonne est stocké dans le champ `Key` de l'objet `Values`.
+ Pour les résultats de requête groupés, chaque objet `Values` a un objet `GroupedBys` associé. L'objet `GroupedBys` indique quel champ a été utilisé pour regrouper les résultats. Il fournit également la valeur de regroupement de l'objet `Values` associé.
+ Si le résultat de la requête pour une métrique est nul, l'objet `Rows` est vide.
Au-delà de ces caractéristiques générales, la structure et le contenu de l'objet `Rows` varient en fonction de la métrique. En effet, Amazon Pinpoint prend en charge deux types de métriques, les *métriques à valeur unique* et les *métriques à valeur multiples*.
Une *métrique à valeur unique* ne fournit qu'une seule valeur cumulative. Un exemple est le pourcentage de messages remis aux destinataires par toutes les exécutions d'une campagne. Une *métrique à valeurs multiples* fournit plus d'une valeur et regroupe ces valeurs par un champ pertinent. Un exemple est le pourcentage de messages remis aux destinataires pour chaque exécution d'une campagne, regroupés par exécution de campagne.
Vous pouvez déterminer rapidement si une métrique est à valeur unique ou à valeur multiple en faisant référence à son nom. Si le nom ne contient pas `grouped-by`, il s'agit d'une métrique à valeur unique. Dans le cas contraire, il s'agit d'une métrique à plusieurs valeurs. Pour obtenir la liste complète des métriques que vous pouvez interroger par programme, reportez-vous à la section [Mesures standard qui s'appliquent aux projets, campagnes et parcours Amazon Pinpoint](analytics-standard-metrics.md).
### Métriques à valeur unique
Pour une métrique à valeur unique, l'objet `Rows` contient un objet `Values` qui :
+ spécifie le nom convivial de la mesure interrogée ;
+ fournit la valeur de la mesure interrogée ;
+ identifie le type de données de la valeur renvoyée.
Par exemple, la réponse JSON suivante contient les résultats de la requête pour une métrique à valeur unique. Cette métrique indique le nombre de points de terminaison uniques auxquels les messages ont été remis par toutes les campagnes associées à un projet, du 1er au 31 août 2019 :
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"EndTime":"2019-08-31T23:59:59Z",
"KpiName":"unique-deliveries",
"KpiResult":{
"Rows":[
{
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"1368.0"
}
]
}
]
},
"StartTime":"2019-08-01T00:00:00Z"
}
}
```
Dans cet exemple, la réponse indique que toutes les campagnes du projet ont remis des messages à 1 368 points de terminaison uniques du 1er au 31 août 2019, dans lesquels :
+ `Key` est le nom convivial de la métrique dont la valeur est spécifiée dans le champ `Value` (`UniqueDeliveries`).
+ `Type` est le type de données de la valeur spécifiée dans le champ `Value` (`Double`).
+ `Value` est la valeur réelle de la métrique interrogée, y compris les filtres appliqués (`1368.0`).
Si le résultat de la requête pour une métrique à valeur unique est null (pas supérieur ou égal à zéro), l'objet `Rows` est vide. Amazon Pinpoint renvoie une valeur nulle pour une métrique s'il n'y a aucune donnée à renvoyer pour cette métrique. Par exemple :
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"2345678901234567890123456example",
"EndTime":"2019-08-31T23:59:59Z",
"KpiName":"unique-deliveries",
"KpiResult":{
"Rows":[
]
},
"StartTime":"2019-08-01T00:00:00Z"
}
}
```
### Métriques à valeurs multiples
La structure et le contenu de l'objet `Rows` pour une métrique à valeurs multiples sont essentiellement les mêmes que ceux d'une métrique à valeur unique. L'objet `Rows` d'une métrique à valeurs multiples contient également un objet `Values`. L'objet `Values` spécifie le nom convivial de la métrique interrogée, fournit la valeur de cette métrique et identifie le type de données de cette valeur.
Toutefois, l'objet `Rows` objet d'une métrique à plusieurs valeurs contient également un ou plusieurs objets `GroupedBy`. Il y a un objet `GroupedBy` pour chaque objet `Values` des résultats de la requête. L'objet `GroupedBy` indique quel champ a été utilisé pour regrouper les données dans les résultats et le type de données de ce champ. Il indique également la valeur de regroupement pour ce champ (pour l'objet `Values` associé).
Par exemple, la réponse JSON suivante contient les résultats de la requête pour une mesure à valeurs multiples qui indique le nombre de points de terminaison uniques auxquels les messages ont été remis, pour chaque campagne associée à un projet, du 1er août 2019 au 31 août 2019 :
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"EndTime":"2019-08-31T23:59:59Z",
"KpiName":"unique-deliveries-grouped-by-campaign",
"KpiResult":{
"Rows":[
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"80b8efd84042ff8d9c96ce2f8example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"123.0"
}
]
},
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"810c7aab86d42fb2b56c8c966example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"456.0"
}
]
},
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"42d8c7eb0990a57ba1d5476a3example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"789.0"
}
]
}
]
},
"StartTime":"2019-08-01T00:00:00Z"
}
}
```
Dans cet exemple, la réponse indique que trois des campagnes du projet ont transmis des messages à des points de terminaison uniques du 1er août 2019 au 31 août 2019. Pour chacune de ces campagnes, la ventilation du nombre de livraisons est la suivante :
+ La campagne `80b8efd84042ff8d9c96ce2f8example` a envoyé des messages à 123 points de terminaison uniques.
+ La campagne `810c7aab86d42fb2b56c8c966example` a envoyé des messages à 456 points de terminaison uniques.
+ La campagne `42d8c7eb0990a57ba1d5476a3example` a envoyé des messages à 789 points de terminaison uniques.
Lorsque la structure générale des objets et des champs est :
+ `GroupedBys.Key` : nom de la propriété ou du champ qui stocke la valeur de regroupement spécifiée dans le champ `GroupedBys.Value` (`CampaignId`).
+ `GroupedBys.Type` : type de données de la valeur spécifiée dans le champ `GroupedBys.Value` (`String`).
+ `GroupedBys.Value` : valeur réelle du champ utilisé pour regrouper les données, comme spécifié dans le champ `GroupedBys.Key` (ID de campagne).
+ `Values.Key` : nom convivial de la métrique dont la valeur est spécifiée dans le champ `Values.Value` (`UniqueDeliveries`).
+ `Values.Type` : type de données de la valeur spécifiée dans le champ `Values.Value` (`Double`).
+ `Values.Value` : valeur réelle de la métrique interrogée, y compris les filtres appliqués.
Si le résultat de la requête pour une métrique à valeurs multiples est null (pas supérieur ou égal à zéro) pour un projet, une campagne ou une autre ressource spécifique, Amazon Pinpoint ne renvoie aucun objet ou champ pour la ressource. Si le résultat de la requête pour une métrique à valeurs multiples est null pour toutes les ressources, Amazon Pinpoint renvoie un objet `Rows` vide.
## Objets et champs JSON
Outre la spécification des valeurs ayant défini une requête, telles que l'ID de projet (`ApplicationId`), chaque réponse JSON à une requête pour une métrique d'application, de campagne ou d'engagement du parcours inclut un objet `KpiResult`. Cet objet contient le jeu de résultats global d'une requête, que vous pouvez analyser pour envoyer les données d'analyse à un autre service ou application. Chaque objet `KpiResult` contient une partie ou la totalité des objets et champs standard suivants, selon la métrique.
| Objet ou champ | Description |
| --- | --- |
| Rows | Tableau d'objets contenant le jeu de résultats d'une requête. |
| Rows.GroupedBys | Pour une métrique à valeurs multiples, un tableau de champs qui définit le champ et les valeurs utilisées pour regrouper des données dans les résultats de la requête. |
| Rows.GroupedBys.Key | Pour une métrique à valeurs multiples, nom de la propriété ou du champ qui stocke la valeur spécifiée dans le champ GroupedBys.Value. |
| Rows.GroupedBys.Type | Pour une métrique à valeurs multiples, type de données de la valeur spécifiée dans le champ GroupedBys.Value. |
| Rows.GroupedBys.Value | Pour une métrique à plusieurs valeurs, la valeur réelle du champ utilisé pour regrouper des données dans les résultats de la requête. Cette valeur est en corrélation avec un objet Values associé. |
| Rows.Values | Tableau de champs contenant les résultats de la requête. |
| Rows.Values.Key | Le nom convivial de la mesure interrogée. La valeur de la métrique est spécifiée dans le champ Values.Value. |
| Rows.Values.Type | Type de données de la valeur spécifiée dans le champ Values.Value. |
| Rows.Values.Value | Valeur réelle de la métrique interrogée, y compris les filtres appliqués. |
Pour de plus amples informations sur les champs d'une réponse JSON à une requête pour une métrique d'exécution du parcours ou d'exécution de l'activité du parcours, veuillez consulter [Mesures standard qui s'appliquent aux projets, campagnes et parcours Amazon Pinpoint](analytics-standard-metrics.md).