Auf Lesedateien zugreifen

Entitäts-Lesedateien sind JSON-Darstellungen der Kampagnenobjekte eines Partners. Lesedateien sind schreibgeschützt und können nicht verwendet werden, um Änderungen an Google Display & Video 360 zurückzuschreiben. Wenn Sie mehr über die Verwendung von Lesedateien für Entitäten erfahren möchten, wenden Sie sich an Ihren Account Manager, der Ihre Anforderungen im Detail besprechen kann.

Lesedateien sind ab dem Verarbeitungsdatum nur 60 Tage lang verfügbar.

Das Format der Lesedateien für Entitäten finden Sie in der Referenz zum Dateiformat.

Die Lesedateien für Entitäten werden in zwei Gruppen gespeichert:

  • Öffentliche Tabellen, die allgemeine öffentliche Daten enthalten, z. B. Informationen zu Browserversionen oder Sprachen, die im gdbm-public-Bucket gespeichert sind.
  • Private Tabellen, die Informationen zu den Kampagnen, Budgets und anderen privaten Daten des Partners enthalten. Private Tabellen werden in partnerspezifischen Buckets gespeichert. Wenn Ihre Partner-ID beispielsweise 123 ist, lautet der Bucket, der Ihre privaten Tabellen enthält, gdbm-123.
Öffentliche und private Tabellen befinden sich im Unterverzeichnis entity innerhalb des Buckets. Weitere Informationen zum Umgang mit Unterverzeichnissen finden Sie unter Cloud Storage-Objekt-Namespace.
Die öffentlichen Tabellen werden um 05:00 Uhr (UTC) generiert. Die privaten Tabellen werden um 05:00 Uhr in der Zeitzone Ihres Partners generiert (in seltenen Fällen kann es zu Verzögerungen kommen) und automatisch und sicher in Google Cloud Storage gespeichert. Eine Zusammenfassungsdatei wird generiert, nachdem alle öffentlichen und privaten Tabellen generiert wurden.

Öffentliche Tische

gdbm-public/entity/(processing_date).(batch_index).(entity_type).json
FieldBeschreibung
processing_dateDas Datum, an dem die Daten in Display & Video 360 verarbeitet wurden. Es bezieht sich nicht unbedingt auf die Ereignisse in der Datei. Das Datumsformat ist YYYYMMDD, 20120320 wäre z. B. der 20. März 2012.
batch_index Ein nullbasierter Index des Batchs. Wenn beispielsweise stündlich generiert wird, wäre der erste Batch 0, der zweite Batch 1 usw.
entity_typeDer Dateityp: SupportedExchange, DataPartner, UniversalSite, GeoLocation, Language, OperatingSystem, Browser, Isp, summary und SiteIdToPlacementId.csv.
Wenn Sie beispielsweise einen Dateinamen generieren, um die Entitätslesedatei für die Tabelle browser vom 15. Januar 2013 abzurufen, sieht der Pfad zur Datei so aus:
gdbm-public/entity/20130115.0.Browser.json

Private Tabellen

gdbm-(partner_id)/entity/(processing_date).(batch_index).(entity_type).json
FieldBeschreibung
partner_idDie numerische ID Ihres Partners.
processing_dateDas Datum, an dem die Daten in Display & Video 360 verarbeitet wurden. Dieses Datum hängt nicht unbedingt mit den in der Datei enthaltenen Ereignissen zusammen. Das Datumsformat ist YYYYMMDD, 20120320 wäre z. B. der 20. März 2012. Die Dateien werden zwischen 04:00 und 6:00 Uhr in der Zeitzone des Partners generiert.
batch_indexEin nullbasierter Index des Batchs. Derzeit ist dieser Wert immer 0.
entity_typeDer Dateityp: Partner, Advertiser, InsertionOrder, LineItem, Creative, Pixel, InventorySource, UserList, UniversalChannel und summary.
Wenn Sie beispielsweise einen Dateinamen generieren, um die Entitäts-Lesedatei für Partner 123 abzurufen, die auf die Tabelle line_item vom 2. April 2013 zugreift, sieht Ihr Dateiname in etwa so aus:
gdbm-123/entity/20130402.0.LineItem.json