Accéder aux fichiers de lecture des entités

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.

Le format des fichiers de lecture des entités peut être consulté dans la documentation de référence sur le format de fichier.

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.

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 lot est généré toutes les heures, le premier lot sera 0, le deuxième 1, etc.
entity_typeLe 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 :
gdbm-public/entity/20130115.0.Browser.json

Tables privées

gdbm-(partner_id)/entity/(processing_date).(batch_index).(entity_type).json
ChampDescription
partner_idID 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, heure du fuseau horaire du partenaire.
batch_indexIndex basé sur zéro du lot. Actuellement, cette valeur est toujours 0.
entity_typeLe 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