Tencent Ads, one of AppsFlyer's integrated partners, is one of the leading ad networks in digital marketing. Tencent operates the leading social, media and mobile utility properties in China.
Tencent enables marketers to run app install campaigns on Weixin / WeChat, the company’s mobile communication platform with over 800 million combined monthly active users; QQ, its instant messaging service with nearly 900 million monthly active users; and other Tencent properties including QQ Music, QQ Browser, Myapp, and others.
- IMEI is mandatory for Android app attribution, IDFA is mandatory for iOS App attribution. For details of the AppsFlyer SDK Integration, refer to the guides Android and iOS.
- To promote your Android App via Tencent, you must upload your Android App to the Tencent Developer Platform, here.
- For more details about Tencent, click here.
To configure your campaigns with Tencent, follow the steps below.
Setting up Tencent campaign
Once you have registered your app with AppsFlyer, you must setup a campaign in the dashboard.
To do this, click the app that you want to advertise or select Overview from the dropdown menu.
Configuring the integrated partner
Go to the dashboard of your app and click on Integrated Partners on the left bar.
Enter "Tencent" in the search field and select "Tencent - New API" to open the Tencent configuration window.
Depending on your integration type, the configuration can have up to two active tabs:
- If you have an SRN (direct) configuration, only the Integration tab is active.
- If you use links for click attribution, the Integration and Attribution link tabs are active.
For a detailed description of the Partner Configuration Window Header, click here.
- The General Settings step in the Integration tab is mandatory for all partners
- All the rest of the steps are either descriptive or optional
The Integration Tab is divided into different sections as described below. The partner must be activated on first visit, to enable its setup. This section is used for connecting the partner with AppsFlyer. Relevant messages for the advertiser regarding the specific partner also appear here.
Tencent requires connecting with AppsFlyer via a unique Tencent App ID, Encrypt Key and Sign Key given to the advertiser by the partner.
To obtain these credentials, in the Tencent Configuration window, do the following:
- Select Activate Partner.
- Enter your Tencent Account ID. Your Tencent Account ID can be found in the top bar inside the Tencent platform. Make sure to only take the numeric digits from your ID.
Enter the Tencent App ID for the App you are promoting.
For iOS, this is the same App ID listed in iTunes.
Tencent App ID of this iOS App is 554782625.
For Android, the Tencent App ID can be found by following the steps outlined below:
Login to the Tencent Apps Management platform using this link: http://op.open.qq.com/
- Copy the Tencent App ID, as in the screenshot below.
- Click Save in the AppsFlyer dashboard.
- Click API Authentication. The Authorization screen opens, click to authorize AppsFlyer for attribution.
AppsFlyer can send automatic postbacks to Tencent following user installs. Use this section to define the source of the users that allow sending these postbacks. This configuration is available only if you use links for attribution.
Select Only events attributed to this partner for events coming only from users attributed to Tencent.
Select Events attributed to any partner or organic to have your entire user base available to be reported to Tencent.
If you're an advertiser and the Sending option is greyed out (read-only mode), contact your CSM to make it configurable.
If you're an agency, the option available by default is Only events attributed to this partner. To send all events to Tencent, ask the advertiser the following:
- Authenticate with a separate Tencent account on AppsFlyer.
- Select the option Events attributed to any partner or organic under Default postbacks.
Set the maximum period of time after an ad click, within which an install can be attributed to the ad. The shortest possible duration of the window is 1 hour, and the longest is 30 days.
Note: If you use links for click attribution, the click-through setup is located in the Attribution link tab.
In-app event settings
In this section, you can map your AppsFlyer events with the partner via postbacks.
- Set the IDs again here
- Toggle In-app event postbacks ON
- Click Add Event to add an SDK Event to the list
- Fill in the following parameters in the table below
- Click Save.
|SDK Event Name||The name of the event, as received by AppsFlyer either from the SDK integrated in your app, or from server to server events.
Tip - don't see the event you want in the list? Make sure to activate the event on a device with a non-organic installation and recheck.
|Partner Event Identifier||The unique name or ID of each event as defined on the partner's side. Select the most suitable pre-defined event for your SDK event.|
|Sending option||Select the sending option for the event:
Only events attributed to this partner for events coming only from users attributed to this partner
Events attributed to any partner or organic to have your entire user base available to be reported to the partner
|Send Revenue||When unchecked - AppsFlyer sends all the parameters of the rich in-app event to the partner, except for the revenue parameter, which is contained in the af_revenue parameter.
When checked - AppsFlyer sends all the parameters including the revenue value (if exists in the event).
Note, monetary values are always sent to Tencent in USD (according to the conversion rate at the time of the event), regardless of the default currency of the app.
Attribution link tab
Tencent is a self-reporting network (SRN). This means it has direct integration with AppsFlyer and doesn’t require custom click links for attribution.
Integrations created starting Feb 13, 2020 and later, are SRN integrations, and show this tab as inactive. No additional actions are needed here.
If you activated the integration with Tencent before Feb 13, 2020, you still need to use click links for attribution. To learn how, please read the instructions in this section.
In this tab, you can create the attribution links you want to send to Tencent for measuring campaigns, ad sets or even single ads. Note that AppsFlyer DOES NOT save your generated partner's attribution links.
Attribution link parameters
In this section, select which parameters you want to add to the attribution link.
Adding parameters to the attribution link here enables you to later perform thorough drill-down analyses. Parameters that are already defined on the attribution link can be edited by adding them and their new values here.
- Campaign - Due to user privacy, Tencent Ads doesn't share campaign names with AppsFlyer. You can only see campaign names in your Tencent Ads account. You can add a campaign name to the attribution link but since Tencent accounts are limited to one attribution link, the campaign name can only be used to distinguish between Tencent accounts. As a general rule, avoid adding campaign name parameters to the attribution link when configuring a campaign with Tencent.
- Adset - set ad set names to compare different ad sets within specific Tencent campaigns.
Attribution link parameter: af_adset
- Ad Name - set ad set names to compare different creatives within specific ad sets within specific campaigns Tencent.
Attribution link parameter: af_ad
- Site ID and Sub Site ID - set Site ID parameter to attribute installs to specific publishers. If many publishers exist, we advise on limiting the number of used site IDs and using the sub site ID parameter, to avoid exceeding the site ID limitations.
Attribution link parameters: af_siteid and af_sub_siteid
- Subscriber Parameters - use any of the 5 subscriber parameters to insert useful values. Note that these parameters get parsed and appear in the raw data report, which makes them very handy for performing data aggregation or filtering.
Attribution link parameters: af_sub1, af_sub2, af_sub3, af_sub4, af_sub5
Add any other parameter to the attribution link simply by typing it in a new parameter box. For more information about AppsFlyer's Attribution Link Structure and Parameters.
Get the AppsFlyer Attribution link and paste it on the Tencent dashboard.
Go to the Tencent dashboard >> Tool Box >> Conversion:
Click Acquire Click Data:
Enter the AppsFlyer attribution link in the Feedback URL field and any other information to enable the click recording.
Now the attribution service for your User Acquisition campaigns on Tencent has been activated. You can start promoting your Apps on Tencent. If you want to pause the attribution, you can simply uncheck the “Enable Attribution” item in the configuration window.
- Android and iOS apps should be configured separately.
- Performance data is not split by campaign/creative on AppsFlyer's dashboard.
- Advertisers and Agencies should perform the configuration separately.
This slider allows you to set the maximum time from click to install. Only installs (first launches) that take place within the lookback window may be attributed to Tencent.
Attribution link parameter: af_click_lookback
More details about the click lookback window here.
Cost integration is not available for Tencent.
Ad revenue tab
Ad revenue integration is not available for Tencent.
In this tab, you can select the permissions to grant Tencent. Note that even if attribution is disabled for Tencent, the permissions tab is active and you can grant control to Tencent.
Use these toggles to give the ad network permissions to handle its own configuration for your app:
Ad network permissions
- Allow to configure integration - permit the partner to setup the integration tab (except in-app event postbacks)
- Allow to configure in-app event postbacks - permit the partner to setup in-app event postbacks mapping to itself on the integration tab
- Allow access to your retention report - only to the partner's own retention data
- Allow access to your aggregate loyal user data - only to the partner's own loyal user data
- Allow access to your aggregate in-app events data - only to the partner's own in-app events data
- Allow access to your aggregate revenue data - only to the revenue data attributed to the partner
- Allow access to your Protect360 dashboard - only to the partner's own Protect360 data, and providing the feature is enabled for the advertiser
Learn more about granting ad network permissions.