Dacă vrei să creezi periodic rapoarte pentru clienți, poți importa automat datele din NewsMAN într-un Google Sheets. Astfel, ai într-un singur document statistici despre newslettere, evoluția abonaților și performanța automatizărilor, fără să fie nevoie să exporți manual datele de fiecare dată.
Prin API-ul NewsMAN poți aduce în Google Sheets următoarele tipuri de statistici:
- statistici newslettere – newslettere trimise, open rate, click-uri, dezabonări, spam și alte date disponibile;
- evoluția abonaților – abonați noi și dezabonați într-o anumită perioadă;
- statistici automatizări – date agregate pentru automatizările dintr-o listă.
Ce ai nevoie
Pentru configurare ai nevoie de:
- un cont NewsMAN;
- acces la secțiunea API din cont;
- un USER_ID, API_KEY și LIST_ID;
- un Google Sheet în Google Drive.
1. Importă statisticile newsletterelor în Google Sheets
Pentru statisticile newsletterelor poți folosi metoda API newsletter.all.
Un exemplu de URL este:
https://ssl.newsman.app/api/1.2/rest/USER_ID/API_KEY/newsletter.all.csv?list_id=LIST_ID&days=90&status=all
Valorile USER_ID, API_KEY și LIST_ID trebuie înlocuite cu datele corespunzătoare contului și listei tale.
Cum configurezi Google Sheets
- Creează un Google Sheet în Google Drive.
- Selectează celula în care vrei să apară datele.
- Introdu formula
IMPORTDATA, folosind URL-ul 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")
- Dacă Google Sheets solicită permisiunea de a importa date dintr-o sursă externă, acordă accesul necesar.
Datele newsletterelor vor fi importate automat în foaie.
Ce poți folosi în raport
Datele importate pot fi folosite pentru rapoarte periodice despre performanța newsletterelor, inclusiv indicatori precum:
- numărul de newslettere trimise;
- deschideri;
- click-uri;
- dezabonări;
- raportări ca spam;
- alte statistici returnate de metoda API.
2. Urmărește evoluția abonaților
Pentru a vedea cum evoluează numărul de abonați dintr-o listă, folosește metoda list.subscribersEvolution.
Exemplu:
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
URL-ul permite definirea perioadei analizate prin parametrii:
start_date– data de început;stop_date– data de sfârșit;list_id– lista pentru care vrei statisticile.
Pentru utilizarea datelor în Google Sheets, folosește varianta CSV a metodei:
list.subscribersEvolution.csv
Astfel, extensia .json din URL este înlocuită cu .csv.
Datele pot fi apoi importate în Google Sheets folosind aceeași metodă IMPORTDATA.
3. Importă statisticile automatizărilor
Pentru rapoarte despre automatizări poți folosi metoda:
automation.stats
Aceasta permite preluarea unor statistici agregate pe zile pentru:
- toate automatizările dintr-o listă;
- sau doar anumite automatizări.
Pentru Google Sheets trebuie folosit formatul CSV, nu JSON.
Prin urmare, dacă endpoint-ul este disponibil în format JSON ca:
automation.stats.json
pentru import în Google Sheets vei folosi:
automation.stats.csv
La fel ca în cazul statisticilor newsletterelor și al evoluției abonaților, URL-ul CSV poate fi folosit în formula IMPORTDATA din Google Sheets.
4. Formatele API recomandate pentru Google Sheets
Atunci când imporți datele direct în Google Sheets, folosește variantele CSV ale metodelor API:
| Tip statistică | Metodă pentru Google Sheets |
|---|---|
| Statistici newslettere | newsletter.all.csv |
| Evoluția abonaților | list.subscribersEvolution.csv |
| Statistici automatizări | automation.stats.csv |
Formatul CSV este necesar deoarece Google Sheets poate importa direct datele tabelare cu ajutorul funcției IMPORTDATA.
5. Cât de des se actualizează datele?
După configurarea formulei IMPORTDATA, Google Sheets reîmprospătează automat datele importate. În mod obișnuit, actualizarea poate avea loc la aproximativ 15 minute, însă frecvența efectivă este controlată de Google Sheets și poate varia.
Prin urmare, nu este necesar să refaci manual exportul pentru fiecare raport.
Recomandare pentru rapoarte lunare
Dacă trimiți clienților rapoarte lunar, poți organiza Google Sheet-ul în mai multe foi, de exemplu:
- Newslettere – performanța campaniilor trimise;
- Abonați – evoluția bazei de abonați;
- Automatizări – performanța automatizărilor;
- Raport – indicatorii principali pe care vrei să îi prezinți clientului.
În acest fel, datele din NewsMAN pot alimenta automat un raport centralizat, iar tu poți folosi Google Sheets pentru filtrare, analiză, grafice și prezentarea rezultatelor către client.
Pe scurt
Pentru a importa statistici NewsMAN în Google Sheets:
- Copiază URL-ul API corespunzător statisticilor de care ai nevoie.
- Folosește varianta
.csva metodei. - Creează un Google Sheet.
- Folosește formula
IMPORTDATA("URL_API"). - Acordă permisiunea pentru importul datelor externe, dacă este solicitată.
- Folosește datele importate pentru rapoarte și analize periodice.
Astfel, poți construi un sistem simplu de raportare automată a statisticilor de email marketing, fără exporturi manuale pentru fiecare perioadă.