Az alábbi bejegyzésben bemutatjuk, hogyan lehet a SalesAutopilot API segítségével statisztikákat lekérdezni az elküldött emailekről.
⚠ Az alábbi Tudásbázis bejegyzés a fejlesztőknek szánt dokumentáció része, ezért használata fejlesztésben jártas szakemberek számára ajánlott. A leírtakkal kapcsolatban felmerülő kérdések, elakadások vizsgálata túlmutat az általános ügyfélszolgálati támogatás keretein, ezért ebben a prémium támogatás keretein belül tudunk segítséget nyújtani. Javasoljuk, hogy kérdésiddel és elakadásaiddal keress fel egy programozásban jártas szakembert.
Bejegyzés tartalma
- Adott időszakban elküldött levelek lekérdezése
- Adott levél összesített eredményének lekérdezése
- Adott levélhez kapcsolódó eseményeinek tételes lekérdezése
Adott időszakban elküldött levelek lekérdezése
A metódus a paraméterként átadott időszakban elküldött levelek azonosítóit adja vissza JSON tömbben.
Kérés
GET
https://api.salesautopilot.com/sentemailids/<start_date>/<end_date>
|
Paraméterek |
Leírás |
<start_date> |
Lekérdezendő időszak kezdete YYYYMMDD formátumban |
<end_date> |
Lekérdezendő időszak vége YYYYMMDD formátumban. |
Válasz
Válasz sikeres hívás esetén a levelek azonosítói tömbben:
[34512,45678,56789]
Válasz hiba esetén:
200-astól eltérő http code
Adott levél összesített eredményének lekérdezése
A levél azonosítója alapján visszaadja a levélhez tartozó összesített eredményeket időzítésenkénti bontásban. Fontos: a metódus visszaadja az 1 évnél régebbi eredményeket is, amelyek a szoftver kezelőfelületén már nem jelennek meg.
Kérés
GET
https://api.salesautopilot.com/sendlogsummary/<letterid>
|
Paraméterek |
Leírás |
<letterid> |
A levél azonosítója, amely eredményeit le szeretné kérdezni. A levél azonosítóját pl. a sentemailids metódussal tudja kinyerni. |
Válasz sikeres hívás esetén
[{"send_id": "12345",
"subject":"Tárgy mező",
"listid":"3320",
"scheduletime":"2016-02-18 12:00:00",
"emailssent": "1240",
"bounced":"25",
"opened":"870",
"clicked":"340",
"unsubscribed":"3"}]
Válasz hiba esetén
200-astól eltérő http code
Adott levélhez kapcsolódó eseményeinek tételes lekérdezése
A levél azonosítója alapján visszaadja a levélhez tartozó eseményeket időrendi sorrendben.
GET
https://api.salesautopilot.com/sendloglist/<letterid>
|
Paraméterek |
Leírás |
<letterid> |
A levél azonosítója, amely eredményeit le szeretné kérdezni. A levél azonosítóját pl. a sentemailids metódussal tudja kinyerni. |
Válasz sikeres hívás esetén
[{"subscriberid":"3456",
"email":"teszt@emesz.hu",
"listid":"3320",
"eventtime":"2016-02-18 17:17:00",
"eventtype":"send",
"attribute":""},
{"subscriberid":"3456",
"email":"teszt@emesz.hu",
"listid":"3320",
"eventtime":"2016-02-18 17:25:10",
"eventtype":"open",
"attribute":""},
{"subscriberid":"3456",
"email":"teszt@emesz.hu",
"listid":"3320",
"eventtime":"2016-02-18 17:17:00",
"eventtype":"click",
"attribute":"http://www.teszt.hu"}]
Magyarázat
- eventtime: Az esemény timestamp-je YYYY-MM-DD hh:mm:ss formátumban.
- eventtype: Az esemény típusa. Értékei a következő lehetnek:
- send: levélküldés
- open: levélmegnyitás
- click: levélből történő átkattintás. Ebben az esetben az attribute kulcs tartalmazza a link URL-jét.
- unsub: leiratkozás
Válasz hiba esetén
200-astól eltérő http code
Hozzászólások
0 hozzászólás
A cikkhez nem írhatók újabb hozzászólások.