Truy cập tệp đọc thực thể

Tệp đọc thực thể là bản đại diện JSON của các đối tượng chiến dịch của đối tác. Tệp đọc thực thể chỉ có thể đọc và không thể dùng để ghi lại các thay đổi vào Google Display & Video 360. Để tìm hiểu thêm về cách sử dụng tệp Entity Read Files, hãy liên hệ với người quản lý tài khoản. Người này có thể thảo luận chi tiết hơn về nhu cầu của bạn.

Xin lưu ý rằng Tệp đọc thực thể chỉ có sẵn trong 60 ngày kể từ ngày xử lý.

Bạn có thể xem định dạng của tệp đọc thực thể trong Tài liệu tham khảo về định dạng tệp.

Các tệp đọc thực thể được lưu trữ dưới dạng hai nhóm:

  • Bảng công khai chứa dữ liệu công khai phổ biến, chẳng hạn như thông tin về phiên bản trình duyệt hoặc ngôn ngữ được lưu trữ trong bộ chứa gdbm-public.
  • Bảng riêng tư chứa thông tin về chiến dịch, ngân sách và các dữ liệu riêng tư khác của đối tác. Các bảng riêng tư được lưu trữ trong các bộ chứa dành riêng cho đối tác; ví dụ: nếu mã đối tác của bạn là 123, thì bộ chứa chứa các bảng riêng tư của bạn sẽ là gdbm-123.
Cả bảng công khai và bảng riêng tư đều nằm trong thư mục con entity trong bộ chứa. Để biết thêm thông tin về cách xử lý thư mục con, hãy xem bài viết Không gian tên đối tượng Cloud Storage.
Các bảng công khai được tạo lúc 5 giờ sáng theo giờ UTC. Các bảng riêng tư được tạo lúc 5 giờ sáng theo múi giờ của đối tác (mặc dù trong một số ít trường hợp có thể bị chậm trễ) và được lưu trữ tự động và an toàn trong Bộ nhớ trên đám mây của Google. Tệp tóm tắt sẽ được tạo sau khi tất cả các bảng công khai và riêng tư đã được tạo.

Bảng công khai

gdbm-public/entity/(processing_date).(batch_index).(entity_type).json
TrườngMô tả
processing_dateNgày mà Display & Video 360 xử lý dữ liệu và không nhất thiết liên quan đến các sự kiện có trong tệp. Định dạng ngày là YYYYMMDD, ví dụ: 20120320 sẽ là ngày 20 tháng 3 năm 2012.
batch_index Chỉ mục từ 0 của lô. Ví dụ: nếu được tạo hằng giờ, lô đầu tiên sẽ là 0, lô thứ hai sẽ là 1, v.v.
entity_typeLoại tệp: SupportedExchange, DataPartner, UniversalSite, GeoLocation, Language, OperatingSystem, Browser, Isp, summarySiteIdToPlacementId.csv.
Ví dụ: nếu bạn đang tạo tên tệp để truy xuất tệp đọc thực thể cho bảng browser từ ngày 15 tháng 1 năm 2013, thì đường dẫn đến tệp sẽ có dạng như sau
gdbm-public/entity/20130115.0.Browser.json

Bảng riêng tư

gdbm-(partner_id)/entity/(processing_date).(batch_index).(entity_type).json
TrườngMô tả
partner_idMã dạng số của Đối tác.
processing_dateNgày mà Display & Video 360 xử lý dữ liệu. Ngày này không nhất thiết phải liên quan đến các sự kiện có trong tệp. Định dạng ngày là YYYYMMDD, ví dụ: 20120320 là ngày 20 tháng 3 năm 2012. Các tệp sẽ được tạo từ 4 giờ đến 6 giờ sáng theo múi giờ của Đối tác.
batch_indexChỉ mục bắt đầu từ 0 của lô. Hiện tại, giá trị này luôn là 0.
entity_typeLoại tệp: Partner, Advertiser, InsertionOrder, LineItem, Creative, Pixel, InventorySource, UserList, UniversalChannelsummary.
Ví dụ: nếu bạn đang tạo tên tệp để truy xuất tệp đọc thực thể cho đối tác 123 truy cập vào bảng line_item kể từ ngày 2 tháng 4 năm 2013, thì tên tệp của bạn sẽ có dạng như sau:
gdbm-123/entity/20130402.0.LineItem.json