A legutóbbi fejlesztői találkozón már említettük, hogy szeretnénk lehetőséget teremteni arra, hogy aktivizálni tudjátok az alkalmazásaitok jelenleg passzív felhasználóit. Ennek a rendszer szintű feltételeit sikerült elkészítenünk, innentől ez az eszköz is rendelkezésetekre áll, hogy fenntarthassátok a felhasználóitok figyelmét.
A hírlevélküldés általános feltételei
(Ezzel frissítettük a Felhasználói Útmutató VI. pontját is)
• Az alkalmazásoknak lehetőségük van az alkalmazást felvett felhasználóknak bármilyen interakció nélkül értesítést (hírlevelet) küldeni.
• Ez esetben az értesítés feladójának közvetlenül az alkalmazást kell megjelölni.
• A hírlevélküldés szövegezését és tervezett időpontját előzetesen egyeztetni kell a dev@iwiw.hu címen.
• A hírlevél az alkalmazás nevében kerül kiküldésre, ezen kívül minden, az értesítések szövegezésére vonatkozó kritérium itt is érvényes.
• Az értesítés nem tartalmazhat külső oldalra mutató hivatkozást, kizárólag az adott alkalmazásra, vagy más iWiW-es alkalmazásokra mutathat (keresztpromóció).
• Az értesítés nem tartalmazhat külső oldalt promótáló szöveges hirdetést (link nélkül sem), kizárólag az adott alkalmazást, vagy más iWiW-en található alkalmazást, vagy annak funkcióit, újdonságait, akcióit népszerűsítheti.
• Amennyiben az alkalmazáshoz iWiW-es klub is társul az erre irányuló promóció egyedi megállapodás kérdése.
• Egy hónapban egy alkalmazás legfeljebb egyszer küldhet hírlevelet.
• Egy felhasználó egy alkalmazástól egy hónapban legfeljebb egy hírlevelet kaphat.
• Ha a felhasználó letiltotta az alkalmazás számára az értesítésküldést, a hírlevél nem fog hozzá megérkezni. Mivel ez a vizsgálat aszinkron, a küldéskor nem érkezik hibaüzenet, az értesítések célba érése ilyen módon nem mérhető.
A hírlevélküldés előtti egyeztetés mindenképp szükséges. Ennek okai például, hogy a jelenleg az alkalmazásokhoz globálisan beállított limitek megakadályozhatják, hogy ennyi értesítést küldjetek egy időben (ezeket a limiteket időlegesen megemeljük az épp hírlevelet küldő alkalmazásnak), illetve azt is el szeretnénk kerülni, hogy a küldés időpontja egybeessen egy éppen zajló release-zel.
A hírlevélküldés mikéntje
Hírlevélküldésre a saját backend-eteket használjátok, tehát szerver oldalról küldjétek ki az értesítéseket a felhasználóitoknak. Ehhez a REST API-t használhatjátok 2 lábas OAUTH autentikáción keresztül.
A Fejlesztői Wikin találtok részletes leírást a szolgáltatásról, annak limitációiról, illetve PHP példakódot, amely tartalmazza az autentikációs lépéseket is. Így itt álljon csak egy egyszerű példa a Social API-n keresztül történő értesítésküldésre.
Példa – “Hello!” üzenet küldése “sandbox.iwiw.hu:m9VGWkh2″ azonosítójú felhasználónak:
POST http://api.sandbox.iwiw.hu/social/connect/rest/messages/@me/@outbox
Content-Type: application/json
{
"body": "Hello!",
"recipients": ["sandbox.iwiw.hu:m9VGWkh2"],
“type”: “notification”
}
REST-es notification-küldés esetén (egyelőre) szintén csak egy címzettet adhattok meg egyszerre, így kénytelenek vagytok ciklust használni az értesítések kiküldésére. A ciklus miatt sajnos nagymértékben megnövekedik a kérések feldolgozásának ideje, így azt javasoljuk, hogy ne egybe küldjétek ki az összes értesítést (lásd lentebb: Esettanulmány rész).
Az elküldött értesítés nem fog megérkezni a címzetthez, ha az letiltotta az alkalmazások hozzáférését az adataihoz (API főkapcsoló) vagy ha nem engedélyezte az alkalmazásnak az értesítésküldést. Ezek vizsgálata azonban aszinkron módon történik, így ezen esetekben nem fogtok hibaüzenet kapni. Ha szeretnétek mérni, hogy hány felhasználót sikerült a kiküldött hírlevéllel aktivizálni, helyezzetek el egy paraméteres linke(ke)t az értesítés szövegében az alkalmazás canvas-ára, canvas-on pedig hozzatok létre egy számlálót, ami ezt a paramétert számolja.
Esettanulmány
A tömeges értesítésküldést a Csajok és Pasik alkalmazás segítségével teszteltük élesben, akiknek ezúton is köszönjük az együttműködést! Az alábbi statisztikai adatok az ő méréseik eredménye.
• Kiküldött értesítések száma: 359.681 (Csak azoknak küldtek értesítést, akik még nem álltak át az új rendszerükre.)
• Akik átkattintottak az értesítésből canvas-ra: 95.611 (Ez 30%-os átkattintási arány!)
• Átlagosan 5 perc 10.000 értesítést sikerült kiküldeni.
• Az összes notification 5 adagban lett kiküldve.
Legutóbbi hozzászólások