UC Ads — Sending data back about App Conversions 1 Sending data about App Conversions 31.01.2018
UC Ads — Sending data back about App Conversions
1
Sending data about App Conversions
31.01.2018
UC Ads — Sending data back about App Conversions
2
Contents
1. Introduction ........................................................................................................................................................................... 3
2. Terms ........................................................................................................................................................................................ 3
3. Process ..................................................................................................................................................................................... 3
4. Setting Instruction on UC Ads Platform ...................................................................................................................... 4
5. Feedback_url: Getting the click information .............................................................................................................. 8
6. Callback_url: Sending data about App conversions ............................................................................................. 10
7. Contact Information ......................................................................................................................................................... 11
UC Ads — Sending data back about App Conversions
3
1. Introduction
In order to evaluate the effectiveness of mobile app advertisements, it is important to track which clicks
on ads led to installing the app. Now we are providing API service supporting this function.
When a user clicks on ads, UC Ads passes the click information to your tracking system. Your tracking
system monitors app installations and launches, and send callbacks to UC Ads with data for each
installation of the app.
In this case, conversion data appears in UC Ads statistics, and the install optimization strategy becomes
available. Currently, we only receive callbacks of application activations, or in other words, the first open
after installation.
2. Terms
An App activation:The first open activity after an application is downloaded and installed.
feedback_url:This is the server address advertiser provides on the UC Ads platform that used to
receive the click information from UC Ads.
callback_url:This is the UC Ads server address which is used to receive conversions from advertisers.
3. Process
1) Users come to the media application, click an ad and download the advertiser’s app;
2) When an ad is clicked, the click information will be sent to UC Ads server. At the same time, the
media app will send request to the feedback_url transferring the click information to the
advertiser’s tracking system.
UC Ads — Sending data back about App Conversions
4
3) When the advertiser’s tracking system receive the request from feedback_url, according to the
device information (GAID or IMEI), it should check if this user has opened the app or not from its
own database which is used to monitor app installation and launches. If this user’s opening activity
is found, the advertiser’s tracking system should send a callback to UC Ads server. Please notice
the callback should be real time.
4) UC Ads server associates each installation callbacks with a particular click, and generates these data
for ad report and further for installation optimization strategy.
4. Setting Instruction on UC Ads Platform
1) Log in UC Ads platform and click “Tools & Assets” on the navigational bar. Find “U-Tracking” and
click For APP;
2) Click “Create Conversions” and create a conversion you want to track. Currently ,we only support
track App activation;
UC Ads — Sending data back about App Conversions
5
Conversion Name:Give a name to your conversion to help you differentiate this conversion from
others.
Package Name:The package name is a unique name to identify a specific app. Generally, the package
name of an app is in the format domain.company.application. For example, the package name of UC
Browser is com.UCMobile.intl
Feedback URL:This is the server address advertiser provides that used to receive the click
information from UC Ads. For example,
http://xxx.xxxx.com?imei={IMEI_SUM}&time={TIMESTAMP}&callback={CALLBACK_URL}
Download URL:The address from where we can download your app.
3) After filling all the blanks, click “Conform” and then you will find the new created conversion in the
table. Click “View” and start to debug.
UC Ads — Sending data back about App Conversions
6
4) Scan QR code and then select the device ID you want to use for data matching and enter the
corresponding ID. Please notice the ID type you selected here should be align with the parameter
that in the feedback_url. For example, if you use imei={IMEI_SUM} in feedback_url, then you should
select IMEI in step 1. Step 2: Download, install and open the app.
UC Ads — Sending data back about App Conversions
7
5) Send callbacks to UC Ads server according to the sections below.
6) In most cases, processing the callback takes less than an hour. If it has been more than one day
since callback was sent but the conversion status has not yet became active, contact
7) If UC Ads server can receive callbacks successfully, the conversion status will become active.
8) Please notice,you have to connect the active conversion with each ad set. In this way, the tracking
process can take into effect.
UC Ads — Sending data back about App Conversions
8
5. Feedback_url: Getting the click information
Feedback_url is the server address advertiser provides on the UC Ads platform (highlighted in red in the
picture below) that used to receive the click information from UC Ads.
UC Ads — Sending data back about App Conversions
9
1. UC Ads server will send request to feedback_url ;
2. Advertiser’s tracking system should response to the request;
3. Protocol:http,get;
4. Feedback_url:A url consists with the server address of the advertiser’s tracking system and some
parameters. UC Ads server will replace the parameter with actual value, including the pre-defined
macros ( see details below) in the {},and some internal ones.
5. An feedback_url example:
http://xxx.xxxx.com?imei={IMEI_SUM}&time={TIMESTAMP}&callback={CALLBACK_URL}
6. Pre-defined Macros
Macro Description Format If Required
IMEI_SUM MD5 hash from the
imei
Example:
imei: 990009261453644
MD5:
required
UC Ads — Sending data back about App Conversions
10
7407e3871ce15e1d02074470e889ba62
GAID Google Play ad ID. Actual value required
CALLBACK_URL The url after url encode required
TIMESTAMP The time when the ad is
sent to the media app
UTC timestamp optional
CAMPAIGN_ID Ad campaign ID Actual value optional
AD_SET_ID Ad set ID Actual value optional
AD_ID Ad Creative ID Actual value optional
IP The IP address of the
device where the app is
downloaded
A.B.C.D optional
7. A response with the code 200 OK means the callback was received by UC ADS.
8. Attentions!
Feedback _url should no more than 1k;
Feedback_url should not be a download url;
All macros should be put in an English, half-angle brace { };
Macros should be written in capital letters;
GAID and IMEI_SUM are required. The advertisers should choose one of them as the key for data
matching.
6. Callback_url: Sending data about App conversions
The callback_url interface is used to report app activation data from the advertiser’s tracking system to
UC Ads — Sending data back about App Conversions
11
UC Ads server. The callback_url is the UC Ads server address which is used to receive conversions from
advertisers. In order to avoid data gap caused by data match failure, UC Ads ask for real time callbacks.
A callback example
1. Given the feedback_url is
http://xxx.xxxx.com?imei={IMEI_SUM}&time={TIMESTAMP}&callback={CALLBACK_ULR}
2. UC Ads server will send a request to the advertiser and replace the pre-defined macros with their
corresponding values.
http://xxx.xxxx.com?imei=7407e3871ce15e1d02074470e889ba62
&time=1486453741749&callback=http%3A%2F%2Flogserver%2Einsight%2Eucweb%2Ecom%2Ftd%
3Ftp%5Ftype%3Droi%26click%5Fid%3D17602408199300842950%26convert%5Fid%3D6%26event%
5Ftype%3D1
3. If the advertiser find the user with imei=7407e3871ce15e1d02074470e889ba62 has successfully
installed and opened the app, then it should send a callback to UC Ads. The callback which
highlighted in yellow above should be url decode before sending back , like this
http://logserver.insight.ucweb.com/td?tp_type=roi&click_id=17602408199300842950&convert_id=2
&event_type=1
Attention:The advertisers do not need to understand the meaning of the parameters. As long as
the device id is found, the callback value should be url decode and send back to UC Ads.
7. Contact Information
UC Ads
https://ucads.ucweb.com
UC Ads — Sending data back about App Conversions
12
China
Phone:+86 (0) 20 66824888
F/10 Tower B GRG Plaza, No. 163, Pingyun Rd., Huangpu West Avenue, Tianhe Dist., Guangzhou,
China,510627
India
Phnoe:+91 (0) 12 44860200
TIME TOWER Unit No 102 B - 102 E, 1st Floor, Times Tower MG Road GURUGRAM India 122001
Indonesia
Phone:+62 (0) 21 29888 544
DBS Bank Tower, 21st Floor, Ciputra World 1, Jl. Prof. Dr. Satrio Kav 3-5, Jakarta 12940