Chuyển tới nội dung chính

Khách hàng theo Tỉnh

Endpoint:

GET https://yourdomain.com/api/v6.1/account_report/customer_portrait_bar

Request Headers:

  • X-API-KEY: <API-KEY>
  • Cookie: <Session-Cookie>

Tham số Request:

  • fields (bắt buộc):
    • distribution_account_province_bar
  • params[period] (tuỳ chọn):
    • this_month (tháng hiện tại)
  • params[limit] (tuỳ chọn):
    • 50 (giới hạn số bản ghi)

Ví dụ Request CURL:

curl --location --globoff 'https://yourdomain.com/api/v6.1/account_report/customer_portrait_bar?fields=distribution_account_province_bar&params[period]=this_month&params[limit]=50' \
--header 'X-API-KEY: <API-KEY>' \
--header 'Cookie: <Session-Cookie>' \
--data ''

Cấu trúc Phản hồi:

  • JSON gồm:
    • data: danh sách gồm:
      • labels: danh sách tên tỉnh/thành phố
      • series: danh sách đối tượng gồm:
        • label: tên tỉnh
        • value: số lượng khách hàng

Ví dụ Phản hồi JSON:

{
"data": [
{
"labels": [
"Chưa rõ",
"HÀ NỘI",
"NINH BÌNH",
"HÀ TĨNH",
"ĐĂK LĂK",
"LÂM ĐỒNG"
],
"series": [
{"label": "Chưa rõ", "value": 11983},
{"label": "HÀ NỘI", "value": 3},
{"label": "NINH BÌNH", "value": 13},
{"label": "HÀ TĨNH", "value": 25},
{"label": "ĐĂK LĂK", "value": 6},
{"label": "LÂM ĐỒNG", "value": 1}
]
}
]
}

Ghi chú:

  • labels là danh sách các tỉnh/thành phố theo danh mục khách hàng.
  • series cho biết số lượng khách hàng tương ứng tại mỗi địa phương.

Mục Đích Sử Dụng:

  • Theo dõi sự tập trung và phân tán của khách hàng theo khu vực.
  • Hỗ trợ ra quyết định địa bàn marketing và kinh doanh.