TikTok for Business—Create web campaigns for website apps

At a glance: Set up a TikTok Web Ads integration for your website app to send web conversion signals to TikTok via the Events API.

Overview

AppsFlyer supports integration with TikTok Web Ads (tiktokweb_int) for website app campaigns, letting you report attribution and conversion data directly through TikTok's Events API. TikTok can then use this data to optimize ad targeting, measure performance, and build custom audiences.

Here's how it works: when a user clicks a TikTok ad and lands on your website, and then completes a website event (for example, a purchase or sign-up), AppsFlyer sends the conversion signal to TikTok via the Events API. TikTok uses this data to optimize ad targeting and measure campaign performance.

Important!

At present, the integration does not support sending re-engagement postbacks via the Events API.

Prerequisites

Before activating the TikTok Web Ads integration for your website app, make sure you have:

How to set up TikTok Web Ads for your website app

The setup involves defining the integration between TikTok Web Ads and AppsFlyer, and configuring the campaign in TikTok Ads Manager. It includes the following parts:

Part 1: Set up TikTok Web Ads integration in AppsFlyer

Start by activating the TikTok Web Ads integration and setting the postbacks AppsFlyer sends to the Events API.

1. Activate the TikTok Web Ads integration

To activate the TikTok Web Ads integration:

  1. In AppsFlyer, from the side menu, go to Collaborate > Partner Marketplace.
  2. Search for TikTok For Business - Advanced SRN (or tiktokweb_int) and select it.
  3. Click Set up integration. You're directed to the Active Integrations setup page.
  4. In the Integration tab, turn on Activate Partner. The toggle must stay on for as long as you work with the partner.
  5. Pixel ID: Enter the Pixel ID. You can generate it or retrieve it from your TikTok Ads Manager by following the instructions in the TikTok documentation.
  6. Access token: Enter the access token. To generate or retrieve it, follow the same TikTok documentation.
  7. Limit TikTok Web Ads' use of users' personal information (CCPA): Turn on this toggle to enable compliance with data protection laws.

Note

Enabling CCPA compliance limits the data coming from TikTok Web Ads users based in California or other sensitive states in the US.

2. Set in-app event postbacks

You can define which web conversion events AppsFlyer sends to TikTok Ads by mapping AppsFlyer events to TikTok Web Ads events. These postbacks can be viewed in TikTok Ads Manager, and TikTok uses the mapped events for campaign optimization and reporting.

To set in-app event postbacks:

  1. Turn on In-app event postbacks.
  2. If required, set the in-app event postback window. Read more about in-app event postback window configuration in In-app event postback configuration.
  3. Click Add event to add an event to the list.
  4. In the AppsFlyer event column, select the event name from the drop-down list. AppsFlyer receives the event name either from the Web SDK integrated on your website or from server-to-server (S2S) events you send to AppsFlyer.
  5. In the mapped to partner event column, select the most suitable pre-defined partner event.
  6. In the For Users From column, select the appropriate option:
    • This partner only, to send events attributed to TikTok Web Ads only.
    • All media sources, including organic, to send all events regardless of attribution source.
  7. In the including column, select whether events will be sent with their revenue values. See Data to include in the postbacks.
  8. [Optional] Click the Add condition icon to set conditions for an event.
  9. Click Save integration.

Note

  • If you are setting a purchase event, set the including column to Values and revenue. Selecting any other option will cause the postback to fail.
  • Currently, only the purchase event can be set to include revenue.

Part 2: Set up AppsFlyer integration in TikTok Web Ads

Complete the following steps in TikTok Ads Manager.

1. Set the campaign type, objective, and goals

You can choose any pre-defined in-app event sent from AppsFlyer as your campaign goal. Select a campaign objective that aligns with your website conversion goals, for example, driving traffic to your website or optimizing for on-site conversions.

2. Set destination URL

  1. Under Destination, in the Website URL field, enter the URL of your website, which is the page where users land after clicking your ad.

    Website URL is the primary destination option. Users click the ad and land directly on your website to complete conversion events.

  2. [Alternative] AF attribution link (OneLink): If you want to redirect users to the mobile app with a fallback to the website, you can use an AF attribution link (OneLink) as the destination URL instead.
  3. Click Build a URL parameter to add the URL parameters to the destination URL.
  4. Under Custom parameters, click Add parameter.
  5. Map the AppsFlyer parameters to their TikTok values:

    AF parameter Mapped TikTok value
    pid tiktokweb_int
    c __campaign_name__
    af_c_id __campaign_id__
    af_adset __aid_name__
    af_adset_id __aid__
    af_ad __cid_name__
    af_ad_id __cid__

    Note

    To simplify campaign analysis, include the campaign type (web or mobile) as a prefix or suffix in the campaign name, for example, campaign-name_web.

    For best practices on URL parameter configuration and traffic source resolution, see About traffic source resolution.

    An example of the resulting URL:

    https://www.example.com?pid=tiktokweb_int&c=__campaign_name__&af_c_id=__campaign_id__&af_adset=__aid_name__&af_adset_id=__aid__&af_ad=__cid_name__&af_ad_id=__cid__

    Note

    TikTok automatically adds ttclid={{ttclid}} to the destination URL when the ad is clicked.

View web attribution data

Web conversion events are reported under the tiktokweb_int PID in the media_source field. To view web attribution data, use raw data reports and filter by media_source = tiktokweb_int to isolate TikTok website app conversions.

Dashboard reporting for website app campaigns is not yet available. A unified reporting view that lets you analyze web campaign performance alongside other channels is planned for a future release.

Traits and limitations

Trait Remarks
Cost data

Cost data for TikTok Ads (tiktokglobal_int) website app campaigns is not reported in the dashboard, and it is not reported in the Cost ETL reports either, except for the All Cost report. 
To get TikTok cost data for website app campaigns in the All Cost report, connect your TikTok ad account to the TikTok cost integration (tiktokglobal_int) via the Cost Settings page or the Cost tab.

Clicks and impressions Clicks and impressions for website app campaigns are currently unavailable from TikTok.
Re-engagement Re-engagement postbacks via the Events API are not currently supported.