Measure first app opens

post

https://events.appsflyer.com/v1.0/s2s/first_open/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

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

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

app-id

string

required

Application ID

platform

string

enum

required

The CTV platform of the measured app

Body Params

timestamp

int64

Event timestamp in Unix time milliseconds (UTC). If the provided timestamp is in the future or older than 96 hours, the current timestamp will be used instead.

request_id

string

length between 36 and 36

Unique identifier per request

string

required

length between 1 and 46

The device IP address - IPv4 only.

user_agent

string

length between 1 and 256

The device user agent

device_os_version

string

length between 1 and 24

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

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

sharing_filter

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