使用webservice接口获取报告

来自亿业科技接口
跳转至: 导航搜索

获取报告需要准备些什么信息

不需要准备额外的信息


亿业平台提供的报告包含什么信息

对于任意一个任务而言,亿业提供的报告包含了汇总报表和明细报表两类;

  1. 汇总报表也就是各个维度的数目:比如一个任务的发送数量,成功数量,打开和点击数量,硬退和软退数量,退订数量等信息;
  2. 明细报表也就是各个维度对应的明细数据:比如就打开而言,包含具体打开的联系人地址,打开的时间,打开的IP等;


获取报告应该调用你们什么接口?如何调用?

我们的任务提交方式有多种,获取报告涉及的接口也有所不同,如下:

  1. 通过列表(人工或者webservice)进行批量提交:请参考本文下方#获取列表方式提交的报告应该调用你们什么接口?如何调用?
  2. 通过smtp协议单封提交:请参考本文下方#获取smtp接口提交的报告应该调用你们什么接口?如何调用?


获取列表方式提交的报告应该调用你们什么接口?如何调用?

1)您需要周期性的调用获取列表总计接口,来获取一段时间内所提交任务的汇总报表;

邮件发送有一定的延迟性,一般来说,在7天内(系统默认的有效期),邮件报告都可能会发生变化,10天后,邮件报告已经基本稳定;
所以我们建议每次获取时,获取最近10天的所提交任务的汇总报表即可;
同时,在查询周期上,我们建议每日获取一次即可;

2)根据第一步返回的任务ID(SentMailListId)集合,轮询调用获取列表明细接口来获取明细报表;


获取smtp接口提交的报告应该调用你们什么接口?如何调用?

1)您需要周期性的调用获取SMTP发送总计接口,来获取一段时间内所提交任务的汇总报表;

邮件发送有一定的延迟性,一般来说,在7天内(系统默认的有效期),邮件报告都可能会发生变化,10天后,邮件报告已经基本稳定;
所以我们建议每次获取时,获取最近10天的所提交任务的汇总报表即可;
同时,在查询周期上,我们建议每日获取一次即可;

2)根据第一步使用的时间段,按天轮询调用获取SMTP发送明细接口来获取当天的明细报表;