Nguồn cấp dữ liệu đã sẵn sàng

Nguồn cấp dữ liệu cung cấp dữ liệu kho hàng cho Actions Center. Việc tải lên hằng ngày bằng Giao thức truyền tệp bảo mật (SFTP) sẽ cập nhật tất cả dữ liệu về người bán, dịch vụ và khung giờ còn trống. Nguồn cấp dữ liệu chỉ định những người bán mà bạn hỗ trợ, tình trạng còn hàng của họ và mọi tính năng đặc biệt cần thiết để xác nhận rằng Google hiển thị kho hàng của bạn đúng cách. Nguồn cấp dữ liệu được tải lên các tài khoản đăng SFTP mà bạn định cấu hình khi cung cấp khoá SSH trong phần Thiết lập.

Bạn phải hoàn thành các việc cần làm sau đây trong giai đoạn Nguồn cấp dữ liệu đã sẵn sàng trước khi chuyển sang giai đoạn Máy chủ đặt phòng:

Các việc cần làm sẽ được đánh dấu là đã hoàn thành và chuyển sang màu xanh lục sau khi bạn tải nguồn cấp dữ liệu lên thành công. Xem tài liệu được liên kết để hoàn thành từng nhiệm vụ cụ thể trong cột mốc.

Để đảm bảo chức năng phù hợp của tính năng tích hợp Đặt chỗ dùng bữa từ đầu đến cuối, bạn cần tự động cung cấp nguồn cấp dữ liệu hằng ngày của người bán, nguồn cấp dữ liệu dịch vụ và nguồn cấp dữ liệu về tình trạng còn chỗ. Cơ sở hạ tầng nguồn cấp dữ liệu tự động phải cung cấp toàn bộ kho hàng của bạn.

Các loại nguồn cấp dữ liệu

Các chế độ tích hợp Đặt chỗ dùng bữa hoàn chỉnh yêu cầu những nguồn cấp dữ liệu sau đây và tần suất tải lên của chúng:

Nguồn cấp dữ liệu Mô tả Tần suất Mẫu
Người bán Mô tả người bán của bạn. 24 giờ một lần Mẫu nguồn cấp dữ liệu của người bán
Dịch vụ Mô tả các dịch vụ của người bán. 24 giờ một lần Mẫu nguồn cấp dữ liệu dịch vụ
Phạm vi cung cấp Mô tả các khung giờ còn trống cho dịch vụ của người bán. Bạn phải cung cấp phạm vi bảo hiểm tối thiểu là 30 ngày. Để gia hạn thời gian bảo hành lên 90 ngày, hãy liên hệ với Nhóm hỗ trợ Google thông qua biểu mẫu liên hệ của Actions Center. 24 giờ một lần Mẫu nguồn cấp dữ liệu về tình trạng còn hàng

Định dạng nguồn cấp dữ liệu được mô tả bằng cú pháp bộ đệm giao thức 3, nhưng bạn có thể tải nguồn cấp dữ liệu lên theo định dạng JSON tương ứng. Tham khảo các mẫu nguồn cấp dữ liệu để biết định dạng JSON. Bạn nên tải nguồn cấp dữ liệu lên ở định dạng JSON.

Quy ước đặt tên và siêu dữ liệu

Tên tệp

Nếu bạn sử dụng phân đoạn, thì nguồn cấp dữ liệu mà bạn tải lên phải có tên riêng biệt, trong đó chỉ định loại và số lượng nguồn cấp dữ liệu. Dấu thời gian để tạo nguồn cấp dữ liệu đáp ứng yêu cầu riêng biệt về việc đặt tên tệp nguồn cấp dữ liệu.

Cấu trúc: {feed_name}_{timestamp_epoch}_{shard_nunber}_{total_shard}.json

Ví dụ: availability_feed_1574117613_001_of_002.json.gz

Xác định mã nhận dạng

Khi xác định mã nhận dạng cho người bán hoặc các thuộc tính khác yêu cầu mã nhận dạng, bạn nên sử dụng UID hoặc UUID. Bạn có thể cung cấp giải pháp chữ và số của riêng mình miễn là các mã nhận dạng vẫn khác biệt trên nền tảng của bạn.

Metadata

Khi bạn tạo nguồn cấp dữ liệu, generation_timestamp phải phản ánh thời điểm dữ liệu được lấy từ cơ sở dữ liệu. Việc sử dụng lại giá trị này trên nhiều nguồn cấp dữ liệu có thể dẫn đến lỗi xử lý.

Giá trị số chỉ dùng một lần, số ngẫu nhiên hoặc số không lặp lại, phải là duy nhất trên các loại nguồn cấp dữ liệu và không được sử dụng lại. Giá trị này phải khớp với tất cả các tệp trong nguồn cấp dữ liệu phân đoạn cụ thể.

Kích thước tệp nguồn cấp dữ liệu

Phân đoạn tệp cấp dữ liệu

Tuỳ thuộc vào kho hàng của bạn, bạn có thể cần phân đoạn hoặc chia nguồn cấp dữ liệu thành nhiều tệp. Bạn có thể cần phân chia nguồn cấp dữ liệu trong các trường hợp sau:

  • Nguồn cấp dữ liệu nén gzip vượt quá 200 MB cho một tệp.
    • Ví dụ: Nguồn cấp dữ liệu về tình trạng còn hàng được tạo có dung lượng 1 GB. Bạn phải phân đoạn thành 5 phân đoạn riêng biệt trở lên.
  • Khoảng không quảng cáo của đối tác được phân phối trên nhiều hệ thống hoặc khu vực, dẫn đến khó khăn trong việc điều chỉnh khoảng không quảng cáo.
    • Ví dụ: đối tác có khoảng không quảng cáo ở Hoa Kỳ và Liên minh Châu Âu nằm trong các hệ thống riêng biệt. Nguồn cấp dữ liệu có thể được tạo bằng 2 phân đoạn. Một cho Hoa Kỳ và một cho Liên minh Châu Âu với cùng một số chỉ dùng một lần và generation_timestamp.

Để biết thêm thông tin, hãy xem Hướng dẫn và các phương pháp hay nhất về việc phân chia tệp nguồn cấp dữ liệu.

Một nguồn cấp dữ liệu có thể bao gồm nhiều tệp được gọi là phân đoạn. Để xác định kích thước của nguồn cấp dữ liệu, hãy tuân theo các nguyên tắc sau:

  • Đề xuất phân chia nguồn cấp dữ liệu:
    • Nguồn cấp dữ liệu người bán: một phân đoạn.
    • Nguồn cấp dữ liệu dịch vụ: một phân đoạn.
    • Nguồn cấp dữ liệu về tình trạng còn phòng: dưới 20 phân đoạn. Nếu bạn có lý do kinh doanh cần nhiều hơn số tiền đã chỉ định, hãy liên hệ với nhóm hỗ trợ để được hướng dẫn thêm.
  • Kích thước tệp nguồn cấp dữ liệu và phân đoạn:
    • Giữ kích thước tệp phân đoạn nhỏ hơn 200 MB sau khi nén. Sử dụng nhiều phân đoạn nếu cần.
    • Các bản ghi riêng lẻ được gửi trong một phân đoạn không cần phải được gửi trong cùng một phân đoạn trong các nguồn cấp dữ liệu sau này.
    • Để có hiệu suất tốt hơn, hãy chia đều dữ liệu giữa các phân đoạn để tất cả các tệp phân đoạn có kích thước tương tự nhau.
    • Nếu cần, hãy sử dụng gzip để nén các nguồn cấp dữ liệu JSON văn bản thuần tuý cho từng phân đoạn nguồn cấp dữ liệu riêng lẻ.

Nén tệp nguồn cấp dữ liệu

Bạn có thể nén mọi tệp JSON hoặc PB3 bằng gzip trước khi tải lên. Điều này có thể giảm đáng kể kích thước byte của nguồn cấp dữ liệu hằng ngày.

Mỗi tệp phân đoạn phải được nén bằng gzip và tải lên riêng lẻ, chẳng hạn như gzip*.json. Các phân đoạn nguồn cấp dữ liệu nén phải kết thúc bằng .json.gz hoặc .pb3.gz.

Tải nguồn cấp dữ liệu lên tài khoản đăng SFTP

Sau khi tạo Nguồn cấp dữ liệu Người bán, Dịch vụ và Tình trạng còn hàng, bạn có thể tải nguồn cấp dữ liệu lên môi trường Hộp cát hoặc Sản xuất thông qua hộp thả SFTP. Dropbox SFTP được định cấu hình khi bạn cung cấp khoá SSH trong phần Thiết lập. Máy chủ SFTP của Google có tại sftp://partnerupload.google.com trên cổng 19321.

Google sẽ xem xét và xác thực các tệp nguồn cấp dữ liệu ngay khi bạn tải các tệp đó lên dropbox SFTP. Nếu nguồn cấp dữ liệu được phân mảnh trên nhiều tệp, thì các tệp đó sẽ được xử lý sau khi bạn tải tệp cuối cùng lên. Nếu nguồn cấp dữ liệu của bạn có lỗi, chúng tôi sẽ gửi cho bạn một email có mã lỗi nguồn cấp dữ liệu. Lỗi ngăn không cho việc sử dụng những người bán, dịch vụ hoặc tình trạng còn hàng đã xác định. Sau khi nguồn cấp dữ liệu được xác thực, có thể mất đến 24 giờ thì nguồn cấp dữ liệu mới xuất hiện trên giao diện người dùng.