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.

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.

Prérequis

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.

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.