Category: Tutorials

How to Set Up AppsFlyer With CPAlead.com for CPI Campaigns

Author: CPAlead
How to Set Up AppsFlyer With CPAlead.com for CPI Campaigns

Setting up an AppsFlyer campaign with CPAlead is quick. Because CPAlead is an integrated partner in AppsFlyer, you don’t need to build postbacks yourself; you just activate the partner and generate the attribution link.

Important: Run in ad-network mode. Do not add &af_prt= to links unless a third-party agency is managing your traffic and is pre-authorized. Otherwise omit it; attribution uses your partner PID.

Step 1: Access Partner Configuration

Connect CPAlead in AppsFlyer.

  1. Log in to your AppsFlyer dashboard.
  2. Click Marketplace in the left menu.
  3. Open Integrated Partners, search for “cpalead”, and select it.

Step 2: Configure the Integration

Activate and enable data delivery.

  1. Click Configure Integration or Set Up.
  2. Toggle Activate partner ON.
  3. If prompted for an attribution link, use the default single-platform AppsFlyer link for non-SRNs.

Step 3: Create Your Tracking Link

AppsFlyer generates partner links. Use your CPAlead PID and campaign macros in the standard format. The click lookback window supports hours or days.

In the partner’s Attribution / Tracking Link section, use:

https://app.appsflyer.com/[YOUR_APP_ID]?pid=cpalead_int&af_click_lookback=5d&clickid={CLICK_ID}&af_siteid={PUBLISHER_ID}&af_cost_value={COST}&af_cost_currency=USD&af_cost_model=CPI
  • [YOUR_APP_ID] → Your app ID in AppsFlyer: the Android package name (for example, com.yourcompany.appname) or the iOS App Store ID with its id prefix.
  • Leave out af_prt unless running via an authorized agency.

Step 4: Attribution Windows & Cost

Set your Click Attribution Window to 5–7 days to match campaign terms. AppsFlyer supports 1–23 hours or 1–7 days per media source. Enable Send cost data if you want CPI cost reporting in AppsFlyer and partner dashboards.

Step 5: Enable Postbacks

Enable In-app event postbacks for paid in-app actions and choose This partner only. For a campaign with one paid action, use an install or make the AppsFlyer event name exactly match the CPAlead conversion goal. For multiple event rewards, follow the mapping steps below. Use the CPAlead Integrated Partner setup; do not paste your standard /aff_lsr account postback into AppsFlyer.

Multiple event rewards with AppsFlyer

In CPAlead, choose a CPI campaign, Multiple event rewards, and AppsFlyer tracking. Add each reward and save the campaign. For every in-app reward, enter its saved numeric CPAlead event ID in AppsFlyer’s mapped to partner event field. The event ID identifies the reward; the SDK event name identifies the action your app reports.

Example only: use the IDs and prices saved in your own campaign. This schedule costs up to $3.75 per participant; that total is not an extra payment.

CPAlead event IDRewardPaymentAppsFlyer SDK nameAppsFlyer condition
1Install the app$0.50installExplicit install callback
2Reach level 5$1.25af_level_achievedaf_level = 5
3Reach level 10$2.00af_level_achievedaf_level = 10

Save the optional AppsFlyer SDK name exactly, including its letter case. When the callback includes both a saved name and an ID, they must agree. A name-only callback works only when that name matches one reward. In the example, both level rewards use af_level_achieved, so each AppsFlyer condition must send its own numeric partner_event_id. CPAlead does not infer the level from the event name.

An install pays only if you add a reward whose AppsFlyer SDK name is install and the callback explicitly sends event_type=install. Only one reward can use this mapping. A missing event name does not count as an install.

Review the dedicated install and in-app callback templates in Postback Setup. In-app callbacks use event_type=in_app, partner_event_id, event_name, app_id, and the original clickid. If those fields are unavailable in the partner setup, contact CPAlead support so the AppsFlyer partner template can be checked. Review any custom sender IP whitelist, too.

Keep clickid={CLICK_ID} and the required cost parameters in your tracking link. For event campaigns, {COST} and {CPI_COST} become zero: the full reward total is not an install price. Use the campaign’s Event report in CPAlead to see actual credited reward spend.

Each saved reward can pay once on the original click, in any order, within 30 days. Set the AppsFlyer event postback window to cover your campaign terms; it does not extend CPAlead’s 30-day window. Event IDs, names, mappings, and prices lock after real participation, so copy the campaign if you need a different schedule.

Keep enough funds for pending rewards even when new traffic is paused or capped. A reward without full funding returns 503 low_balance and pays nothing. Ask CPAlead support to check whether AppsFlyer has enabled optional 5xx retries for the partner integration. AppsFlyer can retry up to four times, 15 minutes apart, after the first attempt. Add funds promptly; retries are limited and are not enabled for every integration.

AppsFlyer documents event mapping and conditions, partner postback fields, and optional postback retries.

Step 6: Save & Verify

  1. Click Save / Apply.
  2. Confirm CPAlead shows as Active under Integrated Partners.

Security & Quality (Recommended)

  • Authorized agencies list: If you don’t work with agencies, keep this list empty. Only agencies on this list can manage traffic via af_prt.
  • Validation Rules: Add allow/deny rules by media source or site ID to block unwanted traffic and enforce campaign targeting.
  • ProtectLITE / Protect360: Use AppsFlyer fraud reports to monitor blocked installs and events.

Launch on CPAlead

After AppsFlyer is configured:

1) Submit Your Campaign

Create a CPI campaign in the CPAlead Advertiser Dashboard, select AppsFlyer tracking, and paste your AppsFlyer link. Choose one paid action or multiple event rewards, then save and check the matching AppsFlyer setup.

2) Set Your Budget

For one paid action, set the payment and daily cap. For multiple event rewards, set each payment and review the maximum total. The daily cap counts each participant at their first paid event; later rewards do not count again.

3) Go Live

Use the signed-in Postback page’s Guided Test to check the selected campaign and event before sending traffic. After approval, add the required funds and start the campaign when your tracking setup is ready.

Need More Help?

For more details on AppsFlyer integrations and postbacks, see the AppsFlyer Help Center articles on partner setup and in-app event postbacks.

CPAlead Advertiser Guide: Setting Up Your First Campaign

Prefer a video tutorial? Watch our step-by-step guide:

Noticed an error or an aspect of this post that requires correction? Please provide the post link and reach out to us. We appreciate your feedback and will address the issue promptly.