You can send clicks to EMMA via API without your redirect pass through our server.
For send clicks to EMMA is available the url https://eat.emmasolutions.net/click/ which is able to collect the following information from the clicks.
Campaign parameters:
| Parameter | Description | Mandatory | GET | POST |
| entw | EMMA campaign ID | YES | entw= | entw : |
| camid | An extra custom identifier like the campaign IS | camid= | extra : {camid : } | |
| eat_sub[NUM] | Where [NUM] is an integer from 1 to 25. | eat_sub[NUM]= | extra : {eat_sub[NUM]:} | |
| click_time | Date and hour of click (YYYY-MM-DD HH:MM:SS in Europe/Madrid) | click_time= | click_time : |
Device parameters:
| Parameter | Descrpiption | Mandatory | GET | POST |
| ip | Device IP | YES | device_ip= | device : {ip : } |
| longitude | GPS coordinate | device_longitude= | device : {longitude : } | |
| latitude | GPS coordinate | device_latitude= | device : {latitude :} | |
| city | City | device_city= | device : {city : } | |
| country | Country | device_country= | device : {country :} | |
| model | Device model, examples: iPhone, GT-I9305, Nexus 5, iPad | YES* | device_model= | device : {model : } |
| operative system | Devie OS, examples: iOS 9.0.1, iOS 5.0, Android 7.0.1, Android 5.0 | YES* | device_os= | device : {os : } |
| user agent | User-Agent | YES** | device : {ua : } | |
| idfa | IDFA in an iOS device | device_idfa= | device : {idfa : } | |
| idfv | VendorID in an iOS device | device_idfv= | device : {idfv : } | |
| advertising ID | Advertising ID in an Android device | device_adid | device : {adid : } |
(*) y (**) User-agent is only available in method POST. If you send the user-agent you can skip send "model" and "os for device".
EMMA Response
EMMA can respond in 3 ways:
- "200. OK". Click saved correctly.
- "400. Bad Request". Wrong request.
- "404. Not Found". Parameter entw is not an EMMA campaign ID.
GET Examples:
- GET https://eat.emmasolutions.net/click/?entw=6f92479ad48ca86c8de925b1ec4b8636&device_model=LG-H805&device_os=Android 5.0&device_ip=1.2.3.4&device_adid=e93da5f7-xxxx-4d7f-yyyy-db51b3a75455&click_time=2018-03-04 14:03:05&eat_sub2=prueba
- GET https://eat.emmasolutions.net/click/?entw=6f92479ad48ca86c8de925b1ec4b8636&device_model=iPhone&device_os=iOS 11.0&device_ip=1.2.3.4
POST examples:
{
"entw":"af0b8725fb55ce2009cdc46481f65bf5",
"device": {
"model": "iPhone",
"os": "iOS 11.0",
"ip": "1.2.3.4",
"city": "Baiona"
},
"extra": {
"camid":"mycampaign"
}
}
{
"entw":"af0b8725fb55ce2009cdc46481f65bf5",
"device": {
"ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 11_0 like Mac OS X) AppleWebKit/604.1.38 (KHTML, like Gecko) Version/11.0 Mobile/15A356 Safari/604.1",
"ip": "1.2.3.4",
},
"click_time": "2018-03-01 12:00:21"
}
0 Comments