FAQ

General questions

How is Intelligent Delivery priced?

The pricing for Intelligent Delivery is based on the number of ad space API calls and the traffic used for downloading ad space resources.

Product prices vary based on the billing method. For more information, see the Intelligent Delivery pricing in Pay-as-you-go and Subscription.

Console operation questions

The expected ad does not appear in the app after a campaign is published

Check for the following issues:

• In the console, verify that the page address (for dynamic ad spaces) or the client-side preset ID (for preset ad spaces) is configured correctly for the campaign's ad space.

• If the campaign uses a dynamic ad space, check whether the page address set for the ad space conflicts with other ad spaces. The same page address (ad space location) can be used for only one ad space. If multiple ad spaces use the same page address, none of them will work.

An image configured for a launch screen ad space does not appear in the app

If the client's launch page is configured correctly, the launch screen (splash screen) image may not appear because its dimensions do not match the device model.

When you configure assets for a launch screen ad space in a campaign:

• For Android devices, at least one image must have dimensions of 1080 px × 1920 px.

• For iOS devices, the image dimensions must strictly match the size specified in the prompt. Only one image that meets this requirement is needed.

Is redirection to H5 offline packages supported?

Android and iOS clients on baseline version 10.1.68 and later support opening H5 offline packages by clicking them. When you configure the page address for an H5 offline package, make sure that any appended parameters for the offline package page are placed at the end.

• Protocol specification

  In the mpaas://open?h5AppId=30000000&k1=v1&k2=v2… protocol, the fixed components are mpaas, open, and h5AppId.

  • h5AppId is the H5 offline package ID.

  • Other query parameters are passed through to the target page.

• Examples

  • Redirect to an H5 offline package with the ID 30000000: mpaas://open?h5AppId=30000000

  • Redirect to the aaa.html page in an H5 offline package with the ID 30000000: mpaas://open?h5AppId=30000000&url=/aaa.html

Is automatic adjustment supported for image dimensions in banner ad spaces?

When you create a banner slot and set its height to 0, the slot automatically adjusts to the image's aspect ratio.

Android client integration questions

A configured launch screen ad does not appear on the first launch

After you configure an ad for the launch page, the launch screen ad may not appear when the app is launched for the first time. This is usually because the client has not yet retrieved the ad data.

You can call the following interface to check whether local data exists. The launch screen ad is displayed only if local data exists.

public static boolean checkIfSplashPrepared() {
    CdpAdvertisementService serviceByInterface = LauncherApplicationAgent.getInstance().getMicroApplicationContext().findServiceByInterface(CdpAdvertisementService.class.getName());
    return serviceByInterface.checkIfSplashPrepared();
}

What conditions must be met to display list ads in a dynamically configured ad space (custom ad space)?

The page must contain the ListView control.

The client does not display the ad space after a campaign is configured

You can filter for Advertisement in logcat and view the retrieved ad space data to troubleshoot the issue.

View the data for the corresponding ad space ID. The following is a sample log:

getWrapperCallback onSuccess:[SpaceInfo{spaceCode='20201202', iOSViewId='null', androidViewId='null', h5ViewId='null', appId='', spaceObjectList=[SpaceObjectInfo{objectId='15255', contentType='PIC', contentHeight=1080, crontabList=null, behaviors=[SpaceObjectBehavior [behavior=ALWAYS, showTimes=1, closedByUser=false, jumpedByUser=false, behaviorUpdateTime=0, hadShowedTimes=0]], widgetId='', content='null', hrefUrl='https://mcdp-hz.oss-cn-hangzhou.aliyuncs.com/mcdp/ONEXF2EA312171832-default/1606900783534/4b3dcb21535681b162977af38d4e6953.png', shortImgUrl='null', actionUrl='https://www.baidu.com/', gmtStart=1606900730000, gmtEnd=1612084730000, fgColor='null', bgColor='null', textColor='null', widgetColor='null', priority=1, mrpRuleId='', bizExtInfo={picWidth=1080, gmtModified=1606900803000, picHeight=1920, LAYER_TYPE=normal}, timeSensitive=false, clientMinVersion='null', clientMaxVersion='null', logExtInfo={picWidth=1080, gmtModified=1606900803000, picHeight=1920, groupId=13782, LAYER_TYPE=normal}, selfAdapt=false}], location='FULL', height=1080, hasPlaceholder=false, useCacheFirst=false, width=804, reqRpcTime=1606913000272, multiStyle='BANNER', rotationTime=0, close=false, displayMaxCount=1, modifyTime=0, localRuleList=[], extInfo={}}]

1. Based on the ad space ID (spaceCode=20201202), check whether the retrieved ad space data corresponds to the configured campaign ad space.

2. Check whether the spaceObjectList array contains data.

3. Check whether showTimes is greater than hadShowedTimes.

4. If all the preceding information is normal, check for other warning logs and troubleshoot based on the alert information.

iOS client integration questions

Cannot find the relevant header file

You can manually add the following content to the xx-mPaaS-Headers.h file, which is generated in the project's MPaaS folder.

#import <MPPromotion/CDPPromotion.h>

Dynamically configured ad space does not appear

Follow these steps to troubleshoot:

1. Confirm that the iOS page address (class name) for the ad space is configured correctly in the console. If the class name is incorrect, correct it.

2. After you confirm that the class name is correct, check whether the class inherits from DTViewController. If it does not, the ad space will not be displayed.