Tên cột và mô tả cho dữ liệu khách hàng trong tệp TSV
CitrusAd chỉ hỗ trợ định dạng TSV cho dữ liệu khách hàng. Bảng dưới đây mô tả tên của các cột trong tệp TSV kèm mô tả chi tiết. Đối với dữ liệu khách hàng, cột bắt buộc duy nhất là customer_id
.
Tên cột | Bắt buộc/không bắt buộc | Loại dữ liệu | Mô tả |
---|---|---|---|
customer_id | Bắt buộc | Văn bản | Đây là định danh của khách hàng trong hệ thống của nhà bán lẻ. |
year_of_birth | Tùy chọn | Số | Không còn được sử dụng. Đây là năm sinh của khách hàng. Đây phải là số. |
gender | Tùy chọn | Văn bản | Không còn được sử dụng. Đây là giới tính của khách hàng. Nếu có giá trị thì giá trị đó phải là một trong các giá trị {“UNDEFINED”, “FEMALE”, “MALE”, “OTHER”}. Giá trị không phân biệt chữ hoa chữ thường. |
postcode | Tùy chọn | Văn bản | Không còn được sử dụng. Đây là mã bưu điện của địa chỉ liên hệ của khách hàng. |
suburb | Tùy chọn | Văn bản | Không còn được sử dụng. Đây là vùng ngoại ô của địa chỉ liên hệ của khách hàng. |
status | Bắt buộc nếu đồng bộ hóa các bản cập nhật delta | Văn bản | Khi đồng bộ hóa các thay đổi delta qua tệp tin, trạng thái này được sử dụng để biểu thị hành động thực hiện trên ID khách hàng. Các giá trị được chấp nhận là INSERT , UPDATE vàDELETE |
target_data | Tùy chọn | Bản đồ json | Nếu áp dụng giá trị thì giá trị đó phải là một bản đồ json, ví dụ: {"customer_type" : "công ty", "customer_country" : "Úc"} |
customer_targeting:KEY | Tùy chọn | Văn bản | Nếu sử dụng loại cột này thì nhà bán lẻ phải cung cấp giá trị cho KEY, ví dụ: tên cột có thể là "customer_targeting:customer_type" và giá trị của một ô trong cột có thể là "corporate", "smb" hoặc "retailer". Tệp TSV có thể chứa một số cột có cú pháp này. |
Vui lòng xem ví dụ về tệp tin TSV với một hàng tiêu đề và ba hàng dữ liệu cho khách hàng trong bảng bên dưới để đồng bộ hóa toàn bộ tệp tin. Xin lưu ý rằng dữ liệu thô là tệp văn bản, nhưng dữ liệu này được thể hiện dưới dạng bảng để tiện cho việc đọc hiểu.
customer_id | year_of_birth | gender | postcode | suburb | customer_targeting:customer_type |
---|---|---|---|---|---|
0937832 | 1990 | MALE | 3000 | Melbourne | Bán lẻ |
0347293 | 1993 | FEMALE | 4000 | Brisbane | Bán lẻ |
0293423 | OTHER | 4064 | Milton | Công ty |
Tùy chọn đồng bộ hóa
Cập nhật đầy đủ
Chế độ cập nhật đầy đủ cho phép các nhà bán lẻ đồng bộ hóa toàn bộ tệp thông tin khách hàng của họ. Đây là phương pháp điển hình được nhà bán lẻ tích hợp vì quy trình thiết lập đơn giản hơn.
Cập nhật Delta
Có thể cập nhật Delta bằng cách điều chỉnh tệp tin của bạn để chỉ đồng bộ hóa các bản cập nhật hoặc thay đổi cho khách hàng. Đây là lựa chọn tốt hơn cho các nhà bán lẻ cấp lớn hơn với lượng khách hàng mục tiêu lớn.
Tệp tin của bạn phải có status
cột, vì cột này biểu thị hành động cần thực hiện đối với người dùng. Các giá trị được chấp nhận là: INSERT
, UPDATE
vàDELETE
.
Dưới đây là tệp ví dụ:
customer_id | status | year_of_birth | gender | postcode | suburb | customer_targeting:customer_type |
---|---|---|---|---|---|---|
1 | INSERT | 1990 | MALE | 3000 | Melbourne | Bán lẻ |
2 | UPDATE | 1993 | FEMALE | 4000 | Brisbane | Bán lẻ |
3 | DELETE | OTHER | 4064 | Milton | Công ty |
Bạn không thể đồng bộ hóa các thay đổi delta trong nguồn cấp dữ liệu cập nhật đầy đủ.
Trong trường hợp nguồn cấp dữ liệu ở trên, ID khách hàng 1 là mới, khách hàng 2 đang được cập nhật và khách hàng 3 đã bị nhà bán lẻ xóa.