Comment importer automatiquement les statistiques NewsMAN dans Google Sheets

Si vous souhaitez créer régulièrement des rapports pour vos clients, vous pouvez importer automatiquement les données de NewsMAN dans Google Sheets. Vous disposez ainsi, au même endroit, des statistiques de vos newsletters, de l’évolution de vos abonnés et de vos automatisations, sans avoir à exporter manuellement les données à chaque fois.

Grâce à l’API NewsMAN, vous pouvez importer dans Google Sheets les types de statistiques suivants :

• Statistiques des newsletters – newsletters envoyées, ouvertures, clics, désabonnements, signalements comme spam et autres données disponibles ;
• Évolution des abonnés – nouveaux abonnés et désabonnements sur une période donnée ;
• Statistiques des automatisations – données agrégées pour les automatisations d’une liste.

Ce dont vous avez besoin

Pour effectuer la configuration, vous avez besoin :

• d’un compte NewsMAN ;
• d’un accès à la section API de votre compte ;
• d’un USER_ID, d’un API_KEY et d’un LIST_ID ;
• d’une feuille Google Sheets dans Google Drive.

1. Importer les statistiques des newsletters dans Google Sheets

Pour les statistiques des newsletters, vous pouvez utiliser la méthode API newsletter.all.

Exemple d’URL :

https://ssl.newsman.app/api/1.2/rest/USER_ID/API_KEY/newsletter.all.csv?list_id=LIST_ID&days=90&status=all

Remplacez USER_ID, API_KEY et LIST_ID par les valeurs correspondant à votre compte et à votre liste.

Comment configurer Google Sheets

1. Créez un Google Sheet dans Google Drive.
2. Sélectionnez la cellule dans laquelle vous souhaitez afficher les données.
3. Saisissez la formule IMPORTDATA en utilisant l’URL de l’API :

=IMPORTDATA("https://ssl.newsman.app/api/1.2/rest/USER_ID/API_KEY/newsletter.all.csv?list_id=LIST_ID&days=90&status=all")

4. Si Google Sheets vous demande l’autorisation d’importer des données provenant d’une source externe, accordez l’accès nécessaire.

Les données des newsletters seront alors importées automatiquement dans la feuille.

Quelles données pouvez-vous utiliser dans votre rapport ?

Les données importées peuvent être utilisées pour créer des rapports réguliers sur les performances des newsletters, avec notamment :

• le nombre de newsletters envoyées ;
• les ouvertures ;
• les clics ;
• les désabonnements ;
• les signalements comme spam ;
• les autres statistiques disponibles via la méthode API.

2. Suivre l’évolution des abonnés

Pour suivre l’évolution du nombre d’abonnés d’une liste, utilisez la méthode list.subscribersEvolution.

Exemple :

https://ssl.newsman.app/api/1.2/rest/USER_ID/API_KEY/list.subscribersEvolution.json?list_id=LIST_ID&start_date=2025-05-01&stop_date=2025-05-31

Vous pouvez définir la période d’analyse à l’aide des paramètres suivants :

• start_date – date de début ;
• stop_date – date de fin ;
• list_id – liste pour laquelle vous souhaitez obtenir les statistiques.

Pour utiliser les données dans Google Sheets, utilisez la version CSV de la méthode :

list.subscribersEvolution.csv

Il suffit de remplacer .json par .csv dans l’URL de l’API.

Les données peuvent ensuite être importées dans Google Sheets à l’aide de la même méthode IMPORTDATA.

3. Importer les statistiques des automatisations

Pour créer des rapports sur les automatisations, vous pouvez utiliser la méthode :

automation.stats

Elle permet de récupérer des statistiques agrégées par jour pour :

• toutes les automatisations d’une liste ;
• ou uniquement certaines automatisations.

Pour Google Sheets, utilisez le format CSV plutôt que le format JSON.

Par exemple, si l’endpoint JSON est :

automation.stats.json

utilisez :

automation.stats.csv

Comme pour les statistiques des newsletters et l’évolution des abonnés, l’URL CSV peut être utilisée avec la formule IMPORTDATA dans Google Sheets.

4. Formats API recommandés pour Google Sheets

Lorsque vous importez directement les données dans Google Sheets, utilisez les versions CSV des méthodes API :

Type de statistiques	Méthode pour Google Sheets
Statistiques des newsletters	newsletter.all.csv
Évolution des abonnés	list.subscribersEvolution.csv
Statistiques des automatisations	automation.stats.csv

Le format CSV permet à Google Sheets d’importer directement les données sous forme de tableau à l’aide de la fonction IMPORTDATA.

5. À quelle fréquence les données sont-elles mises à jour ?

Une fois la formule IMPORTDATA configurée, Google Sheets actualise automatiquement les données importées. Dans des conditions normales, les données peuvent être actualisées environ toutes les 15 minutes, mais la fréquence réelle dépend de Google Sheets et peut varier.

Vous n’avez donc pas besoin d’effectuer manuellement une nouvelle exportation à chaque création de rapport.

---

Configuration recommandée pour les rapports mensuels

Si vous envoyez des rapports mensuels à vos clients, vous pouvez organiser votre Google Sheet en plusieurs onglets, par exemple :

• Newsletters – performances des campagnes envoyées ;
• Abonnés – évolution de la base d’abonnés ;
• Automatisations – performances des automatisations ;
• Rapport – principaux indicateurs à présenter au client.

De cette manière, les données NewsMAN peuvent alimenter automatiquement un rapport centralisé, tandis que Google Sheets peut être utilisé pour le filtrage, l’analyse, la création de graphiques et la présentation des résultats au client.

En résumé

Pour importer les statistiques NewsMAN dans Google Sheets :

1. Copiez l’URL API correspondant aux statistiques dont vous avez besoin.
2. Utilisez la version .csv de la méthode.
3. Créez un Google Sheet.
4. Utilisez la formule IMPORTDATA("URL_API").
5. Autorisez l’importation de données externes si Google Sheets vous le demande.
6. Utilisez les données importées pour vos rapports et analyses réguliers.

Vous pouvez ainsi mettre en place un système simple de reporting automatisé des performances de l’email marketing, sans avoir à exporter manuellement les données pour chaque période.