创建动态创意

开发环境

POST

/v1.3/dynamic_creatives/add

具体完整参数请参考：https://developers.e.qq.com/docs/api/adsmanagement/dynamic_creatives/dynamic_creatives_add?version=1.3&_preview=1

使用说明

注意：支持动态创意元素的传参使用带_options 后缀的参数。可通过 [创意规格查询工具] 进行查询哪些元素支持动态创意。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST '/v1.3/dynamic_creatives/add' \
--header 'access_token;' \
--header 'timestamp;' \
--header 'nonce;' \
--data-urlencode 'account_id=<ACCOUNT_ID>' \
--data-urlencode 'dynamic_creative_name=test' \
--data-urlencode 'dynamic_creative_template_id=471' \
--data-urlencode 'dynamic_creative_elements={"corporate":{"corporate_name":"DC 规格"},"image_options":["141201:db1c272f4daf9a8261db5bd49ab88632","141201:dfdbedd1a4870a21e392ee8569f663ff"],"title_options":["1111111111111111testetetetsttest11","1111111111111111testtestett2"]}' \
--data-urlencode 'campaign_type=CAMPAIGN_TYPE_NORMAL' \
--data-urlencode 'promoted_object_type=PROMOTED_OBJECT_TYPE_APP_IOS' \
--data-urlencode 'page_type=PAGE_TYPE_DEFAULT' \
--data-urlencode 'site_set=["SITE_SET_TENCENT_NEWS"]' \
--data-urlencode 'promoted_object_id=1044283059' \
--data-urlencode 'page_spec={"page_url":"https://www.example.com"}' \
--data-urlencode 'link_page_spec={
    "mini_program_spec": {
        "mini_program_paths": []
    },
    "mini_game_spec": []
}' \
--data-urlencode 'deep_link_url=http://www.example.com' \
--data-urlencode 'impression_tracking_url=http://www.example.com' \
--data-urlencode 'click_tracking_url=http://www.example.com' \
--data-urlencode 'share_content_spec=[]' \
--data-urlencode 'dynamic_adcreative_spec=[]' \
--data-urlencode 'video_end_page=[]' \
--data-urlencode 'floating_zone={
    "floating_zone_jump_info": [
        {
            "page_spec": {
                "page_url": "https://www.example.com"
            },
            "page_type": "PAGE_TYPE_DEFAULT",
            "landing_page_info": [],
            "media_query": []
        }
    ]
}' \
--data-urlencode 'barrage_list=[]' \
--data-urlencode 'app_gift_pack_code={
    "code": 0
}' \
--data-urlencode 'union_market_spec=[]' \
--data-urlencode 'program_creative_info=[]' \
--data-urlencode 'head_click_spec=[]' \
--data-urlencode 'campaign_id=<CAMPAIGN_ID>'

响应示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "dynamic_creative_id": 123
    }
}

请求参数

Header 参数

access_token

string

必需

以Query Parameter方式在请求路径中传递。授权令牌，完成 OAuth 2.0 授权后获得，参考授权认证章节。

默认值:

<ACCESS_TOKEN>

timestamp

string

必需

以Query Parameter方式在请求路径中传递。当前的时间戳，单位为秒，允许客户端请求最大时间误差为300秒。
MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳
MarketingAPI 所使用的时区为GMT+8，例如当时间戳为1494840119时，表示 2018-05-15 17:21:59

默认值:

nonce

string

必需

以Query Parameter方式在请求路径中传递。随机字串标识，不超过32个字符，由调用方自行生成，需保证全局唯一性。

默认值:

<NONCE>

Body 参数application/x-www-form-urlencoded

account_id

integer

必需

广告主帐号 id，有操作权限的帐号 id，不支持代理商 id

示例值:

<ACCOUNT_ID>

dynamic_creative_name

string

必需

广告创意名称，同一帐号下的广告创意名称不允许重复（字段长度最小 1 个等宽字符，长度最大 60 等宽字符（即字段最大长度为 60 个中文字或全角标点，120 个英文字或半角标点。一个等宽字符等价于一个中文，等价于两个英文。）
字段长度最小 1 字节，长度最大 180 字节

示例值:

test

dynamic_creative_template_id

integer

必需

创意规格 id，具体请咨询您的运营接口人，也可通过 [创意规格查询工具] 进行查询，dynamic_creative_type 为 DYNAMIC_CREATIVE_TYPE_PROGRAM 时不传该参数

示例值:

471

dynamic_creative_elements

string

创意元素

必需

示例值:

{"corporate":{"corporate_name":"DC 规格"},"image_options":["141201:db1c272f4daf9a8261db5bd49ab88632","141201:dfdbedd1a4870a21e392ee8569f663ff"],"title_options":["1111111111111111testetetetsttest11","1111111111111111testtestett2"]}

campaign_type

string

必需

推广计划类型，[枚举详情]
枚举列表：{ CAMPAIGN_TYPE_NORMAL, CAMPAIGN_TYPE_SEARCH }

示例值:

CAMPAIGN_TYPE_NORMAL

promoted_object_type

string

必需

推广目标类型，[枚举详情]
枚举列表：{ PROMOTED_OBJECT_TYPE_LINK, PROMOTED_OBJECT_TYPE_LINK_WECHAT, PROMOTED_OBJECT_TYPE_ECOMMERCE, PROMOTED_OBJECT_TYPE_APP_ANDROID, PROMOTED_OBJECT_TYPE_APP_QUICK_APP, PROMOTED_OBJECT_TYPE_APP_IOS, PROMOTED_OBJECT_TYPE_APP_ANDROID_MYAPP, PROMOTED_OBJECT_TYPE_APP_ANDROID_UNION, PROMOTED_OBJECT_TYPE_QQ_BROWSER_MINI_PROGRAM, PROMOTED_OBJECT_TYPE_LOCAL_ADS_WECHAT, PROMOTED_OBJECT_TYPE_QQ_MESSAGE, PROMOTED_OBJECT_TYPE_LEAD_AD, PROMOTED_OBJECT_TYPE_MINI_GAME_WECHAT, PROMOTED_OBJECT_TYPE_MINI_GAME_QQ, PROMOTED_OBJECT_TYPE_WECHAT_OFFICIAL_ACCOUNT }

示例值:

PROMOTED_OBJECT_TYPE_APP_IOS

page_type

string

可选

落地页类型，[枚举详情]
枚举列表：{ PAGE_TYPE_DEFAULT, PAGE_TYPE_TSA_APP, PAGE_TYPE_TSA_WEB_NONE_ECOMMERCE, PAGE_TYPE_CANVAS_WECHAT, PAGE_TYPE_MINI_PROGRAM_WECHAT, PAGE_TYPE_FENGYE_ECOMMERCE, PAGE_TYPE_MINI_GAME_WECHAT, PAGE_TYPE_MOMENTS_SIMPLE_NATIVE_WECHAT, PAGE_TYPE_MINI_PROGRAM_CANVAS_WECHAT, PAGE_TYPE_MINI_GAME_QQ, PAGE_TYPE_MINI_PROGRAM_QQ, PAGE_TYPE_FENGSHU_MINI_PROGRAM, PAGE_TYPE_FENGYE_EC_WECHAT_MINIPROGRAM, PAGE_TYPE_YUEBAO_QUICKAPP, PAGE_TYPE_YUEBAO_OFFICIAL_ACCOUNT_ARTICLE, PAGE_TYPE_XIJING_QUICK }

示例值:

PAGE_TYPE_DEFAULT

site_set

string

可选

投放版位集合，当前单版位或者 SITE_SET_TENCENT_NEWS+SITE_SET_TENCENT_VIDEO+SITE_SET_MOBILE_UNION+SITE_SET_KANDIAN+SITE_SET_QQ_MUSIC_GAME 的组合，[枚举详情]
数组最小长度 1，最大长度 32
枚举列表：{ SITE_SET_QZONE, SITE_SET_QQCLIENT, SITE_SET_MUSIC, SITE_SET_MOBILE_UNION, SITE_SET_QQCOM, SITE_SET_WECHAT, SITE_SET_MOBILE_INNER, SITE_SET_TENCENT_NEWS, SITE_SET_TENCENT_VIDEO, SITE_SET_TENCENT_KUAIBAO, SITE_SET_MOBILE_MYAPP, SITE_SET_PCQQ, SITE_SET_KANDIAN, SITE_SET_QQ_MUSIC_GAME, SITE_SET_MOMENTS, SITE_SET_KUAISHOU, SITE_SET_MINI_GAME_WECHAT, SITE_SET_MINI_GAME_QQ, SITE_SET_MOBILE_GAME, SITE_SET_MOBILE_YYB, SITE_SET_QQSHOPPING, SITE_SET_CHANNELS, SITE_SET_WECHAT_SEARCH, SITE_SET_WECHAT_PLUGIN, SITE_SET_FREETRADE, SITE_SET_QBSEARCH, SITE_SET_FREETRADE_FINDER, SITE_SET_BROWSER_MOBILE, SITE_SET_SEARCH_SCENE, SITE_SET_BROWSER_PC, SITE_SET_CHANNELS_CONTENT_PROMOTION, SITE_SET_FREETRADE_WEAPP }

示例值:

["SITE_SET_TENCENT_NEWS"]

promoted_object_id

string

可选

推广目标 id，详见 [查询推广目标 id]
字段长度最小 0 字节，长度最大 128 字节

示例值:

1044283059

page_spec

string

可选

落地页信息，根据不同 promoted_object_type 和 page_type，要求的 page_spec 信息不同

示例值:

{"page_url":"https://www.example.com"}

link_page_spec

string

可选

文字链跳转信息，根据不同 promoted_object_type 和 page_type、link_page_type，要求的 link_page_spec 信息不同

示例值:

{ "mini_program_spec": { "mini_program_paths": [] }, "mini_game_spec": [] }

deep_link_url

string

可选

应用直达页 URL
字段长度最小 0 字节，长度最大 2048 字节

示例值:

http://www.example.com

impression_tracking_url

string

可选

曝光监控地址，监控地址主域只允许白名单内的域名，详见 [第三方监控]
字段长度最小 0 字节，长度最大 1023 字节

示例值:

http://www.example.com

click_tracking_url

string

可选

监控链接，监控地址主域只允许白名单内的域名，详见 [第三方监控]
字段长度最小 0 字节，长度最大 1024 字节

示例值:

http://www.example.com

share_content_spec

string

可选

分享信息，仅在部分朋友圈创意规格下设置有效，具体可通过 [创意规格查询工具] 或 adcreative_templates/get 接口进行查询，若该字段不为空，则表示投放简版原生推广页（点击图片后会跳转至系统自动生成的简版原生推广页）

示例值:

[]

dynamic_adcreative_spec

string

可选

动态商品广告属性，当创意为动态商品广告创意时，该字段必填

示例值:

[]

video_end_page

string

可选

视频播放结束页，（当前仅支持互动推广页）

示例值:

[]

floating_zone

string

浮层卡片创意内容

可选

示例值:

{ "floating_zone_jump_info": [ { "page_spec": { "page_url": "https://www.example.com" }, "page_type": "PAGE_TYPE_DEFAULT", "landing_page_info": [], "media_query": [] } ] }

barrage_list

string

可选

弹幕列表
数组最小长度 0，最大长度 20

示例值:

[]

app_gift_pack_code

string

可选

礼包码，微信朋友圈广告创意形式需要填写，礼包码

示例值:

{ "code": 0 }

union_market_spec

string

可选

厂商下载信息，厂商下载信息，仅可在跳转厂商应用商店（union_market_switch）值为 true 时使用。

示例值:

[]

program_creative_info

string

可选

动态创意（升级版）信息，dynamic_creative_type 为 DYNAMIC_CREATIVE_TYPE_PROGRAM 时必填

示例值:

[]

head_click_spec

string

可选

头像点击跳转信息，头像点击跳转信息，目前支持跳转搜一搜品牌专区，白名单开放中，如果需要使用请联系您的运营经理

示例值:

[]

campaign_id

string

推广计划 id

可选

示例值:

<CAMPAIGN_ID>

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

message_cn

string

必需

data

object

必需

dynamic_creative_id

integer

广告创意 id

必需

修改于 2023-11-06 04:07:00

删除广告创意

更新动态创意