sending data about app conversions - ucads.ucweb.com ads mobile app callback...

UC Ads — Sending data back about App Conversions

1

Sending data about App Conversions

31.01.2018


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


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.


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；


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.


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.


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

[email protected].

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.


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.


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


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


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

http://xxx.xxxx.com/?imei=%7bIMEI_SUM%7d&time=%7bTIMESTAMP%7d&callback=%7bCALLBACK_ULR%7d

http://logserver.insight.ucweb.com/td?tp_type=roi&click_id=17602408199300842950&convert_id=2&event_type=1

http://logserver.insight.ucweb.com/td?tp_type=roi&click_id=17602408199300842950&convert_id=2&event_type=1

https://ucads.ucweb.com/


12

China

Phone：+86 (0) 20 66824888

[email protected]

F/10 Tower B GRG Plaza, No. 163, Pingyun Rd., Huangpu West Avenue, Tianhe Dist., Guangzhou,

China,510627

India

Phnoe：＋91 (0) 12 44860200

[email protected]

TIME TOWER Unit No 102 B - 102 E, 1st Floor, Times Tower MG Road GURUGRAM India 122001

Indonesia

Phone：＋62 (0) 21 29888 544

[email protected]

DBS Bank Tower, 21st Floor, Ciputra World 1, Jl. Prof. Dr. Satrio Kav 3-5, Jakarta 12940

mailto:[email protected]



sending data about app conversions - ucads.ucweb.com ads mobile app callback...

Documents