Dữ liệu lượt bán hàng tại cửa hàng thực tế cần phải được định dạng chính xác và tuân thủ các chính sách về dữ liệu khách hàng. Bài viết này trình bày những nguyên tắc mà bạn cần tuân thủ khi định dạng tệp dữ liệu lượt bán hàng tại cửa hàng thực tế.
Nội dung trong bài viết này
- Thêm dữ liệu lượt bán hàng tại cửa hàng thực tế
- Định dạng tệp dữ liệu lượt bán hàng tại cửa hàng thực tế
- Định dạng tiêu đề cột
- Tìm hiểu các nguyên tắc định dạng dữ liệu giao dịch của khách hàng
Trước khi bạn bắt đầu
Tạo tệp dữ liệu ở định dạng Excel, CSV hoặc Google Trang tính. Nếu bạn cần được trợ giúp về việc thiết lập dữ liệu, hãy dùng những mẫu sau:
Nguyên tắc định dạng cơ bản
- Để bảo mật thông tin giao dịch của khách hàng, bạn cần phải băm tên, địa chỉ email và số điện thoại của khách hàng trong dữ liệu lượt bán hàng tại cửa hàng thực tế. Bạn có thể tự băm thông tin đó hoặc để Google Ads băm dữ liệu lượt bán hàng tại cửa hàng thực tế cho bạn bằng thuật toán SHA-256 (đây là tiêu chuẩn ngành đối với kỹ thuật băm một chiều).
- Xin lưu ý rằng giới hạn kích thước tệp có thể khiến bạn không thể tải tệp lên.
- Tải một lần trực tiếp lên tài khoản Google Ads của bạn:
- 150 MB: Chỉ đối với những tệp CSV mà bạn tự tải lên trong Google Ads (ước tính 300.000 hàng dữ liệu giao dịch).
- 50 MB: Đối với tất cả các định dạng khác, bao gồm cả tệp CSV đã tải lên bằng cách sử dụng lịch biểu (ước tính 100.000 hàng dữ liệu giao dịch).
- Nếu bạn tải lên bằng cách sử dụng API Google Ads: 1.000.000 hàng giao dịch/lệnh tải lên. Bạn nên dùng OfflineUserDataJobService để tạo lệnh tải lên và thêm 10.000 hàng dữ liệu giao dịch cùng một lúc bằng phương thức AddOfflineUserDataJobOperations để tối ưu hoá quá trình xử lý. Bạn có thể tạo nhiều lệnh tải lên song song nhằm tăng tốc độ gửi các hàng để xử lý.
Lưu ý: Nếu bạn tải lên thông qua một đối tác dữ liệu lượt bán hàng tại cửa hàng thực tế, hãy liên hệ với đối tác đó để biết giới hạn khi tải dữ liệu lượt bán hàng tại cửa hàng thực tế lên.
- Tải một lần trực tiếp lên tài khoản Google Ads của bạn:
Nếu bạn có câu hỏi kỹ thuật liên quan đến API Google Ads (ví dụ: câu hỏi liên quan trực tiếp đến việc sử dụng API hoặc SDK, các lỗi nhận được từ API hoặc SDK, v.v.), vui lòng làm theo các bước khắc phục sự cố trên trang Hỗ trợ kỹ thuật về API.
Nếu bạn có câu hỏi về API Google Ads liên quan cụ thể đến giao diện người dùng Google Ads, vui lòng nhấp vào "Liên hệ với chúng tôi" ở cuối trang.
Nguyên tắc định dạng tiêu đề cột
Bạn sẽ cần 2 hàng tiêu đề trong tệp dữ liệu lượt bán hàng tại cửa hàng thực tế: một hàng để tải siêu dữ liệu lên và một hàng chứa tên cột giao dịch của khách hàng.
Siêu dữ liệu trong tệp tải lên
Hàng đầu tiên bao gồm siêu dữ liệu trong tệp tải lên.
Lưu ý: Nếu đang sử dụng tính năng biến tuỳ chỉnh thì bạn nên định dạng tiêu đề cột trong hàng này như sau:
Parameters:TimeZone=<insert_TZ>;LoyaltyRate=<insert_rate>;TransactionUploadRate=<insert_rate>;CustomVariable=<insert_name>
Xin lưu ý rằng bạn chỉ có thể sử dụng biến tuỳ chỉnh nếu biến đó đang hoạt động.
Trong dấu ngoặc, bạn sẽ thêm thông tin được yêu cầu cho mỗi thông số:
- Bạn phải đặt các giá trị LoyaltyRate và TransactionUploadRate thành 1.
Siêu dữ liệu giao dịch của khách hàng
Hàng thứ hai bao gồm thông tin liên quan đến các giao dịch của khách hàng mà bạn muốn tải lên (chẳng hạn như địa chỉ email, số điện thoại và tên). Dưới đây là các tiêu đề cột mà bạn có thể thêm vào hàng thứ hai cho thông tin giao dịch của khách hàng:
- Tên
- Họ
- Thành phố
- Tiểu bang
- Mã bưu chính
- Quốc gia
- Số điện thoại
- Tên lượt chuyển đổi (bắt buộc)
- Thời gian chuyển đổi (bắt buộc)
- Giá trị chuyển đổi (bắt buộc)
- Đơn vị tiền tệ của lượt chuyển đổi (bắt buộc)
- Dữ liệu người dùng quảng cáo (nếu sử dụng dữ liệu lượt bán hàng tại cửa hàng thực tế với tính năng So khớp khách hàng cho người dùng ở Khu vực kinh tế Châu Âu (EEA))
- Cá nhân hoá quảng cáo (nếu sử dụng dữ liệu lượt bán hàng tại cửa hàng thực tế với tính năng So khớp khách hàng cho người dùng ở EEA)
Trong phần tiếp theo, bạn sẽ tìm hiểu cách định dạng dữ liệu lượt bán hàng tại cửa hàng thực tế.
Nguyên tắc định dạng dữ liệu
Thông tin giao dịch của khách hàng mà bạn cung cấp cần phải được định dạng chính xác để Google Ads có thể tải dữ liệu lên. Bạn cần băm một số thông tin giao dịch của khách hàng bằng thuật toán SHA-256, bao gồm:
- Địa chỉ email của khách hàng
- Số điện thoại của khách hàng
- Họ và tên của khách hàng
Bạn không cần băm các dữ liệu giao dịch khác của khách hàng (chẳng hạn như quốc gia cư trú, mã bưu chính và dữ liệu thuộc tính).
Để bắt đầu, hãy tải mẫu Excel, CSV hoặc Google Trang tính xuống rồi nhập thông tin giao dịch của khách hàng. Nếu bạn không thể băm một số thông tin giao dịch của khách hàng, thì hãy sử dụng mẫu CSV. Google Ads sẽ tự động băm mọi dữ liệu cần phải băm khi bạn tải mẫu CSV đã hoàn chỉnh lên.
Mở rộng mục bên dưới để xem nguyên tắc cho từng cột trong mẫu. Tên cột phải chính xác như được ghi trong mẫu.
Múi giờ- Cung cấp trong hàng đầu tiên nếu tất cả thời gian chuyển đổi đều ở cùng một múi giờ
- Nếu thời gian chuyển đổi thuộc các múi giờ khác nhau, hãy thêm múi giờ cho từng thời gian chuyển đổi trong cột "Thời gian chuyển đổi". Hãy xem lại các hướng dẫn và bảng trong mục "Thời gian chuyển đổi" trong bài viết này.
- Nếu bạn nhập một múi giờ vào cả hàng đầu tiên và cột "Thời gian chuyển đổi", thì cột "Thời gian chuyển đổi" sẽ được xem xét trước tiên trong tệp tải lên, sau đó là múi giờ trong hàng đầu tiên nếu một lượt chuyển đổi không có múi giờ.
- Nhập mã múi giờ trong danh sách này để tránh xảy ra lỗi trong thời điểm chuyển giao sang giờ mùa hè.
- Nhập số giờ chênh lệch so với Giờ chuẩn Greenwich (GMT) bằng cách thêm dấu “+” hoặc “-” vào trước số giờ ở dạng 4 chữ số. Đối với múi giờ GMT, hãy nhập +0000.
Ví dụ:
- America/New_York-0500
- Europe/Berlin+0100
- Tỷ lệ phần trăm tổng số lượt bán hàng trong tệp dữ liệu mà bạn có thể liên kết với một khách hàng
- Bạn nên để giá trị này là "1"
- Hiện tại, giá trị của tỷ lệ tải giao dịch lên không ảnh hưởng đến báo cáo lượt bán hàng tại cửa hàng thực tế. Bạn nên tải tất cả lượt bán hàng liên quan đến khách hàng lên và đặt tỷ lệ tải giao dịch lên thành "1".
Ví dụ:
- 0,5
- 0,2
- 0,8
- Cung cấp tên miền của tất cả các địa chỉ email (như gmail.com hoặc hotmail.co.jp).
- Xoá mọi khoảng trắng trong địa chỉ email.
- Tất cả ký tự bằng chữ thường
- Có thể cung cấp tối đa 3 địa chỉ email cho mỗi khách hàng (được tách thành 3 cột “Email”)
Ví dụ:
- user1@gmail.com
- user2@yahoo.com
- Tất cả ký tự bằng chữ thường
- Được phép sử dụng dấu.
- Xoá mọi khoảng trắng không cần thiết ở trước, sau và ở giữa tên.
Ví dụ:
- tom
- renée
- marie-astrid
- Tất cả ký tự bằng chữ thường
- Được phép sử dụng dấu.
- Xoá mọi khoảng trắng không cần thiết ở trước, sau và ở giữa tên.
Ví dụ:
- gupta
- o'calloway
- cox-cohen
- mcdonnell
- Tất cả ký tự bằng chữ thường
- Được phép sử dụng dấu.
Ví dụ:
- san francisco
- thành phố new york
- paris
- munich
- Tất cả ký tự bằng chữ thường
- Trường hợp ngoại lệ: tên tiểu bang viết tắt bằng 2 chữ cái đối với Hoa Kỳ
Ví dụ:
- CA
- california
- new york
- maharastra
- Được phép sử dụng mã bưu chính quốc tế và mã bưu chính của Hoa Kỳ.
- Đối với Hoa Kỳ:
- Được phép sử dụng mã bưu chính gồm 5 chữ số.
- Bạn cũng có thể sử dụng mã bưu chính gồm 5 chữ số kèm theo 4 số mở rộng phía sau để tăng tỷ lệ khớp.
- Đối với tất cả các quốc gia khác:
- Không bao gồm phần mở rộng của mã bưu chính.
Ví dụ:
- 94109
- 94109-1234
- W1J 0BH
- Sử dụng mã quốc gia gồm hai chữ cái theo ISO.
- Cung cấp mã quốc gia ngay cả khi tất cả dữ liệu khách hàng của bạn đến từ cùng một quốc gia
Ví dụ:
- US
- DE
- FR
- AU
- JP
- Phải định dạng các số điện thoại theo tiêu chuẩn E.164 và bao gồm dấu "+" ở đầu, sau đó là mã quốc gia và số thuê bao. Số này có thể bao gồm mã đích quốc gia hoặc mã vùng.
- Bạn có thể cung cấp tối đa 3 số điện thoại cho mỗi khách hàng (chia thành 3 cột “Số điện thoại”)
Ví dụ:
- +12038271234
- +442071838750
- Tên của hành động chuyển đổi mà bạn muốn nhập
- Phải khớp với cách viết chính tả và cách viết hoa của hành động chuyển đổi trong tài khoản Google Ads của bạn
Ví dụ:
- SS_customer_signups
- SS_customer_purchases
- Sử dụng định dạng ngày được chấp nhận. Hãy xem xét bảng bên dưới.
- Để thêm múi giờ vào thời gian chuyển đổi, hãy tham khảo một trong 4 định dạng cuối cùng ở bảng bên dưới.
- Thay "+z" bằng số giờ chênh lệch so với giờ GMT bằng cách thêm dấu "+" hoặc "-" vào trước số giờ chênh lệch ở dạng 4 chữ số.
- Hoặc thay thế "zzzz" bằng mã múi giờ.
| Định dạng | Ví dụ |
| MM/dd/yyyy hh:mm:ss aa | "08/14/2020 5:01:54 PM" |
| MMM dd,yyyy hh:mm:ss aa | "Aug 14, 2020 5:01:54 PM" |
| MM/dd/yyyy HH:mm:ss | "08/14/2020 17:01:54" |
| yyyy-MM-dd HH:mm:ss | "2020-08-14 13:00:00" |
| yyyy-MM-ddTHH:mm:ss | "2020-08-14T13:00:00" |
| yyyy-MM-dd HH:mm:ss+z | "2020-08-14 13:00:00+0500" |
| yyyy-MM-ddTHH:mm:ss+z | "2020-08-14T13:00:00-0100" |
| yyyy-MM-dd HH:mm:ss zzzz | "2020-08-14 13:00:00 America/Los_Angeles" |
| yyyy-MM-ddTHH:mm:ss zzzz | "2020-08-14T13:00:00 America/Los_Angeles" |
- Số đại diện cho giá trị mà bạn đặt cho lượt chuyển đổi
- Chỉ được phép sử dụng số dương
- Đơn vị tiền tệ mà giá trị chuyển đổi của bạn được cung cấp
- Sử dụng cột này nếu bạn báo cáo giá trị chuyển đổi bằng nhiều đơn vị tiền tệ hoặc bạn có nhiều tài khoản khách hàng được thanh toán bằng các đơn vị tiền tệ khác nhau
- Sử dụng mã tiền tệ gồm 3 ký tự theo tiêu chuẩn ISO 4217
Ví dụ:
- USD
- JPY
- EUR
- Các giá trị biến liên kết với biến tuỳ chỉnh đã đề cập trong hàng thông số.
- Giá trị biến được chỉ định trong tệp tải lên phải khớp với các giá trị biến đã xác định trong tài khoản Google Ads của bạn.
- Dùng cột này nếu bạn đang sử dụng biến tuỳ chỉnh và đã đưa một biến tuỳ chỉnh vào thông số.
- Dùng cột này để chỉ định các giá trị biến liên kết với từng giao dịch.
- Nếu bạn tải lên dữ liệu giao dịch có giá trị biến không trùng khớp với giá trị đã xác định trong tài khoản Google Ads, lượt chuyển đổi lượt bán hàng tại cửa hàng thực tế liên kết với giao dịch đó sẽ được báo cáo bằng giá trị biến “chưa được phân loại”.
Ví dụ:
- Biến tuỳ chỉnh: "Loại khách hàng"
- Giá trị biến: "Mới" hoặc "Cũ"
- Biến tuỳ chỉnh: "Danh mục sản phẩm"
- Giá trị biến: "Áo khoác", "Giày", "Quần áo thể thao" hoặc "Khác"
- Truyền các tín hiệu về sự đồng ý của người dùng ở EEA cho mục đích đo lường quảng cáo.
- Bắt buộc nếu sử dụng tính năng So khớp khách hàng với dữ liệu lượt bán hàng tại cửa hàng thực tế.
Các giá trị có thể có:
- Đã đồng ý: Người dùng đã đồng ý với việc sử dụng dữ liệu
- Đã từ chối: Người dùng đã từ chối việc sử dụng dữ liệu
- Chưa chỉ định: Chưa xác định trạng thái đồng ý
Ví dụ:
- Đã đồng ý
- Đã từ chối
- Truyền các tín hiệu về sự đồng ý của người dùng ở EEA cho mục đích cá nhân hoá quảng cáo.
- Bắt buộc nếu sử dụng tính năng So khớp khách hàng với dữ liệu lượt bán hàng tại cửa hàng thực tế.
Các giá trị có thể có:
- Đã đồng ý: Người dùng đã đồng ý với việc sử dụng dữ liệu
- Đã từ chối: Người dùng đã từ chối việc sử dụng dữ liệu
- Chưa chỉ định: Chưa xác định trạng thái đồng ý
Ví dụ:
- Đã đồng ý
- Đã từ chối
