消息订阅工具

为了保证您可以及时接收到账户/广告等审核结果、财务充值进度等实时消息，无需自行调用相关接口做实时查询，我们为您提供了消息订阅工具。您可以在应用管理界面，订阅您所需要的消息类型，本期已支持广告通过审核、广告未通过审核、广告通过流量二次审核、广告未通过流量二次审核、账户余额不足预警、广告主账户审核通过/拒绝/封停（原状态名为：冻结）提醒等类型的消息订阅。更多消息类型请密切关注官网通知。

整体流程

您需要在开发者官网-应用程序管理-应用编辑详情页选择您需要订阅的消息类型，并根据官网提供的消息格式等信息提前搭建消息接收服务。

具体操作步骤：

1. 您可在应用程序管理的详情页面，根据该应用已有的接口权限，订阅对应的消息类型。

1) 初次创建消息订阅时，您需要填写回调地址（消息推送的获取地址）及密钥（获取消息推送权限的唯一标识，一般为 3-32 个的数字或英文字母），我们会根据您提供的回调参数及密钥信息，为您推送一条测试消息体。测试消息体内容请参考的详细记录。测试消息体的格式为：

 { 
    "event_type": "EVENT_TYPE_TEST", 
    "account_id": 999999, //固定 999999 
    "event_id":"1000", //固定 1000 
    "event_data": { 
        "EVENT_TYPE_TEST": {} 
    } 
 } 

• 您接收到此消息后，请按照正常消息做处理并返回。
  

2) 您可在此步骤对不同类型的消息做订阅或取消订阅操作。
— 如果您已有广告管理接口权限，A 广告主通过 Oauth 接口授权了广告管理权限给您，B 广告主未授权，则您仅可接收到 A 广告主的消息通知。

1. 订阅消息的请求及返回参数的详细信息如下：

   • 请求地址：由调用方定义（仅支持 HTTPS 协议）

   • 请求方式：POST

   • 请求字段：

以下字段在 URL 中传递

以下字段在 HTTP body 中传递(json 格式)

本期支持的消息内容：

应答字段：

data：

1. 我们仅在收到 HTTP status = 200 的响应，并且 code = 0，event_id 与请求中的 event_id 相同时，才认为消息推送成功。
2. 如果消息推送后 3 秒内未接收到您的响应时，则认为推送失败；对于推送失败的消息，我们会在消息推送失败后每隔 5 分钟重试 3 次，如果重试 3 次仍不成功，则停止尝试，且推送失败的消息不会再做存储推送。请您及时检查并确保所提供的回调地址及密钥是可用的。
3. 如果您收到 event_id 相同的消息，仅需返回成功，无需对所有消息均做入库处理。

如果您在消息订阅工具的使用过程中需要技术支持或者反馈问题，可以向与您接口的腾讯广告运营人员寻求帮助。

查看更多工具