Accéder aux fichiers de lecture des entités

Les fichiers de lecture des 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 écrire des modifications apportées à Google Display & Video 360. Pour en savoir plus sur l'utilisation des fichiers de lecture des entités, contactez votre responsable de compte, qui pourra discuter de vos besoins plus en détail.

Notez que les fichiers de lecture des entités ne sont disponibles que pendant 60 jours à compter de leur date de traitement.

Vous pouvez consulter le format des fichiers de lecture des entités dans la documentation de référence sur le format de fichier.

Les fichiers de lecture des entités sont stockés sous la forme de 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.
  • Des 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 à un partenaire. Par exemple, si votre ID de partenaire est 123, le bucket contenant vos tables privées serait 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 d'objets Cloud Storage.
Les tables publiques sont générées à 5h UTC. Les tables privées sont générées à 5h dans le fuseau horaire de votre partenaire (bien que cela puisse parfois occasionner un retard) 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 que toutes les tables publiques et privées ont été générées.

Tables publiques

gdbm-public/entity/(processing_date).(batch_index).(entity_type).json
ChampDescription
processing_dateDate à 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 premier lot est généré toutes les heures, il s'agit de 0, le deuxième lot est 1, et ainsi de suite.
entity_typeType 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 la table browser du 15 janvier 2013, le chemin d'accès au fichier ressemblerait à
gdbm-public/entity/20130115.0.Browser.json

Tables privées

gdbm-(partner_id)/entity/(processing_date).(batch_index).(entity_type).json
ChampDescription
partner_idIdentifiant numérique de votre partenaire.
processing_dateDate à 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 dans le fuseau horaire du partenaire.
batch_indexIndex basé sur zéro du lot. Actuellement, cette valeur correspond toujours à 0.
entity_typeType 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é pour le partenaire 123 accédant à la table line_item à partir du 2 avril 2013, votre nom de fichier ressemblerait à ceci :
gdbm-123/entity/20130402.0.LineItem.json