Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Les fichiers de lecture d'entités sont des représentations JSON des objets de campagne d'un partenaire. Les fichiers de lecture des entités sont en lecture seule et ne peuvent pas être utilisés pour réécrire les modifications apportées à Google Display & Video 360. Pour en savoir plus sur l'utilisation des fichiers de lecture d'entités, contactez votre responsable de compte, qui pourra discuter plus en détail de vos besoins.
Notez que les fichiers de lecture des entités ne sont disponibles que pendant 60 jours à compter de la date de traitement.
Les fichiers de lecture des entités sont stockés dans deux groupes:
Tables publiques, qui contiennent des données publiques courantes, telles que des informations sur les versions de navigateur ou les langues stockées dans le bucket gdbm-public.
Tables privées, qui contiennent des informations sur les campagnes, les budgets et d'autres données privées du partenaire. Les tables privées sont stockées dans des buckets spécifiques au partenaire. Par exemple, si votre ID de partenaire est 123, le bucket contenant vos tables privées est gdbm-123.
Les tables publiques et privées se trouvent dans un sous-répertoire entity du bucket.
Pour en savoir plus sur la gestion des sous-répertoires, consultez la section Espace de noms des objets Cloud Storage.
Les tables publiques sont générées à 5h UTC. Les tables privées sont générées à 5h du matin dans le fuseau horaire de votre partenaire (bien que des retards puissent se produire dans de rares cas) et stockées automatiquement et de manière sécurisée dans Google Cloud Storage. Un fichier récapitulatif est généré une fois toutes les tables publiques et privées générées.
Date à laquelle Display &Video 360 a traité les données. Elle n'est pas nécessairement liée aux événements contenus dans le fichier. Le format de date est YYYYMMDD. Par exemple, 20120320 correspond au 20 mars 2012.
batch_index
Index basé sur zéro du lot. Par exemple, si le lot est généré toutes les heures, le premier lot sera 0, le deuxième 1, etc.
entity_type
Le type de fichier: SupportedExchange, DataPartner, UniversalSite, GeoLocation, Language, OperatingSystem, Browser, Isp, summary et SiteIdToPlacementId.csv.
Par exemple, si vous générez un nom de fichier pour récupérer le fichier de lecture des entités pour le tableau browser du 15 janvier 2013, le chemin d'accès au fichier se présente comme suit :
Date à laquelle Display & Video 360 a traité les données. Cette date n'est pas nécessairement liée aux événements contenus dans le fichier. Le format de date est YYYYMMDD. Par exemple, 20120320 correspond au 20 mars 2012. Les fichiers seront générés entre 4h et 6h, heure du fuseau horaire du partenaire.
batch_index
Index basé sur zéro du lot. Actuellement, cette valeur est toujours 0.
entity_type
Le type de fichier: Partner, Advertiser, InsertionOrder, LineItem, Creative, Pixel, InventorySource, UserList, UniversalChannel et summary.
Par exemple, si vous générez un nom de fichier pour récupérer le fichier de lecture d'entité du partenaire 123 qui accède à la table line_item à partir du 2 avril 2013, votre nom de fichier se présente comme suit:
gdbm-123/entity/20130402.0.LineItem.json
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[null,null,["Dernière mise à jour le 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```"]]
