开发文档 | 开发者专区 - 腾讯社交广告

微信朋友圈广告

目前 Marketing API 仅支持品牌活动推广、电商推广和本地门店推广这3种标的物类型的朋友圈竞价广告投放（由于腾讯广告投放平台e.qq.com暂不支持朋友圈竞价广告的投放，因此通过Marketing API创建的朋友圈竞价广告暂不支持在e.qq.com查看或编辑），如果您希望通过 Marketing API 投放微信朋友圈广告，您通常需要执行以下步骤：

1、绑定微信公众号并开通广告功能；
2、创建 campaign_type=CAMPAIGN_TYPE_WECHAT_MOMENTS 的推广计划；
3、创建广告组；
4、创建朋友圈广告可用的广告创意；
5、创建广告

相应的流程如下图所示：

1、绑定微信公众号并开通广告功能

通过 Marketing API 投放微信朋友圈广告的前提是广告主必须绑定一个微信公众号且微信公众号已开通广告功能。作为Marketing API的开发者，要开启绑定流程，您的应用程序需要引导客户访问这个页面：

https://developers.e.qq.com/authorization/wechat_bind?access_token=<ACCESS_TOKEN>&redirect_uri=<REDIRECT_URI>&account_id=<ACCOUNT_ID>

其中：

access_token：Marketing API通用的访问令牌，获取方式详见【授权认证】章节
redirect_uri：应用回调地址，授权完成后回调至您应用程序里的地址，仅支持 http 和 https，不支持指定端口号，且主域名必须与创建应用时登记的回调域名一致
account_id：要发起绑定的推广帐号id

页面加载完成后，会出现微信公众号的授权页面，客户需要用对应微信公众号的管理员帐号扫描二维码进行确认，操作完成后，系统会跳转回redirect_uri对应的系统或页面，绑定完成。如下图所示：

特别注意：

微信公众号仅能与广告主帐号进行绑定，不能与代理商帐号进行绑定，有关绑定接口的更详细介绍，可参考接口清单-wechat_bind；
公众号需先开启广告功能才可投放广告，开启方式可通过微信公众平台进行操作，也可调用Marketing API接口进行开通，具体可通过【微信开户资料】进一步了解；

2、创建 campaign_type=CAMPAIGN_TYPE_WECHAT_MOMENTS 的推广计划

创建一个在朋友圈投放的推广计划，您需要设置以下属性：

推广计划名称（campaign_name）：为您的推广计划设置一个名称
推广计划类型（campaign_type）：朋友圈效果广告统一设置为 CAMPAIGN_TYPE_WECHAT_MOMENTS（朋友圈效果广告）。
推广目标（promoted_object_type）：当前支持投放朋友圈广告的推广目标包括网页（微信推广）（PROMOTED_OBJECT_TYPE_LINK_WECHAT）、电商推广（PROMOTED_OBJECT_TYPE_ECOMMERCE）、以及本地广告（微信推广）（PROMOTED_OBJECT_TYPE_LOCAL_ADS_WECHAT）3种。

特别注意：投放电商推广时，会对公众号和链接地址有一定要求，您可以通过广告投放能力接口了解自己的公众号和推广链接是否可以投放。

假设您需要创建一个名为“测试”的朋友圈推广计划用于推广品牌活动页，请求示例如下：

curl 'https://api.e.qq.com/v1.1/campaigns/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=123456' \
-d 'campaign_name=测试' \
-d 'campaign_type=CAMPAIGN_TYPE_WECHAT_MOMENTS' \
-d 'promoted_object_type=PROMOTED_OBJECT_TYPE_LINK_WECHAT'

3、创建广告组

对于朋友圈广告，一个推广计划下仅允许创建10个广告组。创建朋友圈广告组您需要设置以下属性：

所属推广计划（campaign_id）：所属的推广计划属性中的 campaign_type 必须为 CAMPAIGN_TYPE_WECHAT_MOMENTS；
推广目标（promoted_object_type）：必须与推广计划的一致；
推广目标id（promoted_object_id）：声明广告要推广的具体是哪个推广目标id ；
- 推广目标为网页（微信推广）或者电商推广时，无需填写推广目标id，为本地广告（微信推广）时，推广目标id必填，且同一个推广计划下的广告组必须使用相同的推广目标id（门店id）；
- 创建本地门店广告时，需事先在对应的微信公众号中注册登记门店信息，门店信息的登记及获取可以通过微信公众平台提供的接口操作，具体方式可以参考本地门店的创建及获取；
站点（site_set）：朋友圈广告该项须统一设为 SITE_SET_WECHAT；
定向条件（targeting_setting）：用于指定该广告投放给哪些人。相对于普通广告，朋友圈广告出价的设置由定向中所选地域决定，因此对于地域定向有特殊限制，详见朋友圈广告地域定向及价格约束；
优化目标（optimization_goal）：V1.0版本投放朋友圈广告仅支持设置优化目标为 OPTIMIZATIONGOAL_IMPRESSION（根据曝光量优化）；V1.1版本投放朋友圈广告支持微信oCPA，具体方式可以参考【oCPA智能出价广告】；
扣费方式（billing_event）：目前 API 投放朋友圈广告仅支持设置为 BILLINGEVENT_IMPRESSION（按千次曝光 cpm 进行扣费）；
投放起止日期（begin_date、end_date）：需大于等于 6 小时，小于等于 30 个自然日；
出价金额（bid_amount）：朋友圈广告出价需与地域定向中的城市级别匹配，详见朋友圈广告地域定向及价格约束；朋友圈oCPA广告不受此限制，但需满足oCPA的出价要求，具体方式可以参考【oCPA智能出价广告】；
日限额（daily_budget）：100,000 – 1,000,000,000，单位为分/日，币种为人民币。

特别说明：对于朋友圈广告（campaign_type= CAMPAIGN_TYPE_WECHAT_ MOMENTS），一旦广告审核通过且当前时间大于广告投放起始时间，则只允许修改 adgroup 模块的 adgroup_name（广告组名称）、targeting（定向）、bid_amount（出价）、daily_budget（日预算）、configured_status（启用/暂停状态）、end_date（结束投放日期）、time_series（投放时间段）以及 ad 模块的所有属性，广告组其他属性及相关创意模块的所有属性均不允许修改。

假设您需要创建一个名为“测试”的广告组投放给北京、上海的20-30岁女性，请求示例如下：

curl 'https://api.e.qq.com/v1.1/adgroups/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=123456' \
-d 'campaign_id=456792' \
-d 'adgroup_name=测试' \
-d 'site_set=["SITE_SET_WECHAT"]' \
-d 'product_type=PRODUCT_TYPE_LINK_WECHAT' \
-d 'begin_date=2017-04-25' \
-d 'end_date=2017-05-01' \
-d 'billing_event=BILLINGEVENT_IMPRESSION' \
-d 'bid_amount=20000' \
-d 'optimization_goal=OPTIMIZATIONGOAL_IMPRESSION' \
-d 'daily_budget=1000000' \
-d 'targeting={"gender":["FEMALE"],"age":["20~30"],"geo_location":{"regions":[110000,310000],"location_types":["LIVE_IN"]}}' \
-d 'time_series=010100100110100010101010010101010101010100101010101010010101010101001010101010100101010101010111110010101001010110110100110001011001010100101010101010110011001010101010100101100101101110101010101010100110100110010100110101110111101110110110110110110110101101101101110110011101011101101011101101101101001010110111010111011010110110111011' \
-d 'configured_status=AD_STATUS_NORMAL'

4、创建朋友圈广告可用的广告创意

对于朋友圈广告，一个推广计划下仅允许创建一个创意。当前 API 支持的朋友圈广告形式包括常规图片和视频样式（规格id：263、310、311、618）、基础卡片图片和视频样式（规格id：450、452）、标签卡片图片和视频样式（规格id：588、589）、多图样式（规格id：641~649），其中视频、多图样式仅在V1.1版本进行开放。具体规格信息可以通过创意规格查询工具或者创意规格查询接口（adcreative_templates/get）进行了解。

假设您需要创建一个名为“测试”的800×800的创意，请求示例如下（前提是已经把800×800的图片通过images/add接口上传至图片库中并获得了图片id）：

curl 'https://api.e.qq.com/v1.1/adcreatives/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=123456' \
-d 'campaign_id=456792' \
-d 'adcreative_name=测试' \
-d 'adcreative_template_id=311' \
-d 'adcreative_elements={
        "title":"将疲惫一扫而光，然后优雅地出发吧！",
        "image_list":["<IMAGE_ID>"]
    }' \
-d 'share_content_spec={"share_title":"给你介绍一款好咖啡", 
                "share_descripiton":"新客户还有很大优惠哦"}' \
-d 'page_type=["PAGE_TYPE_DEFAULT"]' \
-d 'page_spec={"page_url":"https://www.example.com"}' \
-d 'site_set=["SITE_SET_WECHAT"]' \ 
-d 'promoted_object_type=PROMOTED_OBJECT_TYPE_LINK_WECHAT'

5、创建广告

每条广告都需要归属于某个广告组，目前朋友圈广告限制每个广告组下只能有一条广告。广告中还通过创意做了关联，实现最终的投放（指定的创意呈现给广告组上定向的人群并按广告组的出价进行计费）。

如投放朋友圈oCPA广告，在创建广告时，系统会校验该广告主在所选推广目标、优化目标、应用ID（仅针对移动应用推广）维度下，是否满足广告创意所选规格既定的历史投放数据以及出价要求，如不满足，则将无法成功创建广告。

创建一条朋友圈广告的请求示例如下：

curl 'https://api.e.qq.com/v1.1/ads/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=123456' \
-d 'adgroup_id=456789' \
-d 'adcreative_id=20589' \
-d 'ad_name=测试广告' \

广告投放完后，Marketing API提供的广告预览接口，支持在广告投放期间预览真实的投放效果，广告预览为真实的广告曝光，但不收取费用，一个推广计划最多允许给50个用户（需为公众号粉丝）进行预览，且预览用户提交后不允许修改。广告预览的调用方式可通过【广告预览】进一步了解。

朋友圈广告地域定向及价格约束

朋友圈广告根据地域定向的城市级别不同有不同的出价限制（核心城市 100元-300元，重点城市 60元-200元，其他城市 30元-200元），因此，朋友圈广告组中的定向必须设置地域定向，且同一个广告组设置的定向城市及商圈（商圈的级别与其所属城市的级别保持一致）必须为同一级别。如果您需要定向到不同级别的城市，可以通过创建不同的广告组来实现。

各城市的所属级别您可通过获取定向标签接口进行查询。

朋友圈规格样式介绍

目前，Marketing API 支持的朋友圈广告样式如下表所示，具体规格信息可以通过创意规格查询工具或者创意规格查询接口（adcreative_templates/get）进行了解。

开放样式	图文	视频（V1.1）
常规式广告	单图文，规格id：263、310、311；多图文（仅V1.1开放），规格id：641~649	规格id：618
基础式卡片广告	规格id：450	规格id：452
标签式卡片广告	规格id：588，灰度开放	规格id：589，灰度开放

常规样式说明

以下为263规格的示意图：

① 广告主头像&名称：拉取投放广告的广告主公众号的头像&名称，用户点击可直接跳转广告主公众号介绍页。

② 外层文案：广告主自行输入，文案字数限不超过40个字，不超过4行。

③ 外层图片：广告主自行上传，不同规格支持的图片个数以及要求不同。

④ 链接详情页：广告主自行选择，文字链点击后打开落地页。

⑤ 门店标识：本地门店推广时显示，点击可跳转查看门店详情页。品牌活动页推广无此项。

⑥ 用户社交互动：允许用户对广告创意进行点赞和评论，让用户“参与”到广告中。

其中①⑤⑥由系统自动完成，②③④由您在广告创意中进行设置。

特别说明：

1、图片下方的“查看详情”文字链可以通过创意元素（adcreative_elements）中的link_name_type进行设置，目前支持的枚举值分别为：

VIEW_DETAILS（查看详情）
GET_COUPONS（领取优惠）
MAKE_AN_APPOINTMENT（预约活动）
BUY_NOW（立即购买 – 电商推广专用）
GO_SHOPPING（去逛逛 – 电商推广专用）
ENTER_MINI_PROGRAM （进入小程序 – 投放小程序落地页时专用且必须使用）

选择“领取优惠”，需在落地页中可直接领取优惠;选择“预约活动”，需在落地页中体现活动预约入口。如不满足上述条件，广告将会被审核驳回；

2、常规样式规格默认使用简版原生页作为图片点击后的落地页，即当用户点击图片后，会跳转至系统根据上传的图片文案等信息自动生成的简版原生页（如未使用简版原生页，点击图片为放大效果）。

3、对常规样式规格，文案支持通过\n换行，最多支持3个换行。

4、如填写小程序落地页，文字链点击后将打开对应的小程序落地页，详情可参考微信小程序落地页。

5、对视频样式，除了对时长、格式、视频尺寸、文件大小有要求外，还有以下限制：

视频编码：H.264/AVC
格式类型：Main Profile
采样纵横比：1:1
视频码率：≤ 800 kbit/s
帧率：推荐 24 fps
音频格式：AAC
音频格式类型：LC
音频码率：≤ 96 kbit/sec
音频采样率：推荐 44.1 kHz
Scan type：progressive

有关朋友圈样式的具体说明可通过【微信广告形态介绍】进一步了解。