How to send in-app/ in-web/ in-ad events to ADAMIANI platform.
Overview
ADAMIANI platform has a robust event and audience API. Advertisers can send specific events directly to ADAMIANI and use the powerful and flexible audience segmentation feature to create and target different user cohorts
Base URL
https://api-events.eventstracker.io/v1/ev?
Query Parameters
tp=direct&api_key={api_key}&idfa={IDFA}&gaid={GAID}&os={OS}&activity_kind={activity_kind}&package_name={app_package_name}&app_event={app_event}&event_items={event_items_JSON}&can_claim={0/1}&view_through={0/1}&bid_id{CLICK_ID}&ip=&country_code=&city=&is_reengagement={0/1}&revenue_USD={revenue_in_usd}&idfv={idfv}&event_ts={event_ts}c0=&c1=&c2=
| Parameters | Required | Description |
|---|---|---|
| api_key | Yes | Unique api key for your account/ app/website. You can get this api_key from Adamiani UI |
| idfa | Preferred | iOS unique IDFA |
| gaid | Preferred | Google unique advertising ID |
| idfv | Preferred | iOS unique identifier by a publisher |
| os | Preferred | android/IOS |
| activity_kind | No | Type of event. For eg; event, install, impression |
| package_name | No | Android app bundle name/ IOS app store ID |
| app_event | Yes | Name of the event that you have recorded. eg: app_open, registration, purchase etc |
| event_items | No | For any event, you can pass multiple event in a JSON format. Eg: in case of purchase of an item, you can pass attribute like price, product_id, colour, currency etc. Nested JSON must be URL encoded string of array of JSON. For multiple attributes JSON is preferred. For single attribute this can be string as well. event_items JSON should be encoded (ref eg below) |
| can_claim | Yes | 0 (default attribute)- Unattributed
event 1- attributed event. |
| view_through | No | 0 (default value)- click based
attribution 1- Impression based attribution |
| bid_id | Yes | Pass through parameter. Pass the click_id that was recorded when the user clicked on ad. |
| is_reengagement | No | 0-it's not a re-engagement event 1- it's a re-engagement event |
| event_ts | Preferred | Timestamp the event occurred. |
| revenue_USD | Yes | Revenue generated in USD from an event for eg. a purchase event. If revenue is generated in other currency, use below 2 fields instead. |
| revenue | No | Revenue generated from an event for eg. a purchase event |
| currency | No | Currency in ISO - 4217 format |
| c0, c1, c2 | No | Generic pass through variables. Use these parameters for passing value of custom value. |
Sample Api End Point
https://api-events.eventstracker.io/v1/ev?tp=direct&api_key=f8f2036f1704d106dc916f692826b497686a03e5&idfa=D3F15CAE-B2DB-4FZD-9B34-X78C88C81538&gaid=&os=ios&activity_kind=event&package_name=com.app.package&app_event=purchase&can_claim=1&view_through=0&bid_id=892501
088-1552511436&ip=172.58.104.88&country_code=US&city=Dallas&is_reengagement=1&c0=&c1=&c2=&event_items=%5B%7B%22currency%22%3A%22USD%22
%2C%20%22revenue%22%3A%200.02190650151%7D%5D
Image Native Ads
Native is an ad format where the ad experience follow the natural form and function of the location in which it is placed. They seamlessly integrate into a publisher’s app and native ads optimize the user experience as they blend into the app, driving high levels of engagement.
Video Creative Specs
File Format: .MP4, h264
Playback Speed: >24FPS
File-size: All video > 10mb will be compressed as needed. We don’t accept Video >150mb
