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

Tệp đọc thực thể là đại diện JSON cho 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 Entity Read Files, hãy liên hệ với người quản lý tài khoản của bạn. Người này có thể thảo luận chi tiết hơn về nhu cầu của bạn.

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

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

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 dữ liệu riêng tư khác của đối tác. 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 của bạn là 123, thì bộ chứa chứa 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 một thư mục con entity thuộc bộ chứa. Để biết thêm thông tin về cách xử lý các thư mục con, hãy xem phần Không gian tên đối tượng trong Cloud Storage.
Các bảng công khai sẽ được tạo lúc 5 giờ sáng (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ù đôi khi có thể bị chậm trễ), đồng thời được lưu trữ tự động và bảo mật trong Google Cloud Storage. 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 cộng

gdbm-public/entity/(processing_date).(batch_index).(entity_type).json
TrườngNội dung mô tả
processing_dateNgày 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 dựa trên 0 của lô. Ví dụ: nếu được tạo hằng giờ, lô đầu tiên sẽ là 0, thì lô thứ hai sẽ là 1, và cứ thế tiếp tục.
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
gdbm-public/entity/20130115.0.Browser.json

Bàn riêng

gdbm-(partner_id)/entity/(processing_date).(batch_index).(entity_type).json
TrườngNội dung mô tả
partner_idMã số của đối tác.
processing_dateNgày Display & Video 360 xử lý dữ liệu. Ngày này 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. Các tệp sẽ được tạo trong khoảng thời gian từ 4 giờ sáng đến 6 giờ sáng theo múi giờ của Đối tác.
batch_indexChỉ mục dựa trên 0 của lô. Hiện tại, giá trị này luôn bằng 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 bằng cách 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