Bulletin: Ad cost reporting by API with TikTok ads

  • What's changing: Ad cost reporting API integration with TikTok Ads
  • Where is it changing: Integrated partner integration
  • Publication date: January 19, 2020 
  • Effective date of change: January 20, 2020
  • Who is impacted: App owners who currently use Ad Spend Ingestion to record TikTok Ads spend 

Before the change

Ad cost incurred by advertisers using TikTok Ads was reported by Ad Spend Ingestion. 

After the change


  • Ad spend is recorded using the TikTok Ads reporting API.
  • Dimensions supported: Campaign, adset, ad, and geo.
  • You can no longer use Ad Spend Ingestion with TikTok Ads. Note: This is the case even if you do not enable the API.
  • When you activate the TikTok cost API, we try to retroactively get historical cost data for up to seven days before the API activation date. 
  • If you used Ad Spend Ingestion to report spend during the last seven days, then we'll backfill since the last ad spend date reported by Ingestion. This means there we take care not to record spend in duplicate.
  • Example:
    • Using Ad Spend Ingestion, your recorded spend until January 16.
    • On January 20, you activate the cost API.
    • We'll try to retroactively fill the gap from January 17 until you enable the API.

What you need to do to prepare for the change

Enable the TiTok Ads cost integration in AppsFlyer immediately. 


You need your TikTok Ads login credentials to enable the cost API integration.

To enable cost reporting by API:

  1. In the TikTok ads integrated partners page, go to the Cost tab.
  2. Enable Get Cost Data. 

  3. Click Log in to TikTok Ads.
    The TikTok Ads login window opens.

  4. Complete the following steps if prompted to do so by TikTok Ads:
    • Login to TikTok Ads. 
    • Review and accept the Platform Services Agreement.
  5. Select Add a new connection
  6. Click Add Connection.
    TikTok Ads is connected to AppFlyer.
  7. Click Save Cost.

4477_Favicon_for_the_KB-01.pngSee What's New in AppsFlyer.

Was this article helpful?