接口文档SDK业务专题开发者工具

微信朋友圈广告

目前 Marketing API 可支持品牌活动推广、电商推广和本地门店推广等多种标的物类型的朋友圈竞价广告投放,朋友圈创意形式具体支持的投放目标可通过官网创意形式查询工具或创意信息查询接口(adcreative_templates/get)进行查询。

相应的流程如下图所示:

具体步骤如下:

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

通过 Marketing API 投放微信朋友圈广告的前提是广告主需要先创建朋友圈头像及昵称跳转页。
您可通过profiles/add接口进行创建,或者在投放管理平台提前创建好,通过profiles/get接口获取具体的id信息等。

2. 创建 campaign_type=CAMPAIGN_TYPE_NORMAL 的推广计划

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

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

特别注意:投放电商推广时,会对公众号和链接地址有一定要求,您可以通过 广告投放能力接口 了解自己的公众号和推广链接是否可以投放。假设您需要创建一个名为“测试”的朋友圈推广计划用于推广品牌活动页,请求示例如下:

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_NORMAL;
  • 推广目标(promoted_object_type):必须与推广计划的一致;
  • 推广目标id(promoted_object_id):声明广告要推广的具体是哪个推广目标id ;
    • 推广目标为网页(微信推广)或者电商推广时,无需填写推广目标id,为本地广告(微信推广)时,推广目标id必填,且同一个推广计划下的广告组必须使用相同的推广目标id(门店id);
    • 创建本地门店广告时,需事先在对应的微信公众号中注册登记门店信息,门店信息的登记及获取可以通过微信公众平台提供的接口操作,具体方式可以参考 本地门店的创建及获取
  • 广告版位(site_set):朋友圈广告该项须统一设为 SITE_SET_WECHAT;
  • 定向条件(targeting_setting):用于指定该广告投放给哪些人。
  • 优化目标(optimization_goal):投放朋友圈广告支持微信oCPA,具体方式可以参考 oCPA智能出价广告
  • 扣费方式(billing_event):目前 API 投放朋友圈广告仅支持设置为 BILLINGEVENT_IMPRESSION(按千次曝光 cpm 进行扣费);

假设您需要创建一个名为“测试”的广告组投放给北京、上海的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 支持的朋友圈广告形式包括常规图片和视频样式、基础卡片图片和视频样式、标签卡片图片和视频样式、多图样式等,具体创意形式信息可以通过 创意形式查询工具 或者创意形式查询接口(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提供的广告预览接口,支持在广告投放期间预览真实的投放效果,广告预览为真实的广告曝光,但不收取费用,一个推广计划最多允许给10个用户进行预览,且预览用户提交后不允许修改。广告预览的调用方式可通过广告预览进一步了解。

朋友圈创意形式样式介绍

目前,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创意形式的示意图:

  1. 广告主头像&名称:拉取投放广告的广告主公众号的头像&名称,用户点击可直接跳转广告主公众号介绍页。
  2. 外层文案:广告主自行输入,文案字数限不超过40个字,不超过4行。
  3. 外层图片:广告主自行上传,不同创意形式支持的图片个数以及要求不同。
  4. 链接详情页:广告主自行选择,文字链点击后打开落地页。
  5. 门店标识:本地门店推广时显示,点击可跳转查看门店详情页。品牌活动页推广无此项。
  6. 用户社交互动:允许用户对广告创意进行点赞和评论,让用户“参与”到广告中。

其中1、5、6由系统自动完成,2、3、4由您在广告创意中进行设置。

特别说明:

  1. 图片下方的“查看详情”文字链可以通过link_name_type进行设置,目前支持的枚举值分别为:
  • VIEW_DETAILS(查看详情)
  • GET_COUPONS(领取优惠)
  • MAKE_AN_APPOINTMENT(预约活动)
  • BUY_NOW(立即购买 – 电商推广专用
  • GO_SHOPPING(去逛逛 – 电商推广专用
  • ENTER_MINI_PROGRAM (进入小程序 – 投放小程序落地页时专用且必须使用
  • ENTER_MINI_GAME (进入小游戏 – 投放小游戏推广目标时,落地页选择PAGE_TYPE_MINI_GAME_WECHAT时专用且必须使用

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

  1. 常规样式创意形式默认使用简版原生页作为图片点击后的落地页,即当用户点击图片后,会跳转至系统根据上传的图片文案等信息自动生成的简版原生页(如未使用简版原生页,点击图片为放大效果)。
  2. 对常规样式创意形式,文案支持通过\n换行,最多支持3个换行。
    4.如填写小程序落地页,文字链点击后将打开对应的小程序落地页,详情可参考 微信小程序落地页

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