接口文档SDK业务专题开发者工具

落地页

本节将为您介绍如何在 Marketing API 使用落地页。

目前平台除了自定义落地页外,还支持使用落地页工具创建的落地页。在创建广告创意时,需要先通过page_type指定落地页类型,如希望使用落地页工具创建的落地页,则 page_type 指定为 PAGE_TYPE_TSA_WEB_NONE_ECOMMERCE、PAGE_TYPE_TSA_APP ,并传入对应的页面id;如希望使用自定义落地页,则 page_type 指定为 PAGE_TYPE_DEFAULT ,并传入对应的页面URL。值得注意的是,对于APP类的推广目标,如选择PAGE_TYPE_DEFAULT,无需传入页面URL,系统会以输入的应用id的下载页面作为落地页URL。

不同的推广目标支持的落地页类型(page_type)不同,对应关系如下:

promoted_object page_type page_spec 说明
PROMOTED_OBJECT_TYPE_
LINK
PAGE_TYPE_DEFAULT page_url 不允许传落地页制作工具及枫页落地页的url
PAGE_TYPE_TSA_WEB
_NONE_ECOMMERCE
page_id 传入落地页工具制作的页面id(仅限网站落地页)
PROMOTED_OBJECT_TYPE_
ECOMMERCE
PAGE_TYPE_DEFAULT page_url 不允许传落地页制作工具及枫页落地页的url
PROMOTED_OBJECT_TYPE_
LINK_WECHAT
PAGE_TYPE_DEFAULT page_url 不允许传落地页制作工具及枫页落地页的url
PAGE_TYPE_TSA_WEB
_NONE_ECOMMERCE
page_id 传入落地页工具制作的页面id(仅限网站落地页)
PROMOTED_OBJECT_TYPE_
APP_ANDROID
PAGE_TYPE_DEFAULT 点击进入应用宝下载页
PAGE_TYPE_TSA_APP page_id 传入落地页工具制作的页面id(仅限Android落地页)
PROMOTED_OBJECT_TYPE_
APP_IOS
PAGE_TYPE_DEFAULT 点击进入APPLE STORE下载页
PAGE_TYPE_TSA_APP page_id 传入落地页工具制作的页面id(仅限iOS落地页)
PROMOTED_OBJECT_TYPE_
APP_ANDROID_MYAPP
PAGE_TYPE_DEFAULT 点击进入应用宝下载页
PROMOTED_OBJECT_TYPE_
APP_ANDROID_UNION
PAGE_TYPE_TSA_APP page_id 点击进入联盟下载页
PROMOTED_OBJECT_TYPE_
LOCAL_ADS_WECHAT
PAGE_TYPE_DEFAULT page_url 不允许传落地页制作工具及枫页落地页的url
PROMOTED_OBJECT_TYPE_
QQ_BROWSER_MINI_PROGRAM
PAGE_TYPE_DEFAULT page_url 点击进入QQ浏览器小程序落地页
PROMOTED_OBJECT_TYPE_
QQ_MESSAGE
PAGE_TYPE_DEFAULT page_url 点击进入QQ消息页面

对于广告主在落地页工具制作的落地页,平台提供了 pages/get 接口进行拉取,您可以根据您的推广目标,拉取可投放的页面列表,对应的请求示例如下:

请求示例


curl -G 'https://api.e.qq.com/v1.1/pages/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'filtering=[]' \
-d 'page=1' \
-d 'page_size=10' 
					

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "list": [
            {
                "page_id": "<PAGE_ID>",
                "page_name": "营销组件-商品购物页-20181109",
                "created_time": 1491019858,
                "last_modified_time": 1491098468
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 10,
            "total_number": 1,
            "total_page": 1
        }
    }
}

关于落地页更详细的接口介绍,可参考 接口清单-page