Event Tracking

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>"
}
'

import requests

url = "https://api-v2.adrop.io/event"

payload = {
    "uid": "<string>",
    "eventName": "<string>",
    "platform": "<string>"
}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "<content-type>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<authorization>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({uid: '<string>', eventName: '<string>', platform: '<string>'})
};

fetch('https://api-v2.adrop.io/event', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-v2.adrop.io/event",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'uid' => '<string>',
    'eventName' => '<string>',
    'platform' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: <content-type>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api-v2.adrop.io/event"

	payload := strings.NewReader("{\n  \"uid\": \"<string>\",\n  \"eventName\": \"<string>\",\n  \"platform\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "<content-type>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api-v2.adrop.io/event")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "<content-type>")
  .body("{\n  \"uid\": \"<string>\",\n  \"eventName\": \"<string>\",\n  \"platform\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-v2.adrop.io/event")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = '<content-type>'
request.body = "{\n  \"uid\": \"<string>\",\n  \"eventName\": \"<string>\",\n  \"platform\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
    "message": "ok"
}

{
    "message": "!invalid"
}

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>"
}
'

import requests

url = "https://api-v2.adrop.io/event"

payload = {
    "uid": "<string>",
    "eventName": "<string>",
    "platform": "<string>"
}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "<content-type>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<authorization>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({uid: '<string>', eventName: '<string>', platform: '<string>'})
};

fetch('https://api-v2.adrop.io/event', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-v2.adrop.io/event",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'uid' => '<string>',
    'eventName' => '<string>',
    'platform' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: <content-type>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api-v2.adrop.io/event"

	payload := strings.NewReader("{\n  \"uid\": \"<string>\",\n  \"eventName\": \"<string>\",\n  \"platform\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "<content-type>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api-v2.adrop.io/event")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "<content-type>")
  .body("{\n  \"uid\": \"<string>\",\n  \"eventName\": \"<string>\",\n  \"platform\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-v2.adrop.io/event")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = '<content-type>'
request.body = "{\n  \"uid\": \"<string>\",\n  \"eventName\": \"<string>\",\n  \"platform\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
    "message": "ok"
}

{
    "message": "!invalid"
}

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

string

required

App Key (found in adrop_service.json)

string

required

application/json

Body Parameters

string

required

User unique identifier

string

required

Event name (1–64 characters)

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

string

"ok" on success, "!invalid" on validation error.

{
    "message": "ok"
}

{
    "message": "!invalid"
}

Supported Events

Common Events

Event Name	Description	Parameters
`app_open`	App opened	—
`sign_up`	User signed up	`method` (required)
`push_clicks`	Push notification clicked	`campaign_id` (required)
`page_view`	Page viewed	`page_id` (required), `page_category`, `page_url`
`click`	Element clicked	`element_id` (required), `element_type`, `target_url`

Online Sales Events

Event Name	Description	Parameters
`view_item`	Viewed item	`item_id` (required), `item_name`, `item_category`, `brand`, `price`
`add_to_wishlist`	Added to wishlist	`item_id` (required), `item_name`, `item_category`, `brand`, `price`
`add_to_cart`	Added to cart	`item_id` (required), `item_name`, `item_category`, `brand`, `price` (required), `quantity` (required), `value`, `currency`
`begin_checkout`	Began checkout	`currency`, `items` (array, `item_id` required per item)
`purchase`	Purchase completed	`tx_id` (required), `currency`, `items` (array, `item_id` required per item)

Lead Generation Events

Event Name	Description	Parameters
`view_content`	Viewed content	`content_id` (required), `content_name`, `content_type`
`begin_lead_form`	Began lead form	`form_id` (required), `form_name`, `form_type`, `form_destination`
`generate_lead`	Lead generated	`form_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'
    }
});

import requests

url = "https://api-v2.adrop.io/event"
headers = {
    "Authorization": "YOUR_APP_KEY",
    "Content-Type": "application/json"
}
data = {
    "uid": "USER_ID",
    "eventName": "app_open"
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

curl -X POST "https://api-v2.adrop.io/event" \
  -H "Authorization: YOUR_APP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"uid": "USER_ID", "eventName": "app_open"}'

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'
    }
});

import requests

url = "https://api-v2.adrop.io/event"
headers = {
    "Authorization": "YOUR_APP_KEY",
    "Content-Type": "application/json"
}
data = {
    "uid": "USER_ID",
    "eventName": "view_item",
    "platform": "web",
    "item_id": "SKU-123",
    "item_name": "Widget",
    "item_category": "Electronics",
    "brand": "BrandX",
    "price": 29900
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

curl -X POST "https://api-v2.adrop.io/event" \
  -H "Authorization: YOUR_APP_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "uid": "USER_ID",
    "eventName": "view_item",
    "platform": "web",
    "item_id": "SKU-123",
    "item_name": "Widget",
    "item_category": "Electronics",
    "brand": "BrandX",
    "price": 29900
  }'

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'
    }
});

import requests

url = "https://api-v2.adrop.io/event"
headers = {
    "Authorization": "YOUR_APP_KEY",
    "Content-Type": "application/json"
}
data = {
    "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
        }
    ]
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

curl -X POST "https://api-v2.adrop.io/event" \
  -H "Authorization: YOUR_APP_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "uid": "USER_ID",
    "eventName": "purchase",
    "platform": "web",
    "tx_id": "TXN-20240101-001",
    "currency": "KRW",
    "items": [
      {"item_id": "SKU-001", "item_name": "Product A", "price": 29900, "quantity": 1},
      {"item_id": "SKU-002", "item_name": "Product B", "price": 15000, "quantity": 2}
    ]
  }'

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'
    }
});

import requests

url = "https://api-v2.adrop.io/event"
headers = {
    "Authorization": "YOUR_APP_KEY",
    "Content-Type": "application/json"
}
data = {
    "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"
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

curl -X POST "https://api-v2.adrop.io/event" \
  -H "Authorization: YOUR_APP_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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"
  }'

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

Targeting Settings

Error Codes

SDK Guide

AI

Android

iOS

React Native

Flutter

Web

REST API

Request Parameters

Headers

Body Parameters

Response

Supported Events

Common Events

Online Sales Events

Lead Generation Events

Examples

Simple Event

Event with Parameters

Multi-Item Event (Purchase)

Lead Generation Event

Notes

Event Targeting

Conversion Tracking

​Request Parameters

​Headers

​Body Parameters

​Response

​Supported Events

​Common Events

​Online Sales Events

​Lead Generation Events

​Examples

​Simple Event

​Event with Parameters

​Multi-Item Event (Purchase)

​Lead Generation Event

​Notes

​Related Documentation

Event Targeting

Conversion Tracking

Request Parameters

Headers

Body Parameters

Response

Supported Events

Common Events

Online Sales Events

Lead Generation Events

Examples

Simple Event

Event with Parameters

Multi-Item Event (Purchase)

Lead Generation Event

Notes

Related Documentation