Display & Video 360-Übertragung planen

Mit BigQuery Data Transfer Service für Display & Video 360 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
Zeitplan

Täglich zu der Zeit, zu der die Ü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:

Hinweise

Prüfen Sie die folgenden Voraussetzungen und Informationen, bevor Sie eine Display & Video 360-Übertragung 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. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

    BigQuery aufrufen

  2. Klicken Sie im BigQuery-Navigationsmenü auf Datenübertragungen.

  3. Klicken Sie auf Übertragung erstellen.

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

    • Wählen Sie im Abschnitt Source type (Quelltyp) für Source (Quelle) die Option Display & Video 360 – Vorschau aus.
    • Geben Sie im Abschnitt Konfigurationsname für Übertragung für Anzeigename einen Namen für die Ü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.

  5. 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 Repeats (Wiederholungen) eine Option aus, um festzulegen, 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

  6. 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.

  7. Im Abschnitt Data source details:

    • Geben Sie im Feld Display & Video 360-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.

  8. 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

Wobei:

  • PROJECT_ID ist Ihre Projekt-ID.
  • DATASET: Das Ziel-Dataset für die Übertragungskonfiguration.
  • NAME: Der Anzeigename für die Ü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: die Parameter für die erstellte Ü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-Ü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 Ü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.