An ad space is a rectangular area on a client page that displays ad creatives. mPaaS Intelligent Delivery supports ad spaces on multiple clients, such as apps, miniapps, and H5 pages.
Ad space types
Intelligent Delivery supports seven types of ad spaces: launch screen (splash), pop-up, announcement, banner, list, floating icon, and custom. The following figure shows examples of each type.
Launch screen: A full-screen ad space that appears during an app's cold start. Each app can have only one launch screen ad space.
Pop-up: An ad space in a floating layer with a configurable width and height.
Announcement: Delivers information to users through message broadcasts.
Banner: A rectangular ad space in a fixed position on an app page. It supports a horizontal carousel of one or more ad slots.
List: Displays multiple different ad creatives in a list format on an app page.
A Floating button is located at a fixed position on an app page.
Custom: A custom ad type for text-based copy.
Basic information of an ad space
An ad space has basic information such as an ad space name, an ad space ID, and a validity (cache) period.
Ad space name: Required. Enter up to 30 characters. The name must be unique.
Ad space ID: Required. The ID can contain letters, digits, underscores (_), and hyphens (-). The ID must be unique.
Custom ID: Select this option for a dynamic configuration ad space. Then, enter the ad space ID and page address in the Custom ID text box.
iOS page address: Enter the address of the iOS client page where the ad space is displayed. Enter the VCName of the page, which you can obtain from the app developer. An example is
MPHomeViewController. Note that the VCName must inheritDTViewController. Otherwise, the ad space will not be displayed.Android page address: Enter the address of the Android client page where the ad space is displayed. Enter the ActivityName of the page, which you can obtain from the app developer. An example is
com.mpaas.demo.cdp.DynamicContent1Activity.H5 page address: Enter the address of the H5 page where the ad space is displayed. Enter the full path of the page, which you can obtain from the app developer. You can use the
window.locationobject to retrieve the full path of the H5 page.
Client-side preset ID: Select this option for a client-side preset ad space. Then, copy and paste the preset ad space ID into the Client-side preset ID text box. Obtain the ID from the app developer.
Launch screen ad space ID: Select this option for a launch screen ad space. The ID defaults to STARTPAGE and cannot be changed. An application can have only one launch screen ad space. If one already exists, you cannot create another.
Validity (cache) period: Required. This is the duration for which the ad creative is cached after it is loaded. Set this value based on a balance between download traffic and user experience. The time range is from 00:00:00 to 71:59:59.
Ad space configuration
You can configure the ad space type, creative type, position, style, height, width, and number of ad slots.
Ad space type: Intelligent Delivery supports seven ad space types: launch screen, pop-up, announcement, banner, list, floating icon, and custom.
Creative type: Required. This is the type of creative that the ad space supports. Some ad spaces support adjustments to this setting.
Ad space position: Required. This is the position of the ad space on the page. Positions include top floating layer of the page, top of the page, bottom of the page, top of the list, bottom of the list, top left of the screen, top right of the screen, middle left of the screen, middle right of the screen, bottom left of the screen, and bottom right of the screen. Some ad spaces support position adjustments.
The configurable positions vary by ad space type. For more information, see the following table.Top floating layer of the page
Top of the page
Bottom of the page
Top of the list
The ad space is at the top of the page and floats above the page layout. It does not push the original layout down. It is in a fixed position relative to the screen. The ad space width is the same as the page width.
The ad space is at the top of the page and pushes the original page layout down. It is in a fixed position relative to the page. The ad space width is the same as the page width.
The ad space is at the bottom of the page and pushes the original page layout up. It is in a fixed position relative to the page. The ad space width is the same as the page width.
The ad space is at the top of the list (above the first ad slot) and pushes the original list layout down. It is in a fixed position relative to the list. The ad space width is the same as the list width.
Bottom of the list
Top left of the screen
Middle left of the screen
Bottom left of the screen
The ad space is at the bottom of the list (below the last ad slot) and pushes the original list layout up. It is in a fixed position relative to the list. The ad space width is the same as the list width.
This position is only for floating icon ad spaces. The ad space is in the top-left corner of the screen and floats above the page layout. It does not affect the original page layout. It is in a fixed position relative to the screen.
This position is only for floating icon ad spaces. The ad space is in the vertical center of the left side of the screen and floats above the page layout. It does not affect the original page layout. It is in a fixed position relative to the screen.
This position is only for floating icon ad spaces. The ad space is in the bottom-left corner of the screen and floats above the original page layout. It does not affect the original page layout. It is in a fixed position relative to the screen.
Top right of the screen
Middle right of the screen
Bottom right of the screen
The ad space is in the top-right corner of the page and floats above the page layout. It does not affect the original page layout. It is in a fixed position relative to the screen.
This position is only for floating icon ad spaces. The ad space is in the vertical center of the right side of the screen and floats above the page layout. It does not affect the original page layout. It is in a fixed position relative to the screen.
This position is only for floating icon ad spaces. The ad space is in the bottom-right corner of the screen and floats above the original page layout. It does not affect the original page layout. It is in a fixed position relative to the screen.
Style: Required. This is the appearance of the ad space, including background color, foreground color, text color, and control color. Some ad spaces support style adjustments.
Background color: The background color of the ad space. The default is #F8F8F8.
Foreground color: The foreground color of the ad space. The foreground color is the color that appears when the ad space is tapped. The default is #E7E7E5. When the ad space is tapped, the foreground color is displayed if the creative has a redirect URL. Otherwise, the background color is displayed. For more information about configuring redirect URLs, see Configure marketing actions > Ad space delivery.
Text color: The color of the text in the ad space. The default is #FF0000.
Control color: The color of the control (the small speaker icon) in the ad space. The default is #1A1311.
Height: Required. The height of the ad space on the application page, in pixels (px). Some ad spaces support adjustments to this setting.
Width: Required. The width of the ad space on the application page, in px. Some ad spaces support adjustments to this setting.
Number of ad slots: Required. Banner and list ad spaces support multiple frames. The number of ad slots is the number of frames. Some ad spaces support adjustments to this number.
Carousel duration for a single item: This configuration is linked to the number of ad slots. If the number of ad slots is 1, you cannot configure this duration. If the number of ad slots is greater than 1, you can set this duration to an integer from 1 to 10.
Launch screen (splash)
Pop-up
Announcement
Banner
List
Buoy
Custom
Ad space type
√
√
√
√
√
√
√
Creative type
√
√
x
√
√
√
x
Booth location
Default
Default position
Top floating layer of the page
Top floating layer of the page
Top floating layer of the page
Top left of the screen
x
Top of the page
Top of the page
Top of the page
Top right of the screen
Bottom of the page
Bottom of the page
Bottom of the page
Middle left of the screen
Top of the list (for native pages only)
Top of the list (for native pages only)
Top of the list (for native pages only)
Middle right of the screen
Bottom of the list (for native pages only)
Bottom of the list (for native pages only)
Bottom of the list (for native pages only)
Bottom left of the screen
-
-
-
Bottom right of the screen
Style
x
x
√
x
x
x
√
Height
x
√
√
√
√
√
x
Width
x
√
x
x
x
√
x
Number of ad slots
1-10
1
1
1-10
1-10
1
1
Carousel duration for a single item
1-10 seconds
x
x
1-10 seconds
1-10 seconds
x
x
Note: "√" indicates that the feature is supported and must be configured. "x" indicates that the feature is not supported. "-" indicates that there is no content.
Supported creative types
Intelligent Delivery supports the following creative types for ad spaces.
Text: The content is plain text.
Static image: The content is a static image. Supported formats are .png, .jpg, and .jpeg.
Animated GIF: The content is an animated GIF.
Lottie animation: The content is a Lottie animation.
H5 page: The content is an online H5 page.
The supported creative types vary by ad space type. For more information, see the following table.
Launch screen (splash) | Pop-up | Announcement | Banner | List | Marker | Custom | |
|---|---|---|---|---|---|---|---|
Static image | √ | √ | x | √ | √ | √ | x |
Animated GIF | √ | √ | x | √ | √ | √ | x |
Lottie animation | √ | √ | x | √ | √ | √ | x |
H5 page | x | √ | x | √ | √ | x | x |
Text | x | x | √ | x | x | x | √ |
Note: "√" indicates that the feature is supported. "x" indicates that the feature is not supported. | |||||||
Ad space configuration methods
Intelligent Delivery provides two configuration methods for ad spaces: dynamic configuration and client-side preset. Choose the method that best fits your business needs.
When you use miniapps or H5 pages as delivery channels, you can only configure ad spaces using the client-side preset method. Miniapps and H5 pages support only four ad space types: pop-up, announcement, banner, and floating icon.
Dynamic configuration
To use the dynamic configuration method, add the Intelligent Delivery software development kit (SDK) to your client-side project. Then, create ad spaces and configure all their properties in the console. These properties include the ad space name, ad space ID, page, type, creative type, position, width, height, and number of ad slots.
Dynamically configured ad spaces support the pop-up, announcement, banner, list, floating icon, and custom types. For information about the supported positions for each ad space type, see the Position row in the ad space configuration table. Dynamically configured ad spaces do not support the waist banner position.
Note the following when you use dynamic ad spaces:
For custom ad spaces, you must first preset the ad space on the client. This ad space type is special and is used in scenarios that require custom copy. For example, you can define the copy for a search box in the console, but you cannot set the position, width, or height of the search box. These properties must be configured on the client.
In an Android client, the top floating layer or top of the page must contain a
ViewGroupcontrol with the tagh5_titlebaror anAUTitleBarcontrol from theantui-buildcomponent in the layout. The top or bottom of a list must contain aListViewcontrol.In an iOS client, the top or bottom of a list must contain a
UITableViewcontrol.
Client-side preset
To use the client-side preset method, add the Intelligent Delivery SDK to your client-side project. Then, preset some ad space properties in the client-side project code, including the ad space ID, page, position, width, and height. Finally, create the ad space in the console and enter the preset ad space ID to complete the creation. You can also set the width and height in the console, but these settings take effect only if they are not configured in the client-side project.
Client-side preset ad spaces support the pop-up, announcement, banner, list, floating icon, and custom types. You can use the client-side configuration method to implement ad space positions that are not supported by dynamic configuration, such as waist banners.
NotePreset only the ad space ID, page, and position in the client-side project. For easier adjustments, configure the ad space height only in the console.
For information about how to preset ad spaces on different pages, see the following documents:
Android page: To preset an ad space in an Android application, see Preset an ad space.
iOS page: To preset an ad space in an iOS application, see Preset an ad space.
H5 page: You can provision a booth on this page.