Data Source - AppsFlyer
- 27 Dec 2022
- Print
- DarkLight
- PDF
Data Source - AppsFlyer
- Updated on 27 Dec 2022
- Print
- DarkLight
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
This is a machine-translated version of the original Japanese article.
Please understand that some of the information contained on this page may be inaccurate.
Overview
This is the help page for the settings to be transferred from AppsFlyer.
Supported Protocols
- Data Transfer
- Using AppsFlyer API v5
- Connect to AppsFlyer API using RAW DATA PULL API V2 TOKEN
Settings
STEP 1: General Settings
| Field Name | Required | Default Value | Description |
|---|---|---|---|
| AppsFlyer Connection Information | Yes | - | From the connection information registered in advance, select the one that has the necessary permissions for this transfer setting. For details on how to set connection information, refer to AppsFlyer Connection Information. |
| App ID | Yes | - | Enter your App ID. |
| Report Type | Yes | - | Select a report type. |
| Data acquisition period | Yes | - | Enter the start date and time and end date and time of the data you want to transfer.YYYY-MM-DDOrYYYY-MM-DD HH:mm:ss type.Please refer to the following for details on the data acquisition period. |
| Time zone | Yes | Etc/UTC | Set the time zone for the data acquisition period. |
About the data acquisition period
- Start date and time
- If you do not specify a time (HH:mm:ss), the current day
00:00:00is specified instead. - The time specified at the start date and time is included in the data retrieval period.
- If you do not specify a time (HH:mm:ss), the current day
- End date and time
- If you do not specify a time (HH:mm:ss), the next
00:00:00day is specified instead. - The time specified at the end date and time is not included in the data retrieval period.
Example. If you specify an2022-12-31end date and time, it is specified instead2023-01-01 00:00:00.
At this time,2022-12-31 23:59:59the data up to is retrieved.
- If you do not specify a time (HH:mm:ss), the next
Report Type
You can get the following raw data reports:
| Field Name at Transfer | API Field Name |
|---|---|
| install | Installs |
| In-app events | In-app events |
| uninstall | Uninstalls |
| Reinstall | Reinstalls |
| Organic Installation | Organic Installs |
| Organic in-app events | Organic in-app events |
| Organic Uninstall | Organic uninstalls |
| Organic reinstallation | Organic reinstalls |
Limitations
There are the following restrictions on using AppsFlyer's API.
Number of records that can be retrieved
- A maximum of 1 million records can be retrieved per transfer.
- If you try to transfer a report with more than 1 million records, a transfer error occurs.
Limit the number of times you get a report
AppsFlyer limits the number of reports you can get in a single day.
The number of times you can limit the number of times depends on your plan.
For details, refer to Report Count Limit.
Period of data available
AppsFlyer limits the time period for which you can retrieve reports.
- In-app and organic in-app events: 31 of the last 90 days
- Other reports: 60 of the last 90 days
For more information, see Data availability windows.
When Exceeding 1,000,000 Records
There are two ways to respond.
Narrow the scope of the data acquisition period
You can specify the range of the start date and time and end date and time of the data acquisition period in hours.
However, please note that as mentioned above, there is a limit to the number of reports retrieved (transferred) per day.
For more information, see Date and time range ranges.
Via cloud storage
AppsFlyer has a feature called Data Locker.
Data Locker allows you to send report data to the following cloud storages:
- Google Cloud Storage
- AWS
- Snowflake
After sending the report data to the above, you can transfer the report data as the transfer source.
For more information about Data Locker, see Data Locker—For Advertisers.
Fields Imported
For details on each field, see the Raw Data Item Guide.
Field name
| Field Name at Transfer | API Field Name |
|---|---|
| attributed_touch_type | Attributed touch type |
| attributed_touch_time | Attributed touch time |
| install_time | Install time |
| event_time | Event time |
| event_name | Event name |
| event_value | Event value |
| event_revenue | Event revenue |
| event_revenue_currency | Event revenue currency |
| event_revenue_usd | Event revenue USD |
| event_source | Event source |
| is_receipt_validated | Is receipt validated |
| partner | Partner |
| media_source | Media source |
| channel | Channel |
| keywords | Keywords |
| campaign | Campaign |
| campaign_id | Campaign ID |
| adset | Adset |
| adset_id | Adset ID |
| ad | Ad |
| ad_id | Ad ID |
| ad_type | Ad type |
| site_id | Site ID |
| sub_site_id | Sub site ID |
| sub_param_1 | Sub param 1 |
| sub_param_2 | Sub param 2 |
| sub_param_3 | Sub param 3 |
| sub_param_4 | Sub param 4 |
| sub_param_5 | Sub param 5 |
| cost_model | Cost model |
| cost_value | Cost value |
| cost_currency | Cost currency |
| contributor_1_partner | Contributor 1 partner |
| contributor_1_media_source | Contributor 1 media source |
| contributor_1_campaign | Contributor 1 campaign |
| contributor_1_touch_type | Contributor 1 touch type |
| contributor_1_touch_time | Contributor 1 touch time |
| contributor_2_partner | Contributor 2 partner |
| contributor_2_media_source | Contributor 2 media source |
| contributor_2_campaign | Contributor 2 campaign |
| contributor_2_touch_type | Contributor 2 touch type |
| contributor_2_touch_time | Contributor 2 touch time |
| contributor_3_partner | Contributor 3 partner |
| contributor_3_media_source | Contributor 3 media source |
| contributor_3_campaign | Contributor 3 campaign |
| contributor_3_touch_type | Contributor 3 touch type |
| contributor_3_touch_time | Contributor 3 touch time |
| region | Region |
| country_code | Country code |
| state | State |
| city | City |
| postal_code | Postal code |
| dma | DMA |
| ip | IP |
| is_wifi | WIFI |
| operator | Operator |
| carrier | Carrier |
| language | Language |
| appsflyer_id | AppsFlyer ID |
| advertising_id | Advertising ID |
| idfa | IDFA |
| android_id | Android ID |
| customer_user_id | Customer user ID |
| imei | IMEI |
| idfv | IDFV |
| platform | Platform |
| device_type | Device type |
| os_version | OS version |
| app_version | App version |
| sdk_version | SDK version |
| app_id | App ID |
| app_name | App name |
| bundle_id | Bundle ID |
| is_retargeting | Is retargeting |
| retargeting_conversion_type | Retargeting conversion Type |
| attribution_lookback_window | Attribution lookback window |
| reengagement_window | Re-engagement window |
| is_primary_attribution | Is primary attribution |
| user_agent | User agent |
| http_referrer | HTTP referrer |
| original_url | Original URL |
| blocked_reason_rule | Blocked reason rule |
| is_store_reinstall | Store reinstall |
| impressions | Impressions |
| contributor_3_match_type | Contributor 3 match type |
| custom_dimension | Custom dimension |
| conversion_type | Conversion type |
| google_play_click_time | Google Play click time |
| match_type | Match type |
| mediation_network | Mediation network |
| oaid | OAID |
| deeplink_url | Deeplink URL |
| blocked_reason | Blocked reason |
| blocked_sub_reason | Blocked sub reason |
| google_play_broadcast_referrer | Google Play broadcast referrer |
| google_play_install_begin_time | Google Play install begin time |
| campaign_type | Campaign type |
| custom_data | Custom data |
| rejected_reason | Rejected reason |
| device_download_time | Device download time |
| keyword_match_type | Keyword match type |
| contributor_1_match_type | Contributor 1 match type |
| contributor_2_match_type | Contributor 2 match type |
| device_model | Device model |
| monetization_network | Monetization network |
| segment | Segment |
| is_lat | Is LAT |
| google_play_referrer | Google Play referrer |
| blocked_reason_value | Blocked reason value |
| store_product_page | Store product page |
| device_category | Device category |
| app_type | App type |
| rejected_reason_value | Rejected reason value |
| ad_unit | Ad unit |
| keyword_id | Keyword ID |
| placement | Placement |
| network_account_id | Network account ID |
| install_app_store | Install app store |
| amazon_fire_id | Amazon Fire ID |
| att | ATT |
Fields Not Imported
Fields not retrieved
However, some fields are not retrieved in some reports.
For fields that are not retrieved, please refer to the table below.
Fields for which
| Report Type Name | Fields Not Imported |
|---|---|
| install | without |
| In-app events | without |
| uninstall |
|
| Reinstall | without |
| Organic Installation |
|
| Organic in-app events |
|
| Organic Uninstall |
|
| Organic reinstallation |
|
Was this article helpful?