開啟「報告」分頁。
產生排程的 CSV 報告,以追蹤 SMS 和 WhatsApp 使用量、監視配額,並依群組分析使用量。
交易使用量匯出可讓您了解帳戶中的 SMS 和 WhatsApp 活動,包括購買數量、使用量總計和群組層級使用量。這些輸出包括:
- SMS 驗證
- SMS 傳送
- WhatsApp 驗證
- WhatsApp 傳送交易。
匯出會以排程快照的方式產生,而非即時查詢。使用排程進行持續監視,或手動準備匯出,以在您需要立即更新資料時重新產生。
資料匯出的運作方式
交易資料會在定義的日期範圍內並使用指定的篩選器匯出為 CSV 檔案。
- 匯出會以非同步方式產生,並非即時進行。
- 匯出會依據設定的排程重新整理。
- 選取「準備」會使用最新可用資料重新產生匯出。
CSV 中的每一列代表單一合約,並包含 SMS 和 WhatsApp 交易使用量資料。
建立交易使用量報告
從報告標籤建立 CSV 報告。
-
-
選取「新的匯出」。
-
選取「交易使用量」。
-
定義匯出:
- 選取「日期範圍」。
- 套用篩選器,包括一個或多個群組(如有需要)。
-
選取「選取欄位」,並選擇要包含的資料。
針對 SMS 和 WhatsApp 交易使用量,請在「可用欄」區段中展開附加元件並包含以下項目:
- 訊息傳送附加元件的購買數量 — 已購買交易的總數量。
- 訊息傳送附加元件的開始日期 — 套用交易配額時的年度生效日期。
- SMS OTP 使用量計數 — 用於 SMS 驗證的交易。
- SMS 合約傳送使用量計數 — 用於透過 SMS 傳送合約連結的交易。
- WhatsApp OTP 使用量計數 — 用於 WhatsApp 驗證的交易。
- WhatsApp 協議傳送使用量計數 — 用於透過 WhatsApp 傳送合約連結的交易。
若要啟用群組層級報告,也請包含寄件者群組欄。
-
選取「儲存」,並提供匯出的名稱。
匯出會以非同步方式產生,完成時會在「最近報告」清單中出現。
設定準確的群組層級資料
群組層級使用量需要篩選和欄位選取。
- 定義匯出時套用一個或多個群組篩選器。
- 在匯出中包含寄件者群組欄。
如果不符合任一要求,群組層級使用量將無法在匯出的資料中準確呈現。
確保準確的合約使用量資料
若要針對正確的合約期間製作報告:
- 使用電話配額生效 (開始) 日期作為報告開始日期。
- 此值可在以下位置取得:帳戶設定 > 傳送設定
使用正確的開始日期可確保包含目前合約下的所有交易,並且使用量總計和群組層級摘要都是準確的。
排程報告
排程報告,以自動產生更新的交易資料。
-
建立新的匯出或編輯現有匯出。
-
選取要安排排程的匯出項目的省略符號,然後從下拉式選單中選擇排程。
-
透過定義以下項目來設定排程:
- 排程頻率 (每日、每週、每月)
- 要將報告傳送到哪些電子郵件地址
- 選用訊息
-
「儲存」排程。
排程報告會自動產生,可從最近報告清單下載或透過電子郵件傳送。
使用最新資料更新匯出
若要更新匯出:
- 選取「準備」,以立即重新產生匯出。
- 或等待下次排程執行。
- 如有需要,您也可以使用相同參數建立新的匯出。
使用 API 下載匯出
使用 API 擷取最新產生的匯出。
- 端點:POST /api/rest/v6/reportDownload
- 必要參數:scheduleId
此端點:
- 需要在報告 UI 中建立的匯出排程。
- 僅傳回最新 CSV 檔案的下載 URL。
- 不會隨選產生新的匯出。
如果匯出尚未更新,則傳回先前產生的 CSV 檔案。
下載大型 CSV 檔案時,處理可能需要更長時間,因為必須準備所有記錄。設定至少5 分鐘的用戶端逾時,以確保成功下載。
匯出可用性和保留期限
- 匯出的 CSV 檔案會儲存7 天。
- 7 日後,檔案過期且無法再下載。
- 若要存取更新的資料,請使用準備重新產生匯出或等待下次排程執行。
注意事項
- 必須先建立或排程匯出,才能透過 API 存取。
- 透過 API 僅可取得排程的最新 CSV 檔案。
- 群組層級報告需要:
- 群組篩選器
- 寄件者群組欄
- 使用正確的電話配額生效(開始)日期是準確合約層級報告的必要條件。
- 匯出檔案在 7 日後過期,如有需要必須重新產生。