Measure in-app events

post https://events.appsflyer.com/v1.0/s2s/inapp/app/{platform}/{app-id}

ℹ️
This is a server to server API. If you need to report events directly from your application's client please see this section or contact your CSM

This AppsFlyer API integration allows advertisers to measure any
post-install in-app event and attribute it to a media source and campaign

Path Params

app-id

string

required

Application ID

platform

string

required

The CTV platform of the measured app

Body Params

timestamp

int64

Event timestamp in Unix time milliseconds (UTC)

request_id

string

length between 36 and 36

Unique identifier per request

string

required

length between 1 and 46

The device IP address - IPv4 or IPv6

user_agent

string

length between 1 and 256

The device user agent

device_os_version

string

length between 1 and 12

The device OS version

device_model

string

length between 1 and 50

The device model

device_ids

array of objects

required

A vector of the different device IDs. Can be either advertising ID or a custom ID

device_ids*

limit_ad_tracking

boolean

Limit Ad Tracking flag. Use this flag to mark whether or not the user has advertiser ID

customer_user_id

string

length between 1 and 64

Customer user ID, as set by the developer. This is used as the user identifier in the advertiser's system

app_version

string

length between 1 and 24

The release or version number of the app

event_name

string

required

length between 1 and 64

A string describing the event name

event_parameters

object

event_custom_parameters

json

length ≤ 2048

A JSON object which can contain multiple parameters. Learn more here

sharing_filter

array

length ≥ 1

The sharing filter blocks the sharing of events via postbacks/API with integrated partners and other third-party integrations.
Use the filter to fulfill regulatory requirements like GDPR and CCPA, to comply with user opt-out mechanisms, and for other business logic reasons.

The sharing_filter has the following options:

all: All partners are blocked. Don't share the event with anyone. Example: "sharing_filter": "all"
List of partner ids in an array.

Note:
To find out the required partner IDs:

Run the Get active integrations API for a list of all active integrations
Use the media_source_name values from the API response as input values to the method partners array.

Responses

202

The request was accepted

400

Mandatory fields in the message body are missing, or fields are invalid

401

The app doesn't exist or the authentication failed

403

App traffic blocked due to Zero package limit

500

Internal server error

Language

Credentials

Header

URL


xxxxxxxxxx
1
curl --request POST \
2
     --url https://events.appsflyer.com/v1.0/s2s/inapp/app//app-id \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json'

Click Try It! to start a request and see the response here!