Webservice方法-GetMailReportDetailExt接口

從 亿业科技接口
跳到: 導覽搜尋

介紹

調用本接口可以查詢指定群發列表在指定時間段內的某類數據的詳細情況,由於返回數據量可能較大,結果目前通過分頁返回,每頁顯示數目和當前頁數由您傳入;請盡量查詢最近40小時內的數據,速度會比較快。
方法聲明如下:

public MailReportDetailExtReturnDTOGetMailReportDetailExt (EaseyeUserAccountDTOeaseyeUserAccountDTO,
string mailListName, int sentFlag,DateTime datetimeFrom, DateTime datetimeTo,
int pageSize,int currentPageIndex)

輸入

  • EaseyeUserAccountDTO:easeyeUserAccountDTO
用戶帳戶信息(必填),其字段詳細信息如下:
Index Field Type Desc
1 Email string(50) 用戶名(必填)
2 Password string(50) 密碼(必填)
注:1)Email是用户名,也就是平台的登录帐号;
  • string:mailListName
待查詢列表的名稱(必填且精確匹配);
  • int:sentFlag
待查詢的數據類型(必填):其允許值如下:
0:HardBounce硬退,
9:SoftBounce軟退,
109:Drop過濾,
4:Open打開,
5:Click點擊,
3:Unsubscribed退訂,
1000:發送記錄的當前狀態,查詢該類型時返回結果中的SubSentFlag將全部為0
  • DateTime:datetimeFrom
時間段下限(必填);
注:1)如果使用的编程语言中没有DateTime类型,可以传入字符串类型,格式为”yyyy-MM-ddThh:mm:ss”,其中,各个数值所占位数必须符合格式定义,
不足则补0,比如”2012-07-03T03:23:01”;
  • DateTime:datetimeTo
時間段上限(必填);
注:1)如果使用的编程语言中没有DateTime类型,可以传入字符串类型,格式为”yyyy-MM-ddThh:mm:ss”,其中,各个数值所占位数必须符合格式定义,
不足则补0,比如”2012-07-03T03:23:01”;
  • int:pageSize
每頁顯示的記錄條數(必填,正整數,不大於1000);
  • int:currentPageIndex
當前的頁數(必填,正整數);

處理

根據條件查詢分頁報表,並將結果返回;

輸出

  • MailReportDetailExtReturnDTO
報表總計查詢的返回信息,包含以下屬性
Index Field Type Desc
1 ErrorCode Int 錯誤碼,3位整數,
2xx:處理成功;
3xx:部分成功;
4xx:臨時錯誤;
5xx:永久錯誤
2 ErrorInfo string 發生臨時錯誤和永久
錯誤時,攜帶失敗的原因
3 TotalCount Int 記錄總數
4 MailReportDetailExtDTOList List
< ReportDetailExt>
查詢報表明細的返回信息
  • List<ReportDetailExt>
查詢總報表的返回信息,其ReportDetailExt結構的字段詳細信息如下:
Index Field Type Desc
1 Email String 接收方郵件地址
2 SentFlag Int 狀態類型
3 SubSentFlag Int 狀態子類型,詳細說明見備註
4 EventDate DateTime 事件產生事件
5 AddDate DateTime 億業平台處理的時間
(查詢時間段會與該字段匹配)
6 UA String 客戶端的原始UserAgentString
(適用於Open打開和Click點擊類型)
7 Platform String 客戶端操作系統
(適用於Open打開和Click點擊類型)
8 BrowserType String 客戶端瀏覽器
(適用於Open打開和Click點擊類型)
9 Link String 點擊的鏈接地址
(適用於Click點擊類型)
10 Title String 鏈接的興趣度分類
(適用於Click點擊類型)
11 IP String 該操作的源IP
(適用於Open打開和Click點擊類型)
注:1)SentFlag的值和传入参数的sentFlag值相同;
2)SentFlag和对应的SubSentFlag对照表
SentFlag SubSentFlag 類型說明
0:HardBounce硬退 0 硬退
9:SoftBounce軟退 0 軟退
100:已發送 0 已發送
109:Drop過濾 110
111
112
210
硬退過濾
超過限量過濾
過期未發
退訂過濾
4:Open打開 0 打開
5:Click點擊 0 點擊
3:Unsubscribed退訂 0
202
用戶自行退訂
用戶投訴退訂
常見調用失敗情況
(4xx):業務限制;
(4xx):數據庫操作失敗;
(5xx):某個字段長度不符合定義;
(5xx):某個必須的字段缺失;