Create a booth

Ad slots are classified into the following three types based on their configuration method:

• Dynamically configured ad slots

  After you integrate the MCDP SDK into your client, you can create ad slots and configure all their properties in the console. These properties include the ad slot ID, page, display style, position, creative materials, and height. No operations are required on the client.

  Dynamically configured ad slots do not support the waist-seal position.

• Client-preconfigured ad slots

  After you integrate the MCDP SDK into your client, you must first preconfigure some properties of the ad slot in the client code. These properties include the ad slot ID, page, position, and height. Then, you can create the ad slot in the console and enter the preconfigured property parameters. If the information configured in the console is inconsistent with the client configuration, the client configuration prevails.

  • Scenario: Use the client configuration method to implement ad slot positions that are not supported by dynamic configuration, such as the waist-seal position.

  • Recommended pattern: Preconfigure the ad slot ID, page, and position on the client. Configure all other ad slot properties in the console to allow for flexible adjustments.

• Launch screen ad slots

  This is a special type of preconfigured ad slot. An application can have only one launch screen ad slot. The ID of the launch screen ad slot is STARTPAGE by default and cannot be modified.

Create a dynamically configured ad slot

Prerequisites

• The MCDP SDK is integrated into the client.

• For custom ad slots, you must first preconfigure the ad slot on the client. This special ad slot type is used in scenarios that require custom text. For example, for a search box, you can define the text content in the console, but you cannot set its position, width, or height. These properties must be configured on the client.

• On an Android client, the floating layer at the top of the page must contain a ViewGroup control with the tag h5_titlebar, or the layout must contain the AUTitleBar control from the antui-build component. The list header or footer must contain a ListView control.

• On an iOS client, the list header or footer must contain a UITableView control.

Procedure

Log on to the mPaaS console, select the target application, and perform the following steps to create an ad slot:

1. In the left navigation pane, choose Intelligent Delivery > Resource Management > Slot Management and click Create Slot to open the Basic Information page.

2. Enter a name for the ad slot and select Custom ID. Then, enter the page address information and set the validity period (cache time).

   • iOS Page Address: Enter the address of the iOS client page where the ad slot is displayed. Enter the VCName of the page. You can obtain this from the app developer. Example: MPHomeViewController.

   • Android Page Address: Enter the address of the Android client page where the ad slot is displayed. Enter the ActivityName of the page. You can obtain this from the app developer. Example: com.mpaas.demo.cdp.DynamicContent1Activity.

   • H5 Page Address: Enter the address of the H5 page where the ad slot is displayed. Enter the full path of the page. You can obtain this from the app developer. You can use the window.location object to retrieve the full path of the H5 page.

3. Click Next to open the Detailed Configuration page and configure the ad slot details. For a description of each parameter, see Ad slot configuration information.

4. After you confirm that the information is correct, click Submit.

   After the ad slot is created, you can view its information in the ad slot list. You can also edit or delete the ad slot. For more information, see Manage ad slots > Ad slot list.

Create a client-preconfigured ad slot

Prerequisites

To use a client-preconfigured ad slot, you must first preconfigure it in the client project code. You must record the preconfigured ad slot ID, page, and position. You only need to configure the ad slot height in the console. For more information about preconfiguring ad slots, see Configure a preconfigured ad slot (iOS) and Configure a preconfigured ad slot (Android).

Procedure

Log on to the mPaaS console, select the target application, and perform the following steps to create an ad slot:

1. In the navigation pane on the left, choose CDP > Resource Management > Ad Slot Management. Click Create Ad Slot to open the Basic Information page.

2. Enter a name for the ad slot, select Client-preconfigured ID, enter the preconfigured ad slot ID from the client, and set the validity period (cache time).

3. Click Next to open the Detailed Configuration page and configure the ad slot details. For a description of each parameter, see Ad slot configuration information.

4. After you confirm that the information is correct, click Submit.

   After the ad slot is created, you can view its information in the ad slot list. You can also edit or delete the ad slot. For more information, see Manage ad slots > Ad slot list.

Create a launch screen ad slot

Prerequisites

The MCDP SDK must be integrated into the client and the launch screen must be configured. For more information, see Configure an iOS launch screen and Configure an Android launch screen.

Procedure

An application can have only one launch screen ad slot. If a launch screen ad slot already exists in the application, you cannot create another one.

Log on to the mPaaS console, select the target application, and perform the following steps to create an ad slot:

1. In the navigation pane on the left, choose CDP > Resource Management > Ad Slot Management. Click Create Ad Slot to open the Basic Information page.

2. Enter a name for the ad slot, select Launch screen ad slot ID, and set the validity period (cache time).

   Note

   If a launch screen ad slot has already been created for the current application, the Launch screen ad slot ID option is not selectable.

3. Click Next to open the Detailed Configuration page. Select the creative material type and the number of ad spaces. For a description of each parameter, see Ad slot configuration information.

   Important

   A launch screen ad slot displays only one ad space. If you set multiple ad spaces, this setting is ignored.

4. After you confirm that the information is correct, click Submit.

   After the ad slot is created, you can view its information in the ad slot list. You can also edit or delete the ad slot. For more information, see Manage ad slots > Ad slot list.