- Introduction
- Getting Started
- Data Ingestion
- Data Loading
- Loading Data in a Database Destination
- Loading Data to a Data Warehouse
- Optimizing Data Loading for a Destination Warehouse
- Manually Triggering the Loading of Events
- Scheduling Data Load for a Destination
- Loading Events in Batches
- Name Sanitization
- Table and Column Name Compression
- Parsing Nested JSON Fields in Events
- Pipelines
- Data Flow in a Pipeline
- Ingestion Modes
- Familiarizing with the Pipelines UI
- Pipeline Objects
- Working with Pipelines
- Transformations
-
Schema Mapper
- Using Schema Mapper
- Mapping Statuses
- Auto Mapping Event Types
- Mapping a Source Event Type with a Destination Table
- Mapping a Source Event Type Field with a Destination Table Column
- Schema Mapper Actions
- Fixing Unmapped Fields
- Resolving Incompatible Schema Mappings
- Resizing String Columns in the Destination
- Schema Mapper Compatibility Table
- Failed Events in a Pipeline
- Pipeline FAQs
- Events Usage
- Sources
- Free Sources
- Analytics
- Collaboration
- CRM
- Data Warehouses
- Databases
- E-Commerce
- File Storage
- Finance & Accounting
-
Marketing
- AdRoll
- Apple Search Ads
- AppsFlyer
- Criteo
- Facebook Ads
- Facebook Page Insights
- Google Ads
- Google Campaign Manager
- Google Play Console
- Google Search Console
- HubSpot
- Instagram Business
- Klaviyo
- LinkedIn Ads
- Mailchimp
- Marketo
- Microsoft Advertising
- Outbrain
- Pardot
- Pinterest Ads
- Segment
- SendGrid
- SendGrid Webhook
- Salesforce Marketing Cloud
- Snapchat Ads
- Taboola
- Twitter Ads
- Streaming
- Source FAQs
- Destinations
- Transform
- Activate
- Alerts
- Account Management
- Troubleshooting
-
Troubleshooting Sources
- Troubleshooting Amazon DynamoDB
- Troubleshooting MongoDB
- Troubleshooting MS SQL
- Troubleshooting MySQL
- Troubleshooting Oracle
-
Troubleshooting PostgreSQL
-
Errors during Pipeline creation
- Error 1003 - Authentication failure
- Error 1006 - Connection settings errors
- Error 1011 - Access role issue for logical replication
- Error 1012 - Access role issue for logical replication
- Error 1014 - Database does not exist
- Error 1017 - Connection settings errors
- Error 1023 - No pg_hba.conf entry
- Error 1024 - Number of requested standby connections
-
Errors during Pipeline creation
- Troubleshooting Salesforce
- Troubleshooting Destinations
-
Troubleshooting Sources
- Glossary
- Release Notes
- Release Version 1.88
- Release Version 1.87
- Release Version 1.86
- Release Version 1.84 & 1.85
- Release Version 1.83
- Release Version 1.82
- Release Version 1.81
- Release Version 1.80 (Jan-24-2022)
- Release Version 1.79 (Jan-03-2022)
- Release Version 1.78 (Dec-20-2021)
- Release Version 1.77 (Dec-06-2021)
- Release Version 1.76 (Nov-22-2021)
- Release Version 1.75 (Nov-09-2021)
- Release Version 1.74 (Oct-25-2021)
- Release Version 1.73 (Oct-04-2021)
- Release Version 1.72 (Sep-20-2021)
- Release Version 1.71 (Sep-09-2021)
- Release Version 1.70 (Aug-23-2021)
- Release Version 1.69 (Aug-09-2021)
- Release Version 1.68 (Jul-26-2021)
- Release Version 1.67 (Jul-12-2021)
- Release Version 1.66 (Jun-28-2021)
- Release Version 1.65 (Jun-14-2021)
- Release Version 1.64 (Jun-01-2021)
- Release Version 1.63 (May-19-2021)
- Release Version 1.62 (May-05-2021)
- Release Version 1.61 (Apr-20-2021)
- Release Version 1.60 (Apr-06-2021)
- Release Version 1.59 (Mar-23-2021)
- Release Version 1.58 (Mar-09-2021)
- Release Version 1.57 (Feb-22-2021)
- Release Version 1.56 (Feb-09-2021)
- Release Version 1.55 (Jan-25-2021)
- Release Version 1.54 (Jan-12-2021)
- Release Version 1.53 (Dec-22-2020)
- Release Version 1.52 (Dec-03-2020)
- Release Version 1.51 (Nov-10-2020)
- Release Version 1.50 (Oct-19-2020)
- Release Version 1.49 (Sep-28-2020)
- Release Version 1.48 (Sep-01-2020)
- Release Version 1.47 (Aug-06-2020)
- Release Version 1.46 (Jul-21-2020)
- Release Version 1.45 (Jul-02-2020)
- Release Version 1.44 (Jun-11-2020)
- Release Version 1.43 (May-15-2020)
- Release Version 1.42 (Apr-30-2020)
- Release Version 1.41 (Apr-2020)
- Release Version 1.40 (Mar-2020)
- Release Version 1.39 (Feb-2020)
- Release Version 1.38 (Jan-2020)
- Upcoming Features
AppsFlyer
AppsFlyer is a mobile-app tracking and attribution analytics platform that helps app developers and marketers to manage, measure, and optimize their mobile user acquisition process.
Hevo uses AppsFlyer’s PULL API to replicate the raw and aggregated app performance reports from your AppsFlyer account to the Destination system. The user needs to provide the AppsFlyer API Token to connect Hevo to the AppsFlyer account.
Prerequisites
-
The user authorizing the application has an active AppsFlyer account with access to at least one app.
-
The user authorizing the application has
Admin
access.
Configuring AppsFlyer as a Source
Perform the following steps to configure AppsFlyer as the Source in your Pipeline:
-
Click PIPELINES in the Asset Palette.
-
Click + CREATE in the Pipelines List View.
-
In the Select Source Type page, select AppsFlyer.
-
In the Configure your AppsFlyer Source page, specify the following:
-
Pipeline Name - A unique name for your Pipeline.
-
App ID - The unique ID of your AppsFlyer app.
-
API Token - The API token for your AppsFlyer account.
-
Pull API Timezone - The timezone in which you want to receive the data.
-
-
Click TEST & CONTINUE.
-
Proceed to configuring the data ingestion and setting up the Destination.
Locating the App ID and the API Token
The App ID is the unique ID of the app listed in the AppsFlyer dashboard whose data you want to replicate to the Destination.
Step 1. Locate the App ID
-
Log in to your AppsFlyer account.
On the homepage, you can find the apps added to your account. -
Copy the App ID of the app you want to fetch data from.
Hevo uses this App ID to configure AppsFlyer as a Source.Note: The App ID for iOS apps starts with
id
.
Step 2. Locate the API Token
-
In the top right of the AppsFlyer homepage, click the drop-down next to your username, and then click Security center.
-
In the Manage your account security page, scroll down and select Manage your AppsFlyer API tokens.
-
In the page that is displayed, copy the API token V1.0 and use it in Hevo to configure AppsFlyer as a Source.
The API token V1.0 allows Hevo to pull raw and aggregated data reports from AppsFlyer.
Data Replication
-
Historical Data: On the first run of the Pipeline, Hevo fetches all the data for your selected objects up to the maximum duration allowed by the AppsFlyer API.
Refer to the following table to know about the maximum number of days for which Hevo can fetch historical data for each object:
Object API Limit for Historical Data (Days) daily_report 60 geo_by_date_acquisition_report 60 geo_by_date_retargeting_report 60 in-app_events_report 31 in-app_events_retargeting_report 31 installs_report 60 organic_installations_report 60 organic_in_app_events_report 31 partners_by_date_report 60 partners_report 100 uninstalls_report 60 -
Incremental Data: Every subsequent run of the Pipeline fetches the new and updated data. The default ingestion frequency is 24 hours. Contact Hevo Support if you want to change it.
Schema and Primary Keys
Hevo uses the following schema to upload the records in the Destination:
Data Model
Hevo uses the following data model to ingest data from your AppsFlyer account:
Object | Report Type | Description |
---|---|---|
daily_report | Aggregated | Contains details of clicks and impressions grouped by Date. |
geo_by_date_acquisition_report | Aggregated | Contains an acquisition report grouped by date, country, agency, media source, and campaign. To view examples, see this. |
geo_by_date_retargeting_report. | Aggregated | Contains retargeting report grouped by date, country, agency, media source, and campaign. To view examples, see this. |
in-app_events_report | Raw | Contains report of in-app events as per the user’s action. |
in-app_events_retargeting_report | Raw | Contains the data of the media sources attributed to the conversion. |
installs_report | Raw | Contains report of the event generated when the app is opened for the first time. |
organic_installations_report | Raw | Contains installation reports of the app, such as, the time of installation, type of device, operating system, region, city, and country. |
organic_in_app_events_report | Raw | Contains details of actions performed by users. |
partners_by_date_report | Aggregated | Contains partner data grouped by date, agency, media source, and campaign. View examples here. |
partners_report | Aggregated | Contains partner data grouped by date, agency, media source, and campaign. View examples here. |
uninstalls_report | Raw | Contains uninstallation reports of the app, such as, time of uninstallation, type of device, operating system, region, city, and country. |
Note: __hevo_id
, which represents a unique ID for the Source data, is derived by hashing the Source data’s primary key columns.
Limitations
- Hevo does not support raw reports of
Ad revenue
andRetargeting
fetched from AppsFlyer.
Revision History
Refer to the following table for the list of key updates made to this page:
Date | Release | Description of Change |
---|---|---|
Mar-17-2022 | NA | Removed the Pipeline frequency table from the Data Replication section as you cannot configure the Pipeline frequency from the UI. |
Mar-07-2022 | NA | - Updated the steps under the Locating the App ID and the API Token section, to reflect the latest AppsFlyer UI. - Updated the Pipeline Frequency table and added information about historical data in the Data Replication section. |
Oct-25-2021 | NA | Added the Pipeline frequency information in the Data Replication section. |