AppsFlyer walkthrough
AppsFlyer Pull API version 5 is currently supported.
Connection
Refer to the Appflyer connection topic to connect to AppsFlyer. Choose a Source Connection after creating a connection.
Reports
In AppsFlyer, there are two types of reports:
-
Predefined reports
Click Predefined reports to view the reports. -
Custom reports
Select a specific report to pull data from the AppsFlyer API v5 after establishing a connection.
The user can access 10 distinct reports using Data Integration:
- Partners
- Partners by date
- Daily
- Geo
- Geo by Date
- Installs
- In-App events
- Uninstalls
- Organic Installs
- Organic In-App Events
The default fields are unique to each AppsFlyer report; therefore, there might be some differences between reports.
Procedure
- From your AppsFlyer platform, copy the app ID.
-
Make sure you copy the app ID and not the app name.
-
Include the id.
-
Add as many app IDs as necessary. Each token will have a separate report generated by Data Integration, which puts all the data into your target database.
- Choose the report's Media Source. You can choose multiple media sources.
If a media source is not listed in the drop-down menu, enter it manually. For example, enter Apple Search Ads in the media source form to filter on Apple Search Ads.
-
You can filter your raw data reports (events reports) to avoid returning large amounts of data. The filter can handle up to 100 events per run.
-
Choose the report's time period.
- Start Date is mandatory.
- You can retrieve data for the date range specified between the start and end dates.
- If you leave the end date blank, the data will be pulled at the current time of the river's run.
- Dates timezone: UTC.
- The Start Date won't be advanced if a River run is unsuccessful. If you do not want this default setting, click More Options and turn on the checkbox to advance the start date even if the River run is unsuccessful (Not recommended).
- Use the Last Days Back For Each Run option to gather data from a specified number of days before the selected start date.
Due to AppsFlyer's potential difficulties in providing large volumes of data, splitting the requests into smaller chunks can be helpful. Use the Interval chunks size to segment the data. For shorter time frames, the data will be calculated using the start date and end date provided.
The outcomes will be the same whether you pull the data with interval chunks or without. This is done to enhance the connection's performance with the AppsFlyer API.
Limitations
-
Ensure your AppsFlyer subscription permits pulling Raw Data Reports; otherwise, you will receive a Raw Data error while running the River.
-
AppsFlyer's limitations are:
-
200,000 rows is the maximum report size. If you exceed this limit, Data Integration offers a workaround by splitting the requests into shorter periods with less data using the input interval chunks.
-
Limits on the volume of requests per account and per application.
-
If there are any errors caused by AppsFlyer limits, they will be indicated in Data Integration.
-
To learn more, refer to the AppsFlyer API policy topic.