> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chartcastr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AppsFlyer source

> Connect AppsFlyer to Chartcastr for automated mobile attribution charts. Track installs, revenue, ROAS, in-app events, and geographic splits delivered to Slack or email.

## Overview

Use AppsFlyer as a data source for Chartcastr. Connect your AppsFlyer account with an API V2 token and create charts for installs, attribution, revenue, cost, and in-app events, then deliver them automatically to Slack or email.

Chartcastr uses the AppsFlyer Pull API v5 with **read-only** access. No data is written to your AppsFlyer account.

## Prerequisites

* An AppsFlyer account with access to **Security Center** (to generate an API V2 token)
* At least one app registered in your AppsFlyer account

## Get an API V2 Token

<Steps>
  <Step title="Open Security Center">
    In AppsFlyer, go to **My account** → **Security Center** → **Manage your AppsFlyer API tokens**.
  </Step>

  <Step title="Create a new token">
    Click **+ New token**. Give it a name (e.g. "Chartcastr"), select type **API token** (not "Admin API token"), and click **Create**.
  </Step>

  <Step title="Copy the token">
    Copy the token. It will not be shown again after you navigate away. Tokens expire after 180 days — rotate them in Security Center before expiry.
  </Step>
</Steps>

<Warning>
  All AppsFlyer API tokens issued **before 2026-03-10 19:00 UTC** were revoked by AppsFlyer. If you have an older token, generate a new one from Security Center.
</Warning>

## Setup

<Steps>
  <Step title="Connect your AppsFlyer account">
    In Chartcastr, go to [Settings > Source Integrations](https://chartcastr.com/admin/settings/source/integrations) and find **AppsFlyer**. Click **Connect**, paste your API V2 token, and click **Test & Connect**. Chartcastr validates the token and imports your app list.
  </Step>

  <Step title="Select an app and metric">
    Pick one of your apps from the list, then choose a metric. Each metric becomes its own source. A live preview of your data will appear inline. Revenue, cost, and ROAS metrics require a Pro plan.
  </Step>

  <Step title="Create a connection">
    Pick a destination (Slack or email), set the schedule, and optionally enable AI summaries. Chartcastr will automatically generate and deliver AI-analyzed charts on your schedule.
  </Step>
</Steps>

## Available Charts

Chartcastr supports **12 pre-built AppsFlyer metrics** across five categories.

See [Available Charts](/integrations/sources/appsflyer/available-charts) for the full reference table.

### Installs (Free)

| Metric                       | Chart Type | Description                                  |
| ---------------------------- | ---------- | -------------------------------------------- |
| **Daily Installs**           | Line       | Total installs per day over the last 30 days |
| **Installs by Media Source** | Bar        | Install volume per partner/channel           |
| **Organic vs Paid Installs** | Bar        | Organic vs non-organic install comparison    |

### Engagement (Free)

| Metric                | Chart Type | Description                                      |
| --------------------- | ---------- | ------------------------------------------------ |
| **Loyal Users Trend** | Line       | Users who opened the app 3+ times, trended daily |
| **Top In-App Events** | Bar        | Event count by event name                        |

### Geo (Free)

| Metric                         | Chart Type  | Description                  |
| ------------------------------ | ----------- | ---------------------------- |
| **Installs by Country**        | Bar         | Install rollup by country    |
| **Installs by Country / Date** | Stacked Bar | Country × date heatmap (Pro) |

### Revenue (Pro)

| Metric                      | Chart Type | Description                    |
| --------------------------- | ---------- | ------------------------------ |
| **Daily Revenue**           | Line       | Total revenue per day          |
| **Revenue by Media Source** | Bar        | Revenue attributed per partner |

### Cost (Pro)

| Metric                     | Chart Type | Description                         |
| -------------------------- | ---------- | ----------------------------------- |
| **Daily Ad Spend**         | Line       | Total ad spend per day              |
| **Cost per Install (CPI)** | Line       | Blended CPI trend                   |
| **ROAS by Partner**        | Bar        | Return on ad spend per media source |

## Troubleshooting

**"Invalid or expired API token"** — Your token may have been revoked. Go to AppsFlyer → Security Center → Manage API tokens and generate a new one.

**No apps appear after connecting** — Ensure your AppsFlyer account has at least one active app and your token has access to the Master API (`/api/mng/apps`).

**Revenue/cost metrics show locked** — These metrics require a Pro plan. [Upgrade your plan](https://chartcastr.com/pricing) to unlock them.

**Data appears 1-2 days behind** — AppsFlyer aggregate reports have a 24–48 hour processing delay. This is expected behavior from the AppsFlyer Pull API.