Step1. Create baidu Account
Login baidu official website to apply for an account
Step2. Create baidu Apps and Ad Place
(1) Add Your App
① Go to the App Collaboration page
② Add mobile apps and verify ownership
(2) create Ad Place Create the corresponding Ad Place type based on the application Ad scenario.
Step3. Configure baidu's Report API
Q1: Can I configure Baidu ad sources without private key and other data configurations, or if I don’t want to configure the Report API?
A: Yes. In the TopOn - Network - Edit, select "Report API" and select "No." You can proceed to the subsequent ad source configuration steps.
Note: It is strongly recommended that you configure the report API to facilitate subsequent data extraction and tuning.
Support using TopOn's public key or the developer's own private key to pull data. Please use different configuration methods according to the following different scenario requirements.
Q2: Should I use the TopOn public key or the developer's own private key?
A: Please configure the configuration according to the specific situations described in 1 and 2 below and select the one that meets your needs.
1. Use TopOn public key
If the data of the current Baidu account only needs to be pulled to the Topon, you can use the TopOn public key configuration
(1) Configure the TopOn public key in the Baidu Union
Note: Developers do not need to generate TopOn public keys by themselves. Since TopOn public keys are provided by Baidu to TopOn, all developers share a set of Baidu public keys and do not need to apply for or configure them from Baidu or TopOn. Please refer to the following steps to proceed.
① Please contact the Baidu Union contact person to enable the API management permission. After enabling, click the account ID in the upper right corner of the Baidu Union, enter Account Management-API Management, and a [View Key] interface will appear.
② Find the corresponding TopOn public key in the TopOn - network - and copy it (please scroll down a little to see the 1.2 Report API configuration page in the following steps for the specific process), and configure it to the specific process), and configure it to the Baidu Alliance background API management - view key page, and click Submit.
Note: The public key of Baidu backend, that is, the input box below, only supports configuring one public key!
(2) Enable Baidu Union’s Report API in the TopOn developer backend
Log in to Topon → Network → Add Network (Baidu Union Ads) → Edit (Open Report API + Use TopOn public key ) → Fill in Access Key and copy TopOn public key (public key needs to be configured to Baidu)
2. Do not use TopOn public key
If the data of the current Baidu account needs to be pulled to multiple platforms, it is recommended that you generate your own public key and private key according to the rules in the Baidu, and configure the generated public key to the Baidu, and configure the generated private key in the Topon. We will use the private key you configured to pull data, and this private key can also be provided to other platforms that need to pull data .
(1) Generate private key and public key in Baidu Union
① Please contact the Baidu Union contact person to enable API Management-Configure Public Key permissions. After enabling, click the account ID in the upper right corner of the Baidu Union, enter Account Management-API Management, and a [View Key] interface will appear.
② Check the key configuration document, generate a private key and a public key according to the document's instructions, and configure the generated public key to the Baidu , as shown in the public key location in the figure below, and click Submit.
Note: The public key of Baidu backend, that is, the input box below, only supports configuring one public key!
(2) Enable Baidu Union’s Report API in the TopOn
Log in to Topon → Network → Add Network (Baidu Union Ads) → Edit (activate report API + do not use TopOn public key ) → Fill in Access Key and configure the private key you generated
1. Check the OpenSSL version. If it is version 3.x, switch to version 1.1.1.
2. Confirm that you have generated a DSA private - public key pair in PEM format. Refer to the Baidu key configuration documentation.
Note: If your account has not opened Report API permissions, you can choose not to open the Report API first. This will not affect your subsequent configuration of placements. You can refer to Step 6. Import Baidu Union data into the TopOn
Step4. Configure baidu on TopOn
TopOn now supports [auto create] of Baidu Union ad sources in the TopOn developer backend. With this function, when you create an ad source in the TopOn backend, TopOn will automatically create ad units in the ad backend. There is no need to create code in the Baidu backend. It can greatly improve efficiency!
Please make sure that your Baidu account has the permission to manage the application code location API. If you do not have this permission, you can apply for it from the Baidu contact person. Turn on the automatic creation of advertising sources function. When you create an advertising source in the TopOn, TopOn will automatically create an ad unit in the advertising background at the same time.
If you do not have the relevant permissions, you can refer to the following configuration steps to manually create the code location and configure it to the TopOn.
The following 2 parameter of baidu need to be configured in TopOn. In this way, baidu can be displayed through TopOn SDK, and baidu data can be displayed through TopOn：
| Parameter name | Description |
|---|---|
| APP ID | baidu unique APP ID for each APP |
| Ad Place ID | baidu unique Ad Place ID for each Ad Place |
● APP ID ：App management→APP ID
● Ad Place ID ：Ad Place management→Ad Place ID
(1) Configure baidu parameters in TopOn
● Add AD Source(path 1) : Login TopOn→Network→Ad Source Setting（Baidu）→Add AD Source
① Fill in the APP ID of the baidu
② Fill in the Ad Place ID of the baidu corresponding to TopOn's APP
● Add Ad Source (path 2): Log in to TopOn → Mediation
After entering, select the corresponding app and placement, choose to add ad source, and fill in the App ID and AD Place ID parameters corresponding to Baidu Union Ads.
(2) Add the corresponding relationship of Baidu Union Ads interstitial screen in TopOn
Click to learn more about Ad Format Mapping
Step5. Add Baidu Union Ads adapter to your code
Refer to the TopOn SDK integration documentation
Step6. Import date of Baidu to TopOn
If your Baidu account does not have the Report API permission, we recommend that you export the data in Baidu and upload it to the TopOn platform. Then you can view the overall revenue of the advertising space on TopOn.
(1) Export data in Baidu
- Log in Baidu, enter Application Cooperation on the homepage, select Data Report->Network Alliance Promotion Report->Custom Report.
- Select the application from the Application drop-down box, select the placement from the placement drop-down box, and select the time period to get needed data from the Date, which supports multi-day import. After the selection is complete, click Query, then Download Report, and select csv file in Download Settings to save.
- The downloaded report is in csv format, and you can upload it directly to TopOn without any processing.
- The downloaded csv format can also be saved as xlsx format, and then directly uploaded to TopOn.
(2) Import data to TopOn
- Log in to the TopOn, select Advanced Features -> Upload Network Report
- Select the Baidu Union platform, and upload the data exported in the Baidu Union background
;}.cls-2{fill:%230868f7;}.cls-3{fill:url(%23未命名的渐变_44);}.cls-4{fill:%23333;}%3c/style%3e%3clinearGradient%20id='未命名的渐变_8'%20x1='33.73'%20y1='100.61'%20x2='-0.03'%20y2='-1.06'%20gradientUnits='userSpaceOnUse'%3e%3cstop%20offset='0'%20stop-color='%237ae9fb'/%3e%3cstop%20offset='0.67'%20stop-color='%232b90f8'/%3e%3cstop%20offset='1'%20stop-color='%230868f7'/%3e%3c/linearGradient%3e%3clinearGradient%20id='未命名的渐变_44'%20x1='27.86'%20y1='18.67'%20x2='68.36'%20y2='22.22'%20gradientUnits='userSpaceOnUse'%3e%3cstop%20offset='0'%20stop-color='%235ac7f2'/%3e%3cstop%20offset='1'%20stop-color='%230868f7'/%3e%3c/linearGradient%3e%3c/defs%3e%3cpath%20class='cls-1'%20d='M29,28.74V81.91l-9.51-3.68v0L8.52,74A7.17,7.17,0,0,1,4,67.32V24.54A3.76,3.76,0,0,1,9.08,21Z'/%3e%3cpath%20class='cls-2'%20d='M68.09,78.07a13.15,13.15,0,0,1-17.9,12.06L29,81.91h0V28.74L50.19,37A13.17,13.17,0,0,0,68.08,25.3h0Z'/%3e%3cpath%20class='cls-3'%20d='M68.08,25.3a13.19,13.19,0,0,1-6.73,10.87A13.09,13.09,0,0,1,50.19,37L29,28.74V6A3.76,3.76,0,0,1,34.1,2.52l25.59,9.91A13.22,13.22,0,0,1,68.08,25.3Z'/%3e%3cpath%20class='cls-4'%20d='M129.06,81.76a4.33,4.33,0,0,1-3.19-1.31,4.4,4.4,0,0,1-1.31-3.24V56.86H97.65V77.21a4.36,4.36,0,0,1-1.35,3.2A4.68,4.68,0,0,1,93,81.76a4.32,4.32,0,0,1-3.19-1.31,4.37,4.37,0,0,1-1.32-3.24V27.27A4.58,4.58,0,0,1,89.83,24a4.59,4.59,0,0,1,7.82,3.27V48.15h26.91V27.27A4.58,4.58,0,0,1,125.91,24a4.59,4.59,0,0,1,7.82,3.27V77.21a4.37,4.37,0,0,1-1.36,3.2A4.65,4.65,0,0,1,129.06,81.76Z'/%3e%3cpath%20class='cls-4'%20d='M163.77,81.66c-6.57,0-11.76-1.92-15.44-5.7s-5.54-9.07-5.54-15.74a26.76,26.76,0,0,1,2.09-10.43,17.72,17.72,0,0,1,6.67-8.06,19.15,19.15,0,0,1,10.68-2.95,19,19,0,0,1,10.46,2.8,18.7,18.7,0,0,1,6.55,7.36,22.53,22.53,0,0,1,2.36,10.28A4.51,4.51,0,0,1,177,63.77H152.23a10.8,10.8,0,0,0,3.49,6.65c2,1.68,4.88,2.52,8.66,2.52a22.25,22.25,0,0,0,7.54-1.21c.74-.3,1.55-.67,2.37-1.07a3.75,3.75,0,0,1,1.84-.4,4.09,4.09,0,0,1,3,1.15,4,4,0,0,1,1.12,3,4.38,4.38,0,0,1-2.58,3.82,32.34,32.34,0,0,1-6.36,2.61A28.67,28.67,0,0,1,163.77,81.66ZM172.4,55.9a9.72,9.72,0,0,0-1.63-4.56A9.9,9.9,0,0,0,167,48a10.38,10.38,0,0,0-4.64-1.14,12,12,0,0,0-4.77,1.06,9.54,9.54,0,0,0-4.89,5.66,11.78,11.78,0,0,0-.51,2.3Z'/%3e%3cpath%20class='cls-4'%20d='M193,81.64a4.49,4.49,0,0,1-4.51-4.55V27.28A4.58,4.58,0,0,1,189.84,24a4.48,4.48,0,0,1,3.28-1.36A4.36,4.36,0,0,1,196.35,24a4.46,4.46,0,0,1,1.31,3.31V77.09a4.34,4.34,0,0,1-1.35,3.2A4.67,4.67,0,0,1,193,81.64Z'/%3e%3cpath%20class='cls-4'%20d='M263.79,81.71a5.7,5.7,0,0,1-4.2-1.74,5.76,5.76,0,0,1-1.73-4.19V27.37a4.58,4.58,0,0,1,1.35-3.27A4.59,4.59,0,0,1,267,27.37V72.53h24a4.58,4.58,0,0,1,3.27,7.82A4.66,4.66,0,0,1,291,81.71Z'/%3e%3cpath%20class='cls-4'%20d='M424.48,81.74a4.71,4.71,0,0,1-2.71-.88,5.43,5.43,0,0,1-1-1l-.07-.09-12.41-17-5.41,5v9.44a4.31,4.31,0,0,1-1.36,3.19,4.66,4.66,0,0,1-3.3,1.36A4.29,4.29,0,0,1,395,80.42a4.36,4.36,0,0,1-1.32-3.23V27.37A4.58,4.58,0,0,1,395,24.1a4.52,4.52,0,0,1,6.58.12,4.54,4.54,0,0,1,1.24,3.15V56.31l17.72-16.38.05,0a4.8,4.8,0,0,1,2.94-1.11,4.4,4.4,0,0,1,3.27,1.2,4.57,4.57,0,0,1,1.2,3.27,4.44,4.44,0,0,1-.77,2.33,7.45,7.45,0,0,1-1.43,1.65l-11,9.64,13.34,17.68a5,5,0,0,1,1,2.71,4.12,4.12,0,0,1-1.36,3.24A4.64,4.64,0,0,1,424.48,81.74Z'/%3e%3cpath%20class='cls-4'%20d='M317.93,81.76a21.5,21.5,0,1,1,21.17-21.5A21.37,21.37,0,0,1,317.93,81.76Zm0-34.1a12.61,12.61,0,1,0,12.42,12.6A12.52,12.52,0,0,0,317.93,47.66Z'/%3e%3cpath%20class='cls-4'%20d='M212.18,101.22a4.12,4.12,0,0,1-3.05-1.26,4.17,4.17,0,0,1-1.26-3.1V43.34a4.37,4.37,0,0,1,1.3-3.14,4.26,4.26,0,0,1,3.13-1.3,4.19,4.19,0,0,1,3.1,1.26,4.32,4.32,0,0,1,1.26,3.16,20.77,20.77,0,0,1,13-4.54,21.51,21.51,0,0,1,0,43,20.51,20.51,0,0,1-13-4.57V96.86a4.15,4.15,0,0,1-1.3,3.06A4.5,4.5,0,0,1,212.18,101.22Zm17.43-53.63c-6.23,0-12.93,4.11-12.93,12.72a12.73,12.73,0,0,0,25.46,0A12.71,12.71,0,0,0,229.61,47.59Z'/%3e%3cpath%20class='cls-4'%20d='M365.76,81.76a21.5,21.5,0,1,1,21.18-21.5A21.37,21.37,0,0,1,365.76,81.76Zm0-34.1a12.61,12.61,0,1,0,12.42,12.6A12.52,12.52,0,0,0,365.76,47.66Z'/%3e%3c/svg%3e)