Khoảng không quảng cáo phiên bản 1 là cấu trúc phân cấp của các thực thể nguồn cấp dữ liệu ở định dạng JSON-LD. Giản đồ này cho phép các đối tác chương trình tiếp cận sớm sử dụng giản đồ này để tích hợp với quy trình Đặt hàng hai đầu. Giản đồ khoảng không quảng cáo phiên bản 1 hiện không còn được dùng nữa.
Phiên bản mới nhất của quy cách nguồn cấp dữ liệu, khoảng không quảng cáo v2, có cấu trúc phẳng và sử dụng mô hình giản đồ quan hệ. Điều này cho phép các đối tác trích xuất và chuyển đổi các thực thể từ cơ sở dữ liệu quan hệ theo cách đơn giản hơn để tạo nguồn cấp dữ liệu. Khoảng không quảng cáo phiên bản 2 có định dạng NDJSON, một định dạng JSON được phân tách bằng dòng mới.
Lý do bạn nên chuyển từ phiên bản 1 sang phiên bản 2
Mặc dù chúng tôi vẫn tiếp tục cung cấp dịch vụ hỗ trợ bảo trì cho những đối tác tích hợp giản đồ khoảng không quảng cáo phiên bản 1 để đặt hàng hai đầu, nhưng tất cả quy trình tích hợp mới của đối tác đều phải sử dụng khoảng không quảng cáo phiên bản 2.
Các tính năng mới trong khoảng không quảng cáo phiên bản 2 có thể không có trong khoảng không quảng cáo phiên bản 1. Để biết ví dụ, hãy xem bài viết Giao dịch.
Các bước di chuyển
Để sử dụng khoảng không quảng cáo phiên bản 2, bạn cần có một dự án Đặt hàng đầu cuối riêng biệt và một chế độ tích hợp mới. Quy trình sau đây giải thích cách di chuyển khoảng không quảng cáo phiên bản 1 sang khoảng không quảng cáo phiên bản 2.
- Để tạo một dự án phiên bản 2 mới, trước tiên, hãy hoàn tất các bước tích hợp.
- Để triển khai nguồn cấp dữ liệu, hãy sử dụng giản đồ khoảng không quảng cáo quan hệ.
- Nếu có thể, hãy sử dụng lại điểm cuối của phương thức thực hiện trong dự án phiên bản 1 của bạn.
- Khi dự án phiên bản 2 đã sẵn sàng để phát hành, hãy làm theo các bước sau:
- Đảm bảo dự án phiên bản 2 của bạn đáp ứng danh sách kiểm tra trạng thái sẵn sàng ra mắt.
- Để ngăn việc phân phát cả giản đồ khoảng không quảng cáo v1 và v2 cho người dùng cuối, hãy huỷ triển khai bản phát hành chính thức khỏi dự án v1. Khoảng không quảng cáo trong dự án v1 của bạn sẽ ngừng phân phát trong phiên bản chính thức trong vòng vài phút sau bước này.
- Tạo bản phát hành công khai cho dự án v2 và thông báo cho tư vấn viên của Google.
Các bước khôi phục
Nếu muốn khôi phục về v1 sau khi triển khai dự án v2 trong phiên bản chính thức, bạn có thể huỷ triển khai bản phát hành chính thức trong dự án v2, sau đó triển khai lại bản phát hành chính thức của dự án v1.
Tác động đến dữ liệu đối tác và thứ hạng của nhà cung cấp
Sau đây là những tác động có thể xảy ra đối với dữ liệu đối tác và thứ hạng của nhà cung cấp.
- Nhật ký giao dịch và dữ liệu phân tích trong dự án phiên bản 1 sẽ không chuyển sang dự án phiên bản 2 của bạn.
- Các chỉ số về hiệu suất, chẳng hạn như tỷ lệ chuyển đổi và chỉ số API từ dự án phiên bản 1, sẽ không được chuyển sang dự án phiên bản 2. Thao tác này sẽ đặt lại thứ hạng của nhà cung cấp theo thứ tự hai đầu.