使用webservice接口獲取報告

出自亿业科技接口
在2017年2月16日 (四) 09:55由Lebesgue.yu對話 | 貢獻所做的修訂版本

(差異) ←上個修訂 | 最新修訂 (差異) | 下一修訂→ (差異)
跳轉到: 導覽搜尋

獲取報告需要準備些什麼信息

不需要準備額外的信息


億業平台提供的報告包含什麼信息

對於任意一個任務而言,億業提供的報告包含了匯總報表和明細報表兩類;

  1. 匯總報表也就是各個維度的數目:比如一個任務的發送數量,成功數量,打開和點擊數量,硬退和軟退數量,退訂數量等信息;
  2. 明細報表也就是各個維度對應的明細數據:比如就打開而言,包含具體打開的聯繫人地址,打開的時間,打開的IP等;


獲取報告應該調用你們什麼接口?如何調用?

我們的任務提交方式有多種,獲取報告涉及的接口也有所不同,如下:

  1. 通過列表(人工或者webservice)進行批量提交:請參考本文下方#獲取列表方式提交的報告應該調用你們什麼接口?如何調用?
  2. 通過smtp協議單封提交:請參考本文下方#獲取smtp接口提交的報告應該調用你們什麼接口?如何調用?


獲取列表方式提交的報告應該調用你們什麼接口?如何調用?

1)您需要周期性的調用獲取列表總計接口,來獲取一段時間內所提交任務的匯總報表;

郵件發送有一定的延遲性,一般來說,在7天內(系統默認的有效期),郵件報告都可能會發生變化,10天後,郵件報告已經基本穩定;
所以我們建議每次獲取時,獲取最近10天的所提交任務的匯總報表即可;
同時,在查詢周期上,我們建議每日獲取一次即可;

2)根據第一步返回的任務ID(SentMailListId)集合,輪詢調用獲取列表明細接口來獲取明細報表;


獲取smtp接口提交的報告應該調用你們什麼接口?如何調用?

1)您需要周期性的調用獲取SMTP發送總計接口,來獲取一段時間內所提交任務的匯總報表;

郵件發送有一定的延遲性,一般來說,在7天內(系統默認的有效期),郵件報告都可能會發生變化,10天後,郵件報告已經基本穩定;
所以我們建議每次獲取時,獲取最近10天的所提交任務的匯總報表即可;
同時,在查詢周期上,我們建議每日獲取一次即可;

2)根據第一步使用的時間段,按天輪詢調用獲取SMTP發送明細接口來獲取當天的明細報表;