入门指引 授权认证 账号管理 组织管理 广告管理 营销资产
推广内容资产 视频 图片 品牌形象 朋友圈头像昵称跳转页 广告应用分包 落地页 短剧售卖策略 视频号 视频号授权 视频号广告专用账号 微信小店 公众号 Android 渠道包 优量汇流量包 弹幕 本地门店 直播间组件 动态商品图片 动态商品视频 商品库 营销链路
数据洞察 创意工具 投放辅助工具 人群管理 数据上报 审核工具 附录
切换旧版投放 2.0

创建朋友圈头像昵称跳转页

所属权限 ads_management
请求地址 profiles/add
请求方法 POST
Content-Type application/json

全局参数

全局参数是指每一个接口都需要使用到的参数。详情参考,代码案例参考

参数名称 参数类型
access_token 授权令牌,完成 OAuth 2.0 授权后获得,参考授权认证章节
timestamp

当前的时间戳,单位为秒,允许客户端请求最大时间误差为 300 秒。

MarketingAPI 所使用的时间戳,若无特殊说明,均为秒级时间戳

MarketingAPI 所使用的时区为 GMT+8,例如当时间戳为 1494840119 时,表示 2017-05-15 17:21:59

nonce 随机字串标识,不超过 32 个字符,由调用方自行生成,需保证全局唯一性

请求参数

标有*的参数为必填项

名称 类型 描述
account_id*
integer 广告主帐号 id,有操作权限的帐号 id,不支持代理商 id
marketing_goal
enum 营销目的类型,[枚举详情]
可选值:{ MARKETING_GOAL_UNKNOWN, MARKETING_GOAL_USER_GROWTH, MARKETING_GOAL_PRODUCT_SALES, MARKETING_GOAL_LEAD_RETENTION, MARKETING_GOAL_BRAND_PROMOTION, MARKETING_GOAL_INCREASE_FANS_INTERACTION }
marketing_sub_goal
enum 二级营销目的类型,[枚举详情]
可选值:{ MARKETING_SUB_GOAL_UNKNOWN, MARKETING_SUB_GOAL_NEW_GAME_RESERVE, MARKETING_SUB_GOAL_NEW_GAME_TEST, MARKETING_SUB_GOAL_NEW_GAME_LAUNCH, MARKETING_SUB_GOAL_PLATEAU_PHASE_LAUNCH, MARKETING_SUB_GOAL_MINI_GAME_NEW_CUSTOMER_GROWTH, MARKETING_SUB_GOAL_MINI_GAME_RETURN_CUSTOMER_ENGAGEMENT, MARKETING_SUB_GOAL_APP_ACQUISITION, MARKETING_SUB_GOAL_APP_ACTIVATION, MARKETING_SUB_GOAL_NOT_INSTALL_USER, MARKETING_SUB_GOAL_PRE_INSTALL_USER, MARKETING_SUB_GOAL_UNLOADED_USER, MARKETING_SUB_GOAL_SHORT_INACTIVE_USER, MARKETING_SUB_GOAL_LONG_INACTIVE_USER, MARKETING_SUB_GOAL_GAME_VERSION_UPGRADE }
marketing_carrier_type
enum ,营销载体类型(仅当 profile_type 为 PROFILE_TYPE_AUTO_GENERATE 时有效)详见 [枚举详情]
可选值:{ MARKETING_CARRIER_TYPE_APP_ANDROID, MARKETING_CARRIER_TYPE_APP_IOS }
marketing_target_type
enum 推广产品类型,[枚举详情]
可选值:{ MARKETING_TARGET_TYPE_APP_ANDROID, MARKETING_TARGET_TYPE_APP_IOS, MARKETING_TARGET_TYPE_WECHAT_OFFICIAL_ACCOUNT, MARKETING_TARGET_TYPE_PRODUCT, MARKETING_TARGET_TYPE_TRAFFIC, MARKETING_TARGET_TYPE_LOCAL_STORE, MARKETING_TARGET_TYPE_WECHAT_MINI_GAME, MARKETING_TARGET_TYPE_CONSUMER_PRODUCT, MARKETING_TARGET_TYPE_WECHAT_CHANNELS, MARKETING_TARGET_TYPE_WECHAT_CHANNELS_LIVE, MARKETING_TARGET_TYPE_WECHAT_CHANNELS_LIVE_RESERVATION, MARKETING_TARGET_TYPE_MINI_PROGRAM_WECHAT, MARKETING_TARGET_TYPE_APP_QUICK_APP, MARKETING_TARGET_TYPE_CONSUME_MEDICAL, MARKETING_TARGET_TYPE_COMPREHENSIVE_HOUSEKEEPING, MARKETING_TARGET_TYPE_FICTION, MARKETING_TARGET_TYPE_SHORT_DRAMA, MARKETING_TARGET_TYPE_AUDIOVISUAL_ENTERTAINMENT, MARKETING_TARGET_TYPE_BEAUTY_AND_PERSONAL_CARE, MARKETING_TARGET_TYPE_WEDDING_AND_PORTRAIT_PHOTOGRAPHY, MARKETING_TARGET_TYPE_FRANCHISE_BRAND, MARKETING_TARGET_TYPE_ENTERPRISE_SERVICES, MARKETING_TARGET_TYPE_EXHIBITION_BOOTH_DESIGN, MARKETING_TARGET_TYPE_INSURANCE, MARKETING_TARGET_TYPE_BANK, MARKETING_TARGET_TYPE_CREDIT, MARKETING_TARGET_TYPE_INVESTMENT_CONSULTING, MARKETING_TARGET_TYPE_REAL_ESTATE, MARKETING_TARGET_TYPE_TELECOMMUNICATIONS_OPERATOR, MARKETING_TARGET_TYPE_TOURIST_ATTRACTIONS_TICKETS, MARKETING_TARGET_TYPE_RENOVATION_SERVICES, MARKETING_TARGET_TYPE_FURNITURE_AND_BUILDING_MATERIALS, MARKETING_TARGET_TYPE_EXHIBITION_SALES, MARKETING_TARGET_TYPE_MEDICINE_INDUSTRY_COMMERCIAL, MARKETING_TARGET_TYPE_FINANCE, MARKETING_TARGET_TYPE_LOCAL_STORE_PACKAGE, MARKETING_TARGET_TYPE_CATERING_AND_LEISURE, MARKETING_TARGET_TYPE_CHAIN_RESTAURANT, MARKETING_TARGET_TYPE_COMMODITY_SET, MARKETING_TARGET_TYPE_TOURIST_TRAVEL_ROUTE, MARKETING_TARGET_TYPE_TOURIST_CRUISE_LINE, MARKETING_TARGET_TYPE_TOURIST_HOTEL_SERVICE, MARKETING_TARGET_TYPE_TOURIST_AIRLINE_TICKETS, MARKETING_TARGET_TYPE_LOCAL_STORE_COMBINE_WITH_PRODUCT, MARKETING_TARGET_TYPE_ACTIVITY, MARKETING_TARGET_TYPE_STORE, MARKETING_TARGET_TYPE_MINI_GAME_QQ, MARKETING_TARGET_TYPE_PC_GAME, MARKETING_TARGET_TYPE_WECHAT_WORK, MARKETING_TARGET_TYPE_LIVE_STREAM_ROOM, MARKETING_TARGET_TYPE_PERSONAL_STORE, MARKETING_TARGET_TYPE_PLATFORM_CHANNEL, MARKETING_TARGET_TYPE_TWO_WHEEL_VEHICLE, MARKETING_TARGET_TYPE_GOVERNMENT_AFFAIRS, MARKETING_TARGET_TYPE_CAR_ECOLOGY, MARKETING_TARGET_TYPE_WECHAT_STORE_PRODUCT, MARKETING_TARGET_TYPE_APP_HARMONY, MARKETING_TARGET_TYPE_WECHAT_STORE_PRODUCT_SET }
marketing_carrier_id
string 营销载体 id,如安卓应用 id、IOS 应用 id、小游戏 id 等
字段长度最小 0 字节,长度最大 2048 字节
profile_type*
enum 朋友圈头像及昵称跳转页类型,[枚举详情]
可选值:{ PROFILE_TYPE_DEFINITION, PROFILE_TYPE_AUTO_GENERATE }
head_image_id
string ,头像图片 id,通过 [images 模块] 上传图片后获得; profile_type 为 PROFILE_TYPE_DEFINITION 时必填,head_image_id 对应的图片高、宽均为 512px、大小限制 400KB
字段长度最小 1 字节,长度最大 64 字节
profile_name
string ,昵称,自定义时传入,不允许有特殊字符,字段长度最小 1 个等宽字符,长度最大 30 等宽字符(即字段最大长度为 15 个中文字或全角标点,30 个英文字或半角标点。一个等宽字符等价于一个中文,等价于两个英文。)
字段长度最小 1 字节,长度最大 30 字节
description
string ,朋友圈头像及昵称跳转页简介,字段长度最小 1 个等宽字符,长度最大 120 等宽字符(即字段最大长度为 120 个中文字或全角标点,240 个英文字或半角标点。一个等宽字符等价于一个中文,等价于两个英文。); profile_type 为 PROFILE_TYPE_DEFINITION 时必填
字段长度最小 1 字节,长度最大 240 字节

使用说明

  1. 推广目标为微信小游戏时,推广目标 id 需传入微信小游戏原始 id(gh_****)。
  2. profile_type 为 PROFILE_TYPE_DEFINITION 时(即自定义的朋友圈头像昵称跳转页),用户需另传入 head_image_id、profile_name、description 来创建朋友圈头像昵称跳转页。
  3. 用户最多可创建 5 个自定义类型的朋友圈头像昵称跳转页,达到限制后需删除一部分自定义的朋友圈头像昵称跳转页后再创建。

请求示例


curl 'https://api.e.qq.com/v3.0/profiles/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-H 'Content-Type: application/json' \
-d '{
    "account_id": "<ACCOUNT_ID>",
    "profile_type": "PROFILE_TYPE_DEFINITION",
    "head_image_id": 22222,
    "profile_name": "profile name",
    "description": "profile description"
}'
					
复制代码

curl 'https://api.e.qq.com/v3.0/profiles/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-H 'Content-Type: application/json' \
-d '{
    "account_id": "<ACCOUNT_ID>",
    "profile_type": "PROFILE_TYPE_DEFINITION",
    "head_image_id": 22222,
    "profile_name": "profile name",
    "description": "profile description"
}'
					

应答字段

名称 类型 描述
profile_id
integer 朋友圈头像及昵称跳转页 id

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "profile_id": 11111
    }
}

可视化调试工具

正在初始化...
这篇文章是否对你有帮助吗?请评价: