带参数二维码的作用与开发方法.doc

兆合微信+带参数二维码
满足用户渠道推广分析的需要

带参数二维码，是微信公众号的子二维码，是为了实现渠道营销管理而开发的成千上万个有细微区别的二维码。用户通过扫描带参数的二维码，关注的是同一个微信公众号，但是公众号能够区别此用户是通过扫描哪个子二维码而关注的。
带参数二维码，就好像是孙悟空的猴子猴孙，看起来都是孙悟空，都是由孙悟空变幻出来的，而实际上他们之间是有细微区别的，这个细微区别，就是带参数二维码存在的价值。带参数二维码实现微信公众平台广告投放、互动活动、渠道分销效果的全程数据监控，帮助企业实现有的放矢！
兆合微信带参数二维码系统，是由渠道二维码生成系统、渠道二维码效果监测系统、渠道用户自助效果查询系统三大模块组成。可以给公众号生成无限个带参数的二维码，每一个推广二维码都代表不同的广告投放或分销渠道，用户扫描任何一个二维码，都是关注同一个公众号。
商家可对渠道来源进行管理，实现粉丝来源追踪，全程数据跟踪，广告投放效果，分销渠道业绩，一目了然。根数据的分析结果，商家可以将广告费投放到高效的渠道，提高企业效益；可以对分销渠道进行分配和分等级管理，提高管理效率。渠道用户可通过效果自助查询系统，在微信平台实时查询自己推广的效果和用户交易金额。
以下是一些可利用渠道二维码解决问题的场景。
应用场景一：公司打算在多个媒体渠道投放广告（报纸、地铁、公交、电视等），想了解广告投放后，吸引粉丝的效果。
应用场景二：公司有大量线下销售团队与客户直接面对顾客，想让这些员工帮公司推广公众平台，又苦于无法监测粉丝来源于哪个业务员。
应用场景三：公司拥有全国渠道加盟店，想让加盟店帮助厂商推广官方微信平台，又苦于没有很好的机制说服加盟商。
应用场景四：政府让下级单位进行公众号宣传，苦于无法知道是哪个下属单位宣传的更加有效。
应用场景五：兼职人员推广微信二维码，如何解决按效果来支付报酬问题。

目前有2种类型的二维码：
1、临时二维码，是有过期时间的，最长可以设置为在二维码生成后的7天（即604800秒）后过期，但能够生成较多数量。临时二维码主要用于帐号绑定等不要求二维码永久保存的业务场景
2、永久二维码，是无过期时间的，但数量较少（目前为最多10万个）。永久二维码主要用于适用于帐号绑定、用户来源统计等场景。
用户扫描带场景值二维码时，可能推送以下两种事件：
1. 如果用户还未关注公众号，则用户可以关注公众号，关注后微信会将带场景值关注事件推送给开发者。
2. 如果用户已经关注公众号，在用户扫描后会自动进入会话，微信也会将带场景值扫描事件推送给开发者。
获取带参数的二维码的过程包括两步，首先创建二维码ticket，然后凭借ticket到指定URL换取二维码。
创建二维码ticket
每次创建二维码ticket需要提供一个开发者自行设定的参数scene_id），分别介绍临时二维码和永久二维码的创建二维码ticket过程。
临时二维码请求说明
http请求方式: POST
URL:
POST数据格式：json
POST数据例子：{"expire_seconds": 604800, "action_name": "QR_SCENE", "action_info": {"scene": {"scene_id": 123}}}
永久二维码请求说明
http请求方式: POST
URL:
POST数据格式：json
POST数据例子：{"action_name": "QR_LIMIT_SCENE", "action_info" {"scene": {"scene_id": 123}}}
或者也可以使用以下POST数据创建字符串形式的二维码参数：
{"action_name": "QR_LIMIT_STR_SCENE", "action_info": {"scene": {"scene_str": "123"}}}
参数说明
参数
说明
expire_seconds
该二维码有效时间，以秒为单位。 最大不超过604800（即7天）。
action_name
二维码类型，QR_SCENE为临时,QR_LIMIT_SCENE为永久,QR_LIMIT_STR_SCENE为永久的字符串参数值
action_info
二维码详细信息
scene_id
场景值ID，临时二维码时为32位非0整型，永久二维码时最大值为100000（目前参数只支持1--100000）
scene_str
场景值ID（字符串形式的ID），字符串类型，长度限制为1到64，仅永久二维码支持此字段
返回说明
正确的Json返回结果:
{"ticket":"gQH47joAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL2taZ2Z3TVRtNzJXV1Brb3ZhYmJJAAIEZ23sUwMEmm3sUw==","expire_seconds":60,"url":"http:\/\/\/q\/kZgfwMTm72WWPkovabbI"}
参数
说明
ticket
获取的二维码ticket，凭借此ticket可以在有效时间内换取二维码。
expire_seconds
二维码的有效时间，以秒为单位。最大不超过1800。
url
二维码图片解析后的地址，开发者可根据该地址自行生成需要的二维码图片
错误的Json返回示例:
{"errcode":40013,"errmsg":"invalid appid"}
全局返回码说明
使用网页调试工具调试该接口
通过ticket换取二维码
获取二维码ticket后，开发者可用ticket换取二维码图片。请注意，本接口无须登录态即可调用。
请求说明
HTTP GET请求（请使用https协议）
返回说明
ticket正确情况下，http 返回码是200，是一张图片，可以直接展示或者下载。
HTTP头（示例）如下：
Accept-Ranges:bytes
Cache-control:max-age=604800
Connection:keep-alive
Content-Length:28026
Content-Type:image/jpg
Date:Wed, 16 Oct 2013 06:37:10 GMT
Expires:Wed, 23 Oct 2013 14:37:10 +0800
Server:nginx/1.4.1
错误情况下（如ticket非法）返回HTTP错误码404。
使用网页调试工具调试该接口