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 đối với chiến dịch Hiển thị và Video 360. Để tìm hiểu thêm về cách sử dụng Tệp đọc thực thể, hãy liên hệ với người quản lý tài khoản để họ 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ỉ dùng được trong vòng 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ề các 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 thông tin khác dữ liệu riêng tư của người dùng. Bảng riêng tư được lưu trữ trong bộ chứa dành riêng cho đối tác; ví dụ: nếu mã đối tác là 123, 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à riêng tư đều nằm trong thư mục con entity thuộc nhóm. Để biết thêm thông tin về cách xử lý thư mục con, hãy xem 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 (tuy nhiên, trong một số ít trường hợp thì có thể bị chậm trễ) và được lưu trữ tự động và một cách an toàn trong Google Cloud Storage. Tệp tóm tắt được tạo sau tất 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 hiển thị và 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ờ thì 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, đườ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 của bạn.
processing_dateNgày hiển thị và 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 trong khoảng từ 4:00 đến 6:00 sáng theo múi giờ của Đối tác.
batch_indexChỉ mục 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 từ ngày 2 tháng 4 năm 2013, tên tệp của bạn sẽ có dạng như sau:
gdbm-123/entity/20130402.0.LineItem.json