Auf Lesedateien zugreifen

Lesedateien für Entitäten sind JSON-Darstellungen der Kampagnenobjekte eines Partners. Lesedateien für Elemente sind schreibgeschützt und können nicht zum Zurückschreiben von Änderungen in Google Display & Video 360 verwendet werden. Weitere Informationen zur Verwendung von Lesedateien erhalten Sie von Ihrem Account Manager, der Ihre Anforderungen mit Ihnen besprechen kann.

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

Das Format der Dateien, aus denen Entitäten gelesen werden, finden Sie in der Dateiformate-Referenz.

Die Lesedateien für Elemente werden in zwei Gruppen gespeichert:

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

Öffentliche Tabellen

gdbm-public/entity/(processing_date).(batch_index).(entity_type).json
FeldBeschreibung
processing_dateDas Datum, an dem die Daten in Display & Video 360 verarbeitet wurden. Es hat nicht unbedingt etwas mit den Ereignissen in der Datei zu tun. Das Datumsformat ist YYYYMMDD. 20120320 steht beispielsweise für den 20. März 2012.
batch_index Ein nullbasierter Index des Batches. Wenn sie beispielsweise stündlich generiert werden, hat der erste Batch die ID 0, der zweite Batch die ID 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äts-Lesedatei für die Tabelle browser vom 15. Januar 2013 abzurufen, sieht der Pfad zu der Datei so aus:
gdbm-public/entity/20130115.0.Browser.json

Private Tische

gdbm-(partner_id)/entity/(processing_date).(batch_index).(entity_type).json
FeldBeschreibung
partner_idDie numerische ID deines Partners.
processing_dateDas Datum, an dem die Daten in Display &Video 360 verarbeitet wurden. Dieses Datum bezieht sich nicht unbedingt auf die Ereignisse in der Datei. Das Datumsformat ist YYYYMMDD, 20120320 wäre beispielsweise der 20. März 2012. Die Dateien werden zwischen 4:00 und 6:00 Uhr in der Zeitzone des Partners generiert.
batch_indexEin nullbasierter Index des Batches. Derzeit ist das immer 0.
entity_typeDer Dateityp: Partner, Advertiser, InsertionOrder, LineItem, Creative, Pixel, InventorySource, UserList, UniversalChannel und summary.
Wenn Sie beispielsweise einen Dateinamen generieren, um die Datei zum Lesen von Entitäten für Partner 123 abzurufen, der am 2. April 2013 auf die Tabelle line_item zugegriffen hat, würde der Dateiname in etwa so aussehen:
gdbm-123/entity/20130402.0.LineItem.json