H5转化API-QQ空间.PDFVIP

【H5转化API】腾讯社交广告H5转化跟踪API说明文 档 V2.2 H5-oCPA 【H5转化API】腾讯社交广告H5转化跟踪API说明文档 V2.2 1. API方案介绍 1.2 最 改动 ：（必读 ） 1.2 两种数据上报模式 ：（必读 ） 2. API接入流程 2.1 注册成为腾讯社交广告 MarketingAPI 开发者 2.1.1 登录已注册的QQ账户 2.1.2 完善开发者资料 2.1.3 创建转化数据上报应用 2.2 绑定需要追踪 H5 转化数据的广告主账户 2.2.1 完成OAuth2.0认证操作 2.2.2 如何更 refresh_token ： 2.2.3 配额和频次控制 2.3 上报网页转化行为数据 2.3.1 转化数据类型 2.3.2 转化数据类型示例 2.3.3 数据上报参数说明 2.3.4 转化数据上报请求示例 2.3.5 返回值 附录 特别说明·不同类型账户请求授权结果 ： 特别说明·永久Token 1. API方案介绍 1. 对于H5商品而言 ，在腾讯社交广告推广时 ，每次点击都会生成一个 click_id ，在跳转到落地页 时 ，会将 click_id 作为参数传入对应的 URL 中。 2. 当对应落地页的产生转化行为时 ，可以利用 API 将 click_id 和 转化类型 （ActionType ） 一并 上报给腾讯社交广告 ，经过腾讯社交广告计算后 ，将最终数据呈现在投放端 （ ）。 3. 目前支持的广告流量包括 ：手腾网、QQ空间 （PC、移动流量 ）、QQ浏览器、QQ天气、附近 的人、移动联盟、微信公众号。其中QQ空间 （PC ）和微信公众号 不支持 H5-oCPA功能。 1.2 必威体育精装版改动 ：（必读 ） 1. 参数 pixel_id 名称变更为 user_action_set_id。 2. 增加了直接获取 user_action_set_id 的 接 口。 3. 永久的 refresh_token 已经上线。 内测期间使用的接 口地址为 ： / 目前已经全面更 为 ： / 接入的开发者请使用 / ，已经完成对接的广告主建议做更 ，但也可以不 做修改。 1.2 两种数 上报模式 ：（必读 ） 模式1 ：开发者用一套完成鉴权的 account id 和对应的 user_action_set_id 来上报所有账户的数 据。 模式2 ：开发者与每一个广告主账户进行鉴权 ，用各个账户的广告主ID作为 account id 和各 自对应 的 user_action_set_id 完成各 自账户的数据上报。 2. API接入流程 Step 1. 注册成为腾讯社交广告 MarketingAPI (/) 开发者 Step 2. 创建转化数据上报应用 ，等待审核 Step 3. 绑定需要追踪 H5 转化数据的广告主账户 Step 4. 上报网页转化行为数据 2.1 注册成为腾讯社交广告 MarketingAPI 开发者 要调用Marketing API ，必须先注册成为开发者并创建应用。此处的应用可以理解为一个面向其他 广告主的服务 ，下文将其统一定义为 『转化数据上报应用』。 2.1.1 登录已注册的QQ账户 如果开发者已经是广点通的广告主账户 （代理商或广告主 ），建议直接用代理商帐号或广告主帐号 的开户QQ进行注册。 2.1.2 完善开发者资料 完成QQ登录后 ，将进入开发者资料填写页面 ： 资料填写完整并手机验证通过后即完成开发者注册。 2.1.3 创建转化数 上报应用 注册为开发者后 ，在开发者官网登录即可进入 『应用程序管理』面板 ： 点击 『创建 应用程序』进入创建转化数据上报服务界面 ： 开发者需要提供 『应用名称』、 『应用介绍』、 『