Intelligent Delivery FAQ

This topic lists common questions about using Intelligent Delivery.

General questions

How is Intelligent Delivery billed?

Intelligent Delivery is billed based on the number of ad space API calls and the traffic from 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

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

Check for the following issues:

• Check whether the page address for a dynamic ad space or the client-side preset ID for a preset ad space is configured correctly in the console.

• If the campaign uses a dynamic ad space, check whether its page address conflicts with other ad spaces. A 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 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 be 1080 px × 1920 px.

• For iOS devices, the image dimensions must strictly match the sizes specified in the console. A single image that meets the size requirements is sufficient.

Does the service support redirection to H5 offline packages?

Yes, it does. The Android and iOS 10.1.68 baseline versions support opening offline packages on click. When you configure the page address for an H5 offline package, ensure that any additional 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 keys for evaluation are mpaas, open, and h5AppId.

  • h5AppId is the offline package ID.

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

• Examples

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

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

Do banner ad spaces support adaptive image sizing?

Yes, they do. When you create a banner ad space, you can set the height to 0. The ad space will then adapt to the image's aspect ratio.

Android client integration questions

The launch screen ad does not appear on the first launch

After you configure a launch screen ad, it may not appear when the app is launched for the first time. This is usually because the client has not pulled the ad data.

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

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

What are the conditions for displaying list ads in a dynamic ad space (custom ad space)?

The page must contain a ListView control.

An ad space does not appear on the client after a campaign is configured

You can filter for Advertisement in logcat and view the pulled 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. Check whether the pulled ad space data matches the configured campaign ad space based on the ad space ID (spaceCode=20201202).

2. Check whether the spaceObjectList array contains data.

3. Check whether showTimes is greater than hadShowedTimes.

4. If all the preceding checks are successful, check for other warning logs and troubleshoot based on the alert information.

iOS client integration questions

Header file not found

Manually add the following line to the xx-mPaaS-Headers.h file. This file is generated in the MPaaS directory of your project.

#import <MPPromotion/CDPPromotion.h>

A dynamic ad space does not appear

Follow these steps to troubleshoot:

1. Confirm that the iOS page address (the class name) for the ad space is correct 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 appear.