腾讯广告

尊敬的腾讯广告开发者，

你好，近期在对视频号直播预约进行 API 升级，为了明确表达一条广告只能记录一个直播预约场次，目前将接口 adgroups/add
进行升级：

升级前：

• 当营销载体为「直播预约」时，仅需传入视频号 id

升级后：

• 当营销载体为「直播预约」时，在推广产品或营销载体中传入视频号之外，还需要额外填入直播预约 id,传参示例(参考marketing_carrier_detail和marketing_asset_outer_spec字段)：
  

  {
      "account_id": 123456,
      "adgroup_name": "adgroup_name",
      "marketing_goal": "MARKETING_GOAL_LEAD_RETENTION",
      "marketing_sub_goal": "MARKETING_SUB_GOAL_UNKNOWN",
      "marketing_carrier_type": "MARKETING_CARRIER_TYPE_WECHAT_CHANNELS_LIVE_RESERVATION",
      "marketing_carrier_detail": {
          "marketing_carrier_id": "export/xxx", //视频号 id
          "marketing_sub_carrier_id": "finderlivenotice-v2_xxx@finder-1712115898837218-1745708326" //直播预约 id
      },
      "marketing_asset_outer_spec": {
          "marketing_target_type": "MARKETING_TARGET_TYPE_WECHAT_CHANNELS_LIVE_RESERVATION",
          "marketing_asset_outer_id": "export/xxx", //视频号 id
          "marketing_asset_outer_sub_id": "finderlivenotice-v2_xxx@finder-1712115898837218-1745708326" //直播预约 id
      },
      "site_set": [
          "SITE_SET_MOMENTS"
      ],
      "begin_date": "2025-02-02",
      "end_date": "2025-02-28",
      "time_series": "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
      "bid_mode": "BID_MODE_CPM",
      "smart_bid_type": "SMART_BID_TYPE_CUSTOM",
      "automatic_site_enabled": false,
      "bid_amount": 1100,
      "scene_spec": {
  
      },
      "targeting": {
  
      }
  }
  

  
  

• 广告层级传入直播预约 id 后，创意层级无需传入直播预约 id，如传入将会报错。传参示例(参考wechat_channels_profile_spec字段)：

{
    "creative_components": {
        "brand":[
            {
                "value": {
                    "jump_info": {
                        "page_type": "PAGE_TYPE_WECHAT_CHANNELS_PROFILE",
                        "page_spec": {
                            "wechat_channels_profile_spec": {
                                "username": "export/xxx"
                            }
                        }
                    }
                }
            }
        ],
        "description":[
            {
                "value": {
                    "content": "721 文案 1111"
                }
            }
        ],
        "jump_info":[
            {
                "value": {
                    "page_spec": {
                        "wechat_channels_reserve_spec": {}
                    },
                    "page_type": "PAGE_TYPE_WECHAT_CHANNELS_RESERVE_LIVE"
                }
            }
        ],
        "wechat_channels":[
            {
                "value": {
                    "live_promoted_type": "LIVE_PROMOTED_TYPE_SHORT_VIDEO",
                    "username": "export/xxx",
                    "finder_object_visibility": false
                }
            }
        ],
        "video":[
            {
                "value": {
                    "video_id": "123456",
                    "cover_id": "12345"
                }
            }
        ]
    },
    "account_id": 12345,
    "adgroup_id": "111111",
    "configured_status": "AD_STATUS_NORMAL",
    "creative_template_id": 721,
    "dynamic_creative_type": "DYNAMIC_CREATIVE_TYPE_COMMON",
    "delivery_mode": "DELIVERY_MODE_COMPONENT",
    "dynamic_creative_name": "dynamic_creative_name"
}

如你有使用对应能力,请进行对应更新。我们将在2025-04-30之后，对于未升级的应用 id 报错。