Skip to main content
POST
/
event
Event Tracking
curl --request POST \
  --url https://api-v2.adrop.io/event \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "uid": "<string>",
  "eventName": "<string>",
  "platform": "<string>"
}
'
{
    "message": "ok"
}

Documentation Index

Fetch the complete documentation index at: https://docs.adrop.io/llms.txt

Use this file to discover all available pages before exploring further.

Send user behavior events to build event-based audiences for targeting. The event data is used for audience segmentation and conversion tracking.

​
Request Parameters

​
Headers

​
Authorization
string
required
App Key (found in adrop_service.json)
​
Content-Type
string
required
application/json

​
Body Parameters

​
uid
string
required
User unique identifier
​
eventName
string
required
Event name (1–64 characters)
​
platform
string
Platform. e.g., web, android, ios
Additional event-specific parameters are passed as top-level fields in the request body. For multi-item events (begin_checkout, purchase), pass an items array.

​
Response

​
message
string
"ok" on success, "!invalid" on validation error.
{
    "message": "ok"
}

​
Supported Events

​
Common Events

Event NameDescriptionParameters
app_openApp opened—
sign_upUser signed upmethod (required)
push_clicksPush notification clickedcampaign_id (required)
page_viewPage viewedpage_id (required), page_category, page_url
clickElement clickedelement_id (required), element_type, target_url

​
Online Sales Events

Event NameDescriptionParameters
view_itemViewed itemitem_id (required), item_name, item_category, brand, price
add_to_wishlistAdded to wishlistitem_id (required), item_name, item_category, brand, price
add_to_cartAdded to cartitem_id (required), item_name, item_category, brand, price (required), quantity (required), value, currency
begin_checkoutBegan checkoutcurrency, items (array, item_id required per item)
purchasePurchase completedtx_id (required), currency, items (array, item_id required per item)

​
Lead Generation Events

Event NameDescriptionParameters
view_contentViewed contentcontent_id (required), content_name, content_type
begin_lead_formBegan lead formform_id (required), form_name, form_type, form_destination
generate_leadLead generatedform_id (required), form_name, form_type, form_destination, value, currency

​
Examples

​
Simple Event

const axios = require('axios');

axios.post('https://api-v2.adrop.io/event', {
    uid: 'USER_ID',
    eventName: 'app_open'
}, {
    headers: {
        'Authorization': 'YOUR_APP_KEY',
        'Content-Type': 'application/json'
    }
});

​
Event with Parameters

const axios = require('axios');

axios.post('https://api-v2.adrop.io/event', {
    uid: 'USER_ID',
    eventName: 'view_item',
    platform: 'web',
    item_id: 'SKU-123',
    item_name: 'Widget',
    item_category: 'Electronics',
    brand: 'BrandX',
    price: 29900
}, {
    headers: {
        'Authorization': 'YOUR_APP_KEY',
        'Content-Type': 'application/json'
    }
});

​
Multi-Item Event (Purchase)

const axios = require('axios');

axios.post('https://api-v2.adrop.io/event', {
    uid: 'USER_ID',
    eventName: 'purchase',
    platform: 'web',
    tx_id: 'TXN-20240101-001',
    currency: 'KRW',
    items: [
        {
            item_id: 'SKU-001',
            item_name: 'Product A',
            item_category: 'Electronics',
            brand: 'BrandX',
            price: 29900,
            quantity: 1
        },
        {
            item_id: 'SKU-002',
            item_name: 'Product B',
            price: 15000,
            quantity: 2
        }
    ]
}, {
    headers: {
        'Authorization': 'YOUR_APP_KEY',
        'Content-Type': 'application/json'
    }
});

​
Lead Generation Event

const axios = require('axios');

axios.post('https://api-v2.adrop.io/event', {
    uid: 'USER_ID',
    eventName: 'generate_lead',
    platform: 'web',
    form_id: 'contact-form-01',
    form_name: 'Contact Us',
    form_type: 'contact',
    form_destination: '/thank-you',
    value: 50000,
    currency: 'KRW'
}, {
    headers: {
        'Authorization': 'YOUR_APP_KEY',
        'Content-Type': 'application/json'
    }
});

​
Notes

  • Events with unknown names or missing required parameters are silently ignored (HTTP 200 returned).
  • Multi-item events support up to 100 items per request.
  • String parameter values are limited to 1024 characters.
  • uid is hashed with SHA-256 before storage.

Event Targeting

Configure event-based audience targeting in the console

Conversion Tracking

Track conversions based on purchase events