Display & Video 360-Übertragung planen

Mit BigQuery Data Transfer Service für Display & Video 360 Connector können Sie wiederkehrende Ladejobs für Display & Video 360-Berichte und -Konfigurationsdaten automatisch planen und verwalten.

Unterstützte Berichte

BigQuery Data Transfer Service für Display & Video 360 unterstützt die folgende Berichtsoption:

Informationen zur Umwandlung von Display & Video 360-Berichten in BigQuery-Tabellen und -Ansichten finden Sie unter Display & Video 360-Datentransformation.

In Display & Video 360 werden Datenübertragungsdateien bis zu 60 Tage lang aufbewahrt.

Berichtsoption Support
Wiederholungshäufigkeit

Täglich zu der Zeit, zu der die Datenübertragung erstmalig erstellt wird (Standard)

Sie können die Tageszeit konfigurieren.
Aktualisierungsfenster

Letzte zwei Tage

Nicht konfigurierbar
Maximale Backfill-Dauer

Letzte 60 Tage

Unterstützte Konfigurationsdaten

Neben den Berichtsdaten überträgt BigQuery Data Transfer Service auch die folgenden Konfigurationsdaten aus Display & Video 360. Konfigurationsdaten werden von Display & Video 360 API Version 3 abgerufen.

Weitere Informationen zu den einzelnen Konfigurationsdatentypen finden Sie unter den folgenden Links:

Datenaufnahme aus Display & Video 360-Übertragungen

Wenn Sie Daten aus Display & Video 360 in BigQuery übertragen, werden die Daten in BigQuery-Tabellen geladen, die nach Datum partitioniert sind. Die Tabellenpartition, in die die Daten geladen werden, entspricht dem Datum aus der Datenquelle. Wenn Sie mehrere Übertragungen für dasselbe Datum planen, überschreibt BigQuery Data Transfer Service die Partition für dieses Datum mit den neuesten Daten. Mehrere Übertragungen am selben Tag oder laufende Backfills führen nicht zu doppelten Daten; Partitionen für andere Daten sind nicht betroffen.

Fenster aktualisieren

Ein Aktualisierungsfenster ist die Anzahl der Tage, an denen eine Datenübertragung Daten zu einer Datenübertragung abruft. Wenn das Aktualisierungsfenster beispielsweise drei Tage beträgt und eine tägliche Übertragung erfolgt, ruft der BigQuery Data Transfer Service alle Daten aus Ihrer Quelltabelle der letzten drei Tage ab. In diesem Beispiel erstellt der BigQuery Data Transfer Service bei einer täglichen Übertragung eine neue BigQuery-Zieltabellenpartition mit einer Kopie der Daten der Quelltabelle vom aktuellen Tag und löst dann automatisch Backfill-Ausführungen aus, um die BigQuery-Zieltabellenpartitionen mit den Daten der Quelltabelle aus den letzten zwei Tagen zu aktualisieren. Die automatisch ausgelösten Backfill-Ausführungen überschreiben oder aktualisieren Ihre BigQuery-Zieltabelle entweder schrittweise oder aktualisieren sie, je nachdem, ob inkrementelle Aktualisierungen im BigQuery Data Transfer Service-Connector unterstützt werden oder nicht.

Wenn Sie eine Datenübertragung zum ersten Mal ausführen, werden alle Quelldaten abgerufen, die innerhalb des Aktualisierungszeitraums verfügbar sind. Wenn das Aktualisierungsfenster beispielsweise drei Tage beträgt und Sie die Datenübertragung zum ersten Mal ausführen, ruft der BigQuery Data Transfer Service alle Quelldaten innerhalb von drei Tagen ab.

Aktualisierungsfenster sind dem API-Feld TransferConfig.data_refresh_window_days zugeordnet.

Wenn Sie Daten außerhalb des Aktualisierungszeitraums abrufen möchten, z. B. Verlaufsdaten, oder Daten nach Übertragungsausfällen oder -lücken wiederherstellen möchten, können Sie einen Backfill-Vorgang initiieren oder planen.

Hinweise

Prüfen Sie die folgenden Voraussetzungen und Informationen, bevor Sie eine Display & Video 360-Datenüertragung erstellen.

Vorbereitung

  • Überprüfen Sie, ob Sie alle erforderlichen Aktionen ausgeführt haben, damit Sie den BigQuery Data Transfer Service aktivieren können.
  • Erstellen Sie ein BigQuery-Dataset zum Speichern von Display & Video 360-Daten.
  • Sie benötigen entweder Ihre Partner-ID für Display & Video 360 oder Ihre Werbetreibenden-ID. Die Partner-ID ist in der Hierarchie übergeordnet.
  • Sie benötigen Leseberechtigungen, um über die Display and Video API auf Partner- oder Werbetreibendendaten zuzugreifen.

  • Ihre Organisation muss Zugriff auf Dateien von Display & Video 360 Data Transfer V2 (Display & Video 360 DTv2) haben. Diese Dateien werden vom Display & Video 360-Team in einem Cloud Storage-Bucket bereitgestellt. Wie Sie die Zugriffsberechtigungen für die Display & Video 360-DTv2-Dateien anfordern, hängt davon ab, ob Sie einen direkten Vertrag für Display & Video 360 haben. In beiden Fällen können zusätzliche Gebühren anfallen.

    • Wenn Sie einen Vertrag für Display & Video 360 haben, wenden Sie sich an den Display & Video 360-Support, um Display & Video 360-DTv2-Dateien einzurichten.
    • Wenn Sie keinen Vertrag für Display & Video 360 haben, wenden Sie sich an Ihre Agentur, um Zugriff auf Display & Video 360 DTv2-Dateien zu erhalten.
    • Nach der Ausführung dieses Schritts erhalten Sie einen der folgenden Cloud Storage-Bucket-Namen, je nachdem, ob Sie die Einrichtung eines Partners oder Werbetreibenden vornehmen:
      • gs://dcdt_-dbm_partnerPARTNER_ID
      • gs://dcdt_-dbm_advertiserADVERTISER_ID

  • Zum Einrichten von Benachrichtigungen über die Übertragungsausführung für Pub/Sub benötigen Sie die Berechtigungen pubsub.topics.setIamPolicy. Weitere Informationen finden Sie unter BigQuery Data Transfer Service-Ausführungsbenachrichtigungen

Display & Video 360-ID ermitteln

Gehen Sie zum Abrufen Ihrer Display & Video 360-ID in der Google Cloud Console zur Cloud Storage-Seite Buckets und prüfen Sie die Dateien in Ihrem Display & Video 360-Datenübertragungs-Cloud Storage-Bucket. Die Display & Video 360-ID wird zum Abgleich der Dateien im bereitgestellten Cloud Storage-Bucket verwendet. Die ID ist in den Dateinamen und nicht in den Cloud Storage-Bucket-Namen eingebettet. Beispiel:

  • In einer Datei mit dem Namen dbm_partner123_activity_* lautet die ID 123.
  • In einer Datei mit dem Namen dbm_advertiser567_activity_* lautet die ID 567.

Dateinamenpräfix suchen

In Ausnahmefällen können die Dateien in Ihrem Cloud Storage-Bucket benutzerdefinierte, nicht standardmäßige Dateinamen haben, die vom Serviceteam der Google Marketing Platform für Sie eingerichtet wurden. Beispiel:

In einer Datei namens dbm_partner123456custom_activity_* lautet das Präfix dbm_partner123456custom.

Unterstützung bei der Verwendung von Dateinamenpräfixen erhalten Sie vom Display & Video 360-Support.

Display & Video 360-Datenübertragung einrichten

Wählen Sie eine der folgenden Optionen aus:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Datenübertragungen auf.

    Zu „Datenübertragungen”

  2. Klicken Sie auf Übertragung erstellen.

  3. Führen Sie auf der Seite Übertragung erstellen die folgenden Schritte aus:

    • Wählen Sie im Abschnitt Quelltyp für (Quelle die Option Display & Video 360 aus.
    • Geben Sie im Abschnitt Konfigurationsname für Übertragung für Anzeigename einen Namen für die Datenübertragung ein. Der Übertragungsname kann ein beliebiger Wert sein, mit dem Sie die Übertragung identifizieren können, wenn Sie sie später ändern müssen.

  4. Im Abschnitt Zeitplanoptionen:

    • Wählen Sie entweder Jetzt starten oder Zum festgelegten Zeitpunkt starten aus und geben Sie ein Startdatum und eine Laufzeit an.
    • Wählen Sie für Wiederholungen eine Option aus, wie oft die Übertragung ausgeführt werden soll. Wenn Sie Tage auswählen, geben Sie eine gültige Zeit in UTC an.
      • Stunden
      • Tage
      • On demand

  5. Wählen Sie im Abschnitt Destination settings (Zieleinstellungen) im Menü Destination dataset (Ziel-Dataset) das Dataset aus, das Sie zum Speichern Ihrer Daten erstellt haben.

  6. Im Abschnitt Data source details (Details zur Datenquelle):

    • Geben Sie im Feld DV360 DTV2-Cloud Storage-Bucket den Cloud Storage-Bucket ein, der die Display & Video 360-DTV2-Dateien enthält. Wenn Sie diesen Bucket einrichten müssen, wenden Sie sich an den Display & Video 360-Support.
    • Geben Sie im Feld DV360-Partner-/Werbetreibenden-ID die Partner-ID oder die Werbetreibenden-ID ein.
    • (Optional) Im Abschnitt Notification options (Benachrichtigungsoptionen):
      • Klicken Sie auf den Umschalter, um E-Mail-Benachrichtigungen zu aktivieren. Wenn Sie diese Option aktivieren, erhält der Übertragungsadministrator eine E-Mail-Benachrichtigung, wenn ein Übertragungsvorgang fehlschlägt.
      • Klicken Sie auf die Ein-/Aus-Schaltfläche, um Pub/Sub-Benachrichtigungen zu aktivieren. Wählen Sie unter Cloud Pub/Sub-Thema auswählen den Namen des Themas aus oder klicken Sie auf Thema erstellen. Mit dieser Option werden Pub/Sub-Ausführungsbenachrichtigungen für Ihre Übertragung konfiguriert.

  7. Klicken Sie auf Speichern.

bq

Geben Sie den Befehl bq mk ein und geben Sie das Flag --transfer_config für die Übertragungserstellung an. Die folgenden Flags sind erforderlich:

  • --data_source
  • --target_dataset
  • --display_name
  • --params
  bq mk --transfer_config \
  --project_id=PROJECT_ID \
  --target_dataset=DATASET \
  --display_name=NAME \
  --params='PARAMETERS' \
  --data_source=DATA_SOURCE

Dabei gilt:

  • PROJECT_ID: Ihre Projekt-ID.
  • DATASET: Das Ziel-Dataset für die Datenübertragungskonfiguration.
  • NAME: Der Anzeigename für die Datenübertragungskonfiguration. Der Übertragungsname kann ein beliebiger Wert sein, mit dem Sie die Übertragung identifizieren können, wenn Sie sie später ändern müssen.
  • PARAMETERS enthält die Parameter für die erstellte Datenübertragungskonfiguration im JSON-Format. Beispiel: --params='{"param":"param_value"}'. Für Display & Video 360-Übertragungen sind die Parameter bucket und displayvideo_id erforderlich. Der Parameter file_name_prefix ist optional und wird nur für seltene, benutzerdefinierte Dateinamen verwendet.
  • DATA_SOURCE. Die Datenquelle – displayvideo.

Mit dem folgenden Befehl wird beispielsweise eine Display & Video 360-Datenübertragung mit dem Namen My Transfer erstellt. Dabei werden die Display & Video 360-ID 123456, der Cloud Storage-Bucket dcdt_-dbm_partner123456 und das Ziel-Dataset mydataset verwendet.

Die Datenübertragung wird im Standardprojekt erstellt:

  bq mk --transfer_config \
  --target_dataset=mydataset \
  --display_name='My Transfer' \
  --params='{"bucket":"dcdt_-dbm_partner123456","displayvideo_id": "123456","file_name_prefix":"YYY"}' \
  --data_source=displayvideo

Nachdem Sie den Befehl ausgeführt haben, erhalten Sie eine Meldung wie die Folgende:

[URL omitted] Please copy and paste the above URL into your web browser and follow the instructions to retrieve an authentication code.

Richten Sie sich nach der Anleitung in der Nachricht und fügen Sie den Authentifizierungscode in die Befehlszeile ein.

API

Verwenden Sie die Methode projects.locations.transferConfigs.create und geben Sie eine Instanz der Ressource TransferConfig an.

Daten abfragen

Bei der Übertragung Ihrer Daten in BigQuery werden die Daten in zeitpartitionierte Tabellen geschrieben. Weitere Informationen finden Sie unter Einführung in partitionierte Tabellen.

Wir empfehlen, die automatisch generierten Ansichten abzufragen, anstatt die Tabellen direkt abzufragen. Wenn Sie Ihre Tabellen jedoch direkt abfragen möchten, müssen Sie die Pseudospalte _PARTITIONTIME in Ihrer Abfrage verwenden. Weitere Informationen finden Sie unter Partitionierte Tabellen abfragen.