返回
  • 行动按钮组件新增「小程序封面/插屏按钮文案」配置

    2026-09-16


    尊敬的腾讯营销平台客户:
    为提升小程序流量投放的广告体验和转化效果,「行动按钮」组件即将新增「小程序流量按钮文案」字段,选中后对小程序封面广告、插屏广告流量生效。能力预计于 10 月 23 日针对保险服务行业、通信运营商行业、生活优惠资讯行业全量上线。
    image#150px #328px image#146px #318px

    ● API 接口信息
    在 action_button 组件中新增字段:mini_program_button_text。
    dynamic_creatives/add、dynamic_creatives/update 接口传参示例:

    {
      "account_id": 123,
      "adgroup_id": 111,
      "dynamic_creative_name": "创意名称",
      "creative_components": {
        "action_button": [
          {
            "value": {
              "button_text": "下载应用",
              "mini_program_button_text": "小程序流量按钮文案"
            }
          }
        ]
      }
    }
    
    • components/add 接口创建 action_button 组件时,value 字段传参同上

    • 目前字段为选填逻辑,预计于一个月后升级为必填,请各位广告主提前改造升级;

    • 针对不同广告主账户,支持配置不同文案。文案枚举值请通过创意形式详情接口查询:开发文档 | 开发者专区 - 腾讯营销。

    创意形式详情接口返回示例,关注 action_button 组件 mini_program_button_text 的 enum_options 字段:

    {
      "code": 0,
      "message": "",
      "message_cn": "",
      "data": {
        "list": [
          {
            "creative_permissions": {
              "creative_components": [
                {
                  "name": "action_button",
                  "desc": "行动按钮组件",
                  "valid": {
                    "required": false,
                    "min_occurs": 0,
                    "max_occurs": 1,
                    "has_depend": true
                  },
                  "component_type": "ACTION_BUTTON",
                  "component_sub_type_options": [
                    {
                      "component_sub_type": "ACTION_BUTTON",
                      "value_field": [
                        {
                          "name": "mini_program_button_text",
                          "desc": "小程序流量按钮文案",
                          "type": "STRING",
                          "valid": {
                            "required": true,
                            "type": "TEXT",
                            "enum_options": [
                              {
                                "value": "查看保险详情",
                                "desc": "查看保险详情"
                              },
                              {
                                "value": "查看保障详情",
                                "desc": "查看保障详情"
                              }
                            ]
                          }
                        }
                      ]
                    }
                  ]
                }
              ]
            }
          }
        ]
      }
    }
    

    若文案未按枚举值规范填写,将触发 API 报错:

    错误码报错含义
    1800567当前小程序流量按钮文案组件的按钮文案不支持,允许的按钮文案参考[按钮文案示意]。

     

    感谢您的理解与支持。