本文將用戶在使用智能投放過程中經常遇到的問題進行分類整理,以供參考。
通用問題
智能投放如何收費
智能投放的收費標準與展位接口調用次數以及展位資源下載流量相關。
不同的付費模式下,產品價格會有所差異。具體參見 后付費模式 和 資源包模式 中的智能投放產品定價。
控制臺操作相關問題
活動上線后,在 App 中沒有看到預期的廣告
排查是否存在以下問題:
檢查控制臺上配置的活動所用展位的頁面地址(動態展位)或客戶端預置 ID(預置展位)是否配置正確。
如果活動使用的是動態展位,需檢查該展位所設置的頁面地址是否與其他展位沖突。同一個頁面地址(展位位置)只能用于一個展位。如果存在多個展位使用同一個頁面地址,則這些展位都無法生效。
在控制臺上配置了開屏展位的圖片,但在 App 中未顯示
在客戶端啟動頁配置無誤的情況下,開屏(閃屏)圖片未展示的原因可能是圖片尺寸與機型不適配。
在活動中配置開屏展位的物料時:
針對 Android 設備,要求至少有一張圖片的尺寸為 1080 px × 1920 px。
針對 iOS 設備,圖片需要嚴格按照提示的尺寸進行設置,有一張符合尺寸要求的圖片即可。
是否支持 H5 離線包跳轉
Android 和 iOS 10.1.68 基線版本均支持點擊打開離線包。在配置 H5 離線包頁面地址時,確保離線包頁面的附帶參數后置。
協議規范
mpaas://open?h5AppId=30000000&k1=v1&k2=v2…
協議中,固定判斷的 key 為mpaas
、open
、h5AppId
,其中:h5AppId
指離線包 ID。其他查詢參數透傳到目標頁面。
示例
跳轉到 ID 為 30000000 的離線包:
mpaas://open?h5AppId=30000000
跳轉到 ID 為 30000000 的離線包指定頁面
aaa.html
:mpaas://open?h5AppId=30000000&url=/aaa.html
banner 展位的圖片尺寸是否支持自適應
創建 banner 展位時,如果將展位高度設置為 0,則展位就會根據圖片本身比例自適應。
Android 客戶端接入相關問題
配置啟動頁開屏后,首次不展示
配置啟動頁的廣告投放后,首次啟動 App 時沒有展示啟動頁開屏原因一般是客戶端沒有拉取到數據。
需要調用以下接口,檢查本地數據是否存在。只有在本地數據存在的情況下,啟動頁開屏才會展示。
public static boolean checkIfSplashPrepared() {
CdpAdvertisementService serviceByInterface = LauncherApplicationAgent.getInstance().getMicroApplicationContext().findServiceByInterface(CdpAdvertisementService.class.getName());
return serviceByInterface.checkIfSplashPrepared();
}
在動態配置展位(自定義展位)展示列表廣告需滿足哪些條件
頁面必須包含 ListView
這個控件。
配置活動后,客戶端未展示展位
通過 logcat
過濾 Advertisement
,查看拉取的展位數據進行問題排查。
查看對應展位 ID 的數據,日志示例如下:
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={}}]
根據展位 ID(spaceCode=20201202)查看拉取的展位數據是否是配置的活動展位。
查看
spaceObjectList
的數組里是否有數據。查看
showTimes
是否大于hadShowedTimes
。若以上信息都正常,則查看是否有其他 warn 日志,并根據告警信息進行排查。
iOS 客戶端接入相關問題
找不到相關頭文件
在工程 MPaaS
目錄下生成的 xx-mPaaS-Headers.h
文件中手動添加以下內容即可。
#import <MPPromotion/CDPPromotion.h>
動態配置展位不顯示
排查步驟如下:
確認控制臺上配置的展位的 iOS 頁面地址(即類名)是否正確,若類名有誤,則予以修正。
確認類名無誤后,檢查該類名是否繼承了
DTViewController
,如不繼承,則展位將無法展示。