Click URL Configuration Instructions

1. Do not use third-party monitoring networks

2. Use a third-party monitoring network

If your app uses a third-party monitoring network for attribution statistics, you can generate a Tracking link on the third-party monitoring network and complete the configuration according to the following configuration instructions. When a user subsequently clicks on the TopOn cross-promotion link and generates an installation, you can view the installation data in the TopOn Cross Promotion Report. Currently, TopOn cross-promotion has been connected to third-party monitoring networks such as Appsflyer, Adjust, Kochava, and Tenjin, and can receive installation data from the above third-party monitoring networks.

2.1 Appsflyer Configuration Instructions

(1) Log in to AppsFlyer and search for TopOn in Configuration --> Integrated Partners. Find Toponad and click to enter.

(2) In the Integration options, turn on Activate partner and In-app events postback.

(3) In the Attribution Link option, copy the Click attribution link and configure it to the Click URL of the TopOn.

2.2 Adjust configuration instructions

(1) Select the game you want to promote in the Adjust backend and create click links and impression links in a customized way.

Click link example: https://app.adjust.com/cbtest
impression link example: https://app.adjust.com/impression

• Click link example: https://app.adjust.com/cbtest
• Impression link example: https://app.adjust.com/impression

(2) Open Adjust’s custom link generation page (the steps for generating click links are shown below, and the method for generating impression links is similar).

Fill in the address as follows:

https://app.adjust.com/abc?network=topon&gps_adid={gaid}&android_id={androidid}&idfa={idfa}&idfv={idfv}&campaign={offer_id}&adgroup={package_name}&creative={placement_id}

• The content before the ?, is the custom click link generated by the advertiser (required).
• The content after the ?, is the promotion channel information. It is automatically supplemented by TopOn and passed to Adjust (optional, recommended. It is convenient to view the number of installations by channel in the Adjust background).

(3) Configure Install Callback

After adding Install Callback, when the TopOn channel generates an installation, Adjust will send the installation data back to TopOn. Fill in the following TopOn Install PostBack address:

https://postback.mosspf.net/install?click_id={clickid}

(4) Generated URLs

Click Copy URL in Generated URLs and fill it in the TopOn page

Learn more about Adjust configuration instructions

2.3 Tenjin Configuration Instructions

(1) Log in to the Tenjin network and create a TopOn custom channel. Refer to Tenjin's custom channel creation process.

(2) Create a custom CallBack for the TopOn custom channel. When an installation occurs in the TopOn channel, Tenjin will send the installation data back to TopOn.

① Select Create Custom Callback in Tenjin's CallBack.

② Fill in the TopOn installation callback receiving address in the Setting URL:

https://postback.mosspf.net/install?click_id={{click_id}}

③ Select the TopOn channel configured in the first step in Marketing Channels

(3) Create a Tracking link for the application. Refer to Tenjin's Tracking link creation process

(3)Create a Tracking link for the application. Refer to Tenjin's Tracking link creation process
After the Tracking link is successfully created, you will get the following link

• Click link example: https://track.tenjin.io/v0/click/abc
• Impression link example: https://track.tenjin.io/v0/impression/abc

(4) Replace the placeholder of the Tracking link

• It is recommended to add a placeholder supported by TopOn after the link generated by Tenjin to improve the attribution effect

• After adding the placeholder, fill in the link address on the TopOn. The example is as follows:

 https://track.tenjin.io/v0/click/abc?advertising_id={idfa}&click_id={clickid}&campaign_id={offer_id}&site_id={placement_id}&ip_address={ip}&user_agent={user_agent}

• View all placeholders supported by Tenjin

2.4 Kochava Configuration Instructions

(1) Log in to the Kochava (FreeAppAnalytics) , select the app for which you want to generate a tracking link, and select Campaign Manager.

(2) Click Add a Tracker to create a Tracker

(3) Select TopOn from Media Partner

(4) Fill in the generated Tracking link to the TopOn 

2.5 Hot Cloud Configuration Instructions

(1) Log in to the Reyun and generate a Tracking link for the TopOn cross-promotion advertisement.

① Create a custom channel in Reyun network 【配置】-【渠道管理】-【自定义渠道】

② In 【推广管理】-【推广活动管理】, create promotion campaigns for custom channels.

③ Copy the click monitoring link generated by Hot Cloud

// Hot Cloud Link Example

https://uri6.com/tkio/abc

(2) Add the Tracking placeholder of TopOn to the click monitoring link of HotCloud.

• iOS adds the following placeholders: ?idfa={idfa}&ip={ip}&clickid={clickid}&_ry_adplan_id={app_id}&_ry_adcreative_id={placement_id}

//Supplementary placeholder example

https://uri6.com/tkio/abc?idfa={idfa}&ip={ip}&clickid={clickid}&_ry_adplan_id={app_id}&_ry_adcreative_id={placement_id}

• Android adds the following placeholders: ?imei={imei}&mac={mac}&androidid={androidid}&oaid={oaid}&ip={ip}&clickid={clickid}&_ry_adplan_id={app_id}&_ry_adcreative_id={placement_id}

// Supplementary placeholder example

https://uri6.com/tkio/abc?imei={imei}&mac={mac}&androidid={androidid}&oaid={oaid}&ip={ip}&clickid={clickid}&_ry_adplan_id={app_id}&_ry_adcreative_id={placement_id}

(3) Configure Install CallBack (optional)

If you need to send the installation data of Hot Cloud back to Taku, you can add the Taku CallBack address after filling in the placeholder link: 

&callback=http%3A%2F%2Fpostback.mosspf.net%2Finstall%3Fclick_id%3D{clickid}

// Supplementary placeholder example

https://uri6.com/tkio/abc?imei={imei}&mac={mac}&androidid={androidid}&oaid={oaid}&ip={ip}&clickid={clickid}&_ry_adplan_id={app_id}&_ry_adcreative_id={placement_id}&callback=http%3A%2F%2Fpostback.mosspf.net%2Finstall%3Fclick_id%3D{clickid}

2.6 Other third-party monitoring networks

(1) Generate a Tracking link on a third-party monitoring network.

(2) Use TopOn supported placeholders to replace Tracking links.

• Currently, the TopOn supports the following placeholders in Tracking:

• It is recommended to include at least the following parameters in Tracking

(3) Configure Install CallBack (optional)

• Refer to the docking document of the third-party monitoring network and configure the Install Callback address of TopOn on the third-party monitoring network. The install Callback address of TopOn is:

https://postback.mosspf.net/install?click_id={click_id}