API reference

Upload cost data

post
https://hq1.appsflyer.com/api/incost-uploader/v1/data/app/
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

the app identifier as found in the AppsFlyer dashboard. Insert it exactly as it appears in the dashboard.
Ensure to prefix iOS apps with id.

Body Params
string
required
^(20)\d{2}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])$
  • Spend data
  • format: YYYY-MM-DD
string
required
length ≤ 250
  • The app ID as it appears in the AppsFlyer platform
  • Format: String up to 250 characters
string
required
length ≤ 50
  • Network name (ID) displaying the ad associated with your ad network partner account in AppsFlyer
  • Format: String 50 characters
string
length ≤ 50
  • Required for agency attribution and cost data.
  • Agency name as it displays on the attribution link and is associated with the agency account in AppsFlyer.
  • Format: String 50 characters
string
required
length ≤ 24
  • Must be identical to the af_c_id param sent on the attribution link
  • Empty string not permitted
  • Format: String 24 characters
string
required
length ≤ 100
  • Format: String 100 characters
string
length ≤ 24
  • Required if you send adset_name
  • Must be identical to the af_adset_id param sent on the attribution link
  • If your cost reporting does not support adset_id, never send it
  • Format: String 24 characters
string
length ≤ 100
  • If you send this field, you must also send adset_id
  • Format: String 100 characters
string
length ≤ 24
  • Required if you send ad_name.
  • This field must be identical to the af_ad_id param sent on the attribution link
  • If your cost reporting does not support adset_id, never send it
  • Format: String 24 characters
string
length ≤ 24
  • Unique ID that identifies the publisher that displays the ad.
  • Format: String 24 characters
string
length ≤ 100
  • If you send this field, you must also send ad_id.
  • Format: String 100 characters
string
enum
  • The country you recorded as associated with the cost
  • Where possible, this should represent the country where the ad was displayed
  • Format: ISO 3166 2 character country code
string
enum
required
  • Spend currency type
  • Format: ISO 4217 3-character currency code
integer
required
^\d+(\.\d{1,5})?$
  • Spend amount using the specified currency
  • Five digits allowed after the decimal point
  • The value 0 (zero) is permitted
  • Negative values are NOT permitted
  • Don't send , delimiters
  • Don't send values in quotation marks.
  • Format: Decimal number
string
length ≤ 20
  • Must be identical to the af_channel param sent on the attribution link.
  • Format: String 20 characters
string
length ≤ 100
  • Format: String 100 characters
Responses

Updated 2 months ago

Did this page help you?
Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 2 months ago

Did this page help you?