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 | 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 | 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):某個必須的字段缺失;