Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
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ý.
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.
Ngà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_type
Loại tệp: SupportedExchange, DataPartner, UniversalSite, GeoLocation, Language, OperatingSystem, Browser, Isp, summary và SiteIdToPlacementId.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
Ngà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_index
Chỉ mục bắt đầu từ 0 của lô. Hiện tại, giá trị này luôn là 0.
entity_type
Loại tệp: Partner, Advertiser, InsertionOrder, LineItem, Creative, Pixel, InventorySource, UserList, UniversalChannel và summary.
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:
[null,null,["Cập nhật lần gần đây nhất: 2025-08-31 UTC."],[[["\u003cp\u003eEntity Read Files (ERF) have been discontinued and users should migrate to the Display & Video 360 API.\u003c/p\u003e\n"],["\u003cp\u003eEntity Read Files provided read-only JSON representations of a partner's campaign data but were not capable of writing back changes.\u003c/p\u003e\n"],["\u003cp\u003eThese files were organized into public tables, containing common data like browser versions, and private tables, containing partner-specific campaign data, within respective Google Cloud Storage buckets.\u003c/p\u003e\n"],["\u003cp\u003ePublic tables were generated daily at 5 AM UTC, while private tables were generated at 5 AM in the partner's timezone and stored with a specific naming convention indicating the processing date, batch index, and entity type.\u003c/p\u003e\n"],["\u003cp\u003eEach public and private table has a \u003ccode\u003eprocessing_date\u003c/code\u003e and \u003ccode\u003ebatch_index\u003c/code\u003e as well as an \u003ccode\u003eentity_type\u003c/code\u003e to indicate what type of data is contained within the table.\u003c/p\u003e\n"]]],[],null,["# Access Entity Read Files\n\n| Entity Read Files have sunset. [Migrate to use the\n| Display \\& Video 360 API.](/display-video/api/guides/how-tos/erf-migration)\n\nEntity Read Files are JSON representations of a partner's campaign objects. Entity Read Files\nare read-only and cannot be used to write-back changes to Google Display \\& Video 360. To learn more about using\nEntity Read Files, contact your account manager, who will be able to discuss your needs in more detail.\n\nNote that Entity Read Files are available only for 60 days from their processing date.\n\nThe format of the entity read files can be viewed in the\n[File Format reference](/bid-manager/guides/entity-read/format-v2).\n\nThe entity read files are stored as two groups: \n\n- Public tables, which contain common public data, such as information about browser versions or languages that are stored in the `gdbm-public` bucket.\n- Private tables, which contain information about the partner's campaigns, budgets, and other private data. Private tables are stored in partner-specific buckets; for example, if your partner ID is 123, the bucket that contained your private tables would be `gdbm-123`.\n\nBoth public and private tables are in an `entity` subdirectory within the bucket. For more information about handling subdirectories, see [Cloud Storage object namespace](/storage/docs/objects#namespace). \nThe public tables are generated at 5AM UTC. The private tables are generated at 5AM in your partner's timezone (although in rare cases there may be delays) and stored automatically and securely in [Google Cloud Storage](/storage). A summary file is generated after all of the public and private tables have been generated. All filenames are case-sensitive.\n\nPublic Tables\n-------------\n\n```\ngdbm-public/entity/(processing_date).(batch_index).(entity_type).json\n```\n\n| Field | Description |\n|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `processing_date` | The date when Display \\& Video 360 processed the data and is not necessarily related to the events contained within the file. Date format is `YYYYMMDD`, for example `20120320` would be March 20, 2012. |\n| `batch_index` | A zero-based index of the batch. For example, if generated hourly the first batch would be `0`, the second batch would be `1`, and so on. |\n| `entity_type` | The type of file: `SupportedExchange`, `DataPartner`, `UniversalSite`, `GeoLocation`, `Language`, `OperatingSystem`, `Browser`, `Isp`, `summary` and `SiteIdToPlacementId.csv`. |\n\nFor example, if you were generating a filename to retrieve the entity read file for the `browser` table from January 15th, 2013, the path to the file would look like \n\n```\ngdbm-public/entity/20130115.0.Browser.json\n```\n\nPrivate Tables\n--------------\n\n```\ngdbm-(partner_id)/entity/(processing_date).(batch_index).(entity_type).json\n```\n\n| Field | Description |\n|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `partner_id` | The numeric ID of your Partner. |\n| `processing_date` | The date when Display \\& Video 360 processed the data. This date is not necessarily related to the events contained within the file. Date format is `YYYYMMDD`, for example `20120320` would be March 20, 2012. The files will be generated between 4AM and 6AM in the Partner's timezone. |\n| `batch_index` | A zero-based index of the batch. Currently this is always 0. |\n| `entity_type` | The type of file: `Partner`, `Advertiser`, `InsertionOrder`, `LineItem`, `Creative`, `Pixel`, `InventorySource`, `UserList`, `UniversalChannel`, and `summary`. |\n\nFor example, if you were generating a file name to retrieve the entity read file for partner 123 accessing the `line_item` table from April 2, 2013, your filename would look something like this: \n\n```\ngdbm-123/entity/20130402.0.LineItem.json\n```"]]
