Measure sessions

ℹ️

This is API is used to to report events directly from your application's client. If you need Server-to-Server please see this section

This AppsFlyer API integration provide advertisers with the ability
to measure post-install sessions and attribute it to a media source and campaign

📘

Note

Generate the authentication signature

To authenticate the API request, generate a Hash-Based Message Authentication Code (HMAC) signature by hashing the entire raw message using SHA-256 and the Devkey as the secret key. Place the resulting signature in the request authentication header.

For example, if the raw message is:
{"timestamp": 1604503583337, "ip": "127.0.0.1", "user_agent": "Roku/DVP-9.21 (AE9.21E04090A)", "device_os_version": "9.3.0", "device_model": "3920X", "device_ids": [{"type": "rida", "value": "fa73d67d-f55c-5af3-883a-726253dc7d0e"}], "limit_ad_tracking": false}

The Devkey is:
w8sZzy8EaPaxFKfaoTqU16

The signature is:
715b133d5a327b77beb898688a3ad438da0f78071cd3df70e8ec5ecf60751972

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
^[A-Za-z0-9.\-]+$

Application ID

string
enum
required

The CTV platform of the measured app

Body Params
string
required
length between 36 and 36

Unique identifier per request

string
required
length between 1 and 12
^[0-9.\-]+$

The device OS version

string
required
length between 1 and 50
^[A-Za-z0-9.\(\)\- ]+$

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. The custom device ID is mapped to appsflyer_idin raw data reports. in raw data reports

device_ids*
boolean
required

Limit Ad Tracking flag. Use this flag to mark whether or not the user has advertiser 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

string
required
length between 1 and 24
^[0-9.\-]+$

The release or version number of the app

Responses
202

The request was accepted

400

The authentication succeeded, but 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
LoadingLoading…
Response
Click Try It! to start a request and see the response here!