Search Ads 360-Übertragungen

Mit BigQuery Data Transfer Service für Search Ads 360 Connector können Sie wiederkehrende Ladejobs für Search Ads 360-Berichtsdaten automatisch planen und verwalten.

Unterstützte Berichte

BigQuery Data Transfer Service für Search Ads 360 unterstützt die Search Ads 360 Reporting API v0:

• Search Ads 360 v0-Berichte

Informationen darüber, wie Search Ads 360-Berichte in Tabellen und Ansichten von BigQuery Data Transfer Service umgewandelt werden, finden Sie unter Search Ads 360-Berichtstransformationen.

Berichtsoption	Support
Unterstützte API-Version	v0
Wiederholungshäufigkeit	Täglich zu der Zeit, zu der die Datenübertragung erstmalig erstellt wird (Standard) Sie können die Tageszeit konfigurieren.
Aktualisierungsfenster	Letzte 7 Tage (Standard) Bis zu 30 Tage konfigurierbar Snapshots von Match-Tables werden einmal täglich erstellt und in der Partition für das letzte Ausführungsdatum gespeichert. Match-Table-Snapshots werden nicht für Backfills oder für Tage aktualisiert, die über das Aktualisierungsfenster geladen werden.
Maximale Backfill-Dauer	Kein Limit
Anzahl der Kundennummern pro Verwaltungskonto	2.000 Der BigQuery Data Transfer Service unterstützt maximal 2.000 Kundennummern für jedes Search Ads 360-Verwaltungskonto.

Informationen zum Search Ads 360-Übertragungsleitfaden, der die alte Search Ads 360-Berichts-API verwendet, finden Sie unter Search Ads 360-Übertragungen (Veraltet).

Datenaufnahme aus Search Ads 360-Übertragungen

Wenn Sie Daten aus Search Ads 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.

Beschränkungen

• Die maximale Häufigkeit, mit der Sie eine Search Ads 360-Datenübertragung konfigurieren können, beträgt einmal alle 24 Stunden. Standardmäßig beginnt eine Übertragung zu dem Zeitpunkt, an dem Sie die Übertragung erstellen. Sie können die Startzeit der Datenübertragung jedoch beim Erstellen der Übertragung konfigurieren.
• Der BigQuery Data Transfer Service unterstützt keine inkrementellen Datenübertragungen während einer Search Ads 360-Übertragung. Wenn Sie ein Datum für eine Datenübertragung angeben, werden alle Daten übertragen, die für dieses Datum verfügbar sind.

Hinweise

Bevor Sie eine Search Ads 360-Datenübertragung erstellen:

• Ü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 Data Transfer Service-Dataset, um die Search Ads 360-Berichtsdaten zu speichern.
• Wenn Sie Benachrichtigungen über die Übertragungsausführung für Pub/Sub einrichten möchten, benötigen Sie die Berechtigungen pubsub.topics.setIamPolicy. Pub/Sub-Berechtigungen sind nicht erforderlich, wenn Sie nur E-Mail-Benachrichtigungen einrichten. Weitere Informationen finden Sie unter BigQuery Data Transfer Service-Ausführungsbenachrichtigungen.
• Aktivieren Sie den Zugriff auf die Search Ads 360 Reporting API in Ihrem Projekt.

Erforderliche Berechtigungen

Achten Sie darauf, dass der Nutzer, der die Datenübertragung erstellt, die folgenden Berechtigungen hat:

• BigQuery Data Transfer Service:

  • bigquery.transfers.update-Berechtigungen zum Erstellen der Datenübertragung
  • Die Berechtigungen bigquery.datasets.get und bigquery.datasets.update für das Ziel-Dataset

  Die vordefinierte IAM-Rolle bigquery.admin enthält die Berechtigungen bigquery.transfers.update, bigquery.datasets.update und bigquery.datasets.get. Weitere Informationen zu IAM-Rollen in BigQuery Data Transfer Service finden Sie in der Zugriffssteuerung.

• Google Cloud:

  • serviceusage.services.use-Berechtigungen, um Daten aus Search Ads 360 für das Projekt herunterzuladen.

  Die vordefinierten IAM-Rollen editor, owner und serviceusage.serviceUsageConsumer enthalten serviceusage.services.use-Berechtigungen. Weitere Informationen zu IAM-Rollen in Service Usage finden Sie unter Referenz zur Zugriffssteuerung.

• Search Ads 360:

  • Lesezugriff auf die Search Ads 360-Kundennummer oder das Verwaltungskonto, das in der Übertragungskonfiguration verwendet wird.

Search Ads 360-Datenübertragung erstellen

Zum Erstellen einer Datenübertragung für Search Ads 360-Berichte benötigen Sie entweder Ihre Search Ads 360-Kundennummer oder Ihr Verwaltungskonto. 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. Wählen Sie im Abschnitt Quelltyp für Quelle die Option Search Ads 360 aus.

4. Geben Sie im Abschnitt Transfer config name (Konfigurationsname für Übertragung) für Display name (Anzeigename) einen Namen wie My Transfer 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.

5. Im Abschnitt Zeitplanoptionen:

   • Wählen Sie für Wiederholungshäufigkeit 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
   • Wählen Sie gegebenenfalls Jetzt starten oder Zu festgelegter Zeit starten aus und geben Sie ein Startdatum und eine Laufzeit an.

6. Wählen Sie im Abschnitt Zieleinstellungen für Dataset das Dataset aus, das Sie zum Speichern Ihrer Daten erstellt haben.

   1. Im Abschnitt Data source details:

   2. Geben Sie als Kundennummer Ihre Search Ads 360-Kundennummer ein:

   3. Optional: Geben Sie sowohl eine Agentur-ID als auch eine Werbetreibenden-ID ein, um ID-Zuordnungstabellen abzurufen.

   4. Optional: Geben Sie im Feld Benutzerdefinierte Floodlight-Variablen alle benutzerdefinierten Floodlight-Variablen ein, die in die Datenübertragung eingeschlossen werden sollen. Die Inhaber der benutzerdefinierten Floodlight-Variablen müssen das Search Ads 360-Konto sein, das in der Übertragungskonfiguration durch die Kundennummer angegeben ist. Dieser Parameter akzeptiert Stringeingaben im JSON-Array-Format und kann mehrere benutzerdefinierte Floodlight-Variablen unterstützen. Für jedes Element des JSON-Arrays sind die folgenden Parameter erforderlich:

      • id: die numerische ID der benutzerdefinierten Floodlight-Variablen. Diese ID wird zugewiesen, wenn eine benutzerdefinierte Floodlight-Variable in Search Ads 360 erstellt wird. Wenn Sie eine id angegeben haben, ist kein name erforderlich.
      • name: Der benutzerdefinierte Name der benutzerdefinierten Floodlight-Variablen in Search Ads 360. Wenn Sie eine name angegeben haben, ist kein id erforderlich.
      • cfv_field_name: Der genaue Feldname der benutzerdefinierten Floodlight-Variablen, der auf Ihrem Anwendungsfall basiert. Die unterstützten Werte sind conversion_custom_metrics, conversion_custom_dimensions, raw_event_conversion_metrics und raw_event_conversion_dimensions.
      • destination_table_name: Eine Liste von BigQuery-Tabellen, in denen die benutzerdefinierten Floodlight-Variablen enthalten sein sollen. Wenn der BigQuery Data Transfer Service Daten für diese Tabellen abruft, werden die benutzerdefinierten Floodlight-Variablen in die Abfrage aufgenommen.

      • bigquery_column_name_suffix: der benutzerdefinierte freundliche Spaltenname. Der BigQuery Data Transfer Service hängt das Suffix an den Standardfeldnamen an, um verschiedene benutzerdefinierte Floodlight-Variablen zu unterscheiden. Je nach Anwendungsfall generiert der BigQuery Data Transfer Service einen BigQuery-Spaltennamen folgendermaßen:

        	Benutzerdefinierte Floodlight-Variablen als Messwerte und Segmente	Benutzerdefinierte Floodlight-Variablen als Rohereignisattribute in der Conversion-Ressource
        metrics	metrics_conversion_custom_metrics_bigquery_column_name_suffix	metrics_raw_event_conversion_metrics_bigquery_column_name_suffix
        dimension	segments_conversion_custom_dimensions_bigquery_column_name_suffix	segments_raw_event_conversion_dimensions_bigquery_column_name_suffix

      Das folgende Beispiel zeigt einen Eintrag für eine benutzerdefinierte Floodlight-Variable, über die zwei benutzerdefinierte Floodlight-Variablen angegeben werden:

      [{
        "id": "1234",
        "cfv_field_name": "raw_event_conversion_metrics",
        "destination_table_name": ["Conversion"],
        "bigquery_column_name_suffix": "suffix1"
      },{
        "name": "example name",
        "cfv_field_name": "conversion_custom_metrics",
        "destination_table_name": ["AdGroupConversionActionAndDeviceStats","CampaignConversionActionAndDeviceStats"],
        "bigquery_column_name_suffix": "suffix2"
      }]

   5. Optional: Geben Sie im Feld Benutzerdefinierte Spalten alle benutzerdefinierten Spalten ein, die in die Datenübertragung eingeschlossen werden sollen. Die benutzerdefinierten Spalten müssen dem Search Ads 360-Konto gehören, das in der Übertragungskonfiguration durch die Kundennummer angegeben ist. Dieses Feld akzeptiert Stringeingaben im JSON-Array-Format und kann mehrere Spalten unterstützen. Für jedes Element des JSON-Arrays sind die folgenden Parameter erforderlich:

      • id: Die numerische ID der benutzerdefinierten Spalte. Diese ID wird zugewiesen, wenn eine benutzerdefinierte Spalte erstellt wird. Wenn Sie eine id angegeben haben, ist kein name erforderlich.
      • name: der benutzerdefinierte Name der benutzerdefinierten Spalte in Search Ads 360. Wenn Sie eine name angegeben haben, ist kein id erforderlich.
      • destination_table_name: Eine Liste der BigQuery-Tabellen, in denen die benutzerdefinierte Spalte enthalten sein soll. Wenn der BigQuery Data Transfer Service Daten für diese Tabellen abruft, wird das benutzerdefinierte Spaltenfeld in die Abfrage aufgenommen.
      • bigquery_column_name: der benutzerdefinierte freundliche Spaltenname. Das ist der Feldname der benutzerdefinierten Spalte in den in destination_table_name angegebenen Zieltabellen. Der Spaltenname muss den Formatanforderungen für BigQuery-Spaltennamen entsprechen und darf für andere Felder im Standardschema der Tabelle oder in anderen benutzerdefinierten Spalten nur einmal vorkommen.

      Das folgende Beispiel zeigt einen beispielhaften Eintrag für benutzerdefinierte Spalten, der zwei benutzerdefinierte Spalten angibt:

        [{
          "id": "1234",
          "destination_table_name": ["Conversion"],
          "bigquery_column_name": "column1"
        },{
          "name": "example name",
          "destination_table_name": ["AdGroupStats","CampaignStats"],
          "bigquery_column_name": "column2"
        }]
        

   6. Optional: Geben Sie im Feld Tabellenfilter eine durch Kommas getrennte Liste der Tabellen ein, die Sie einbeziehen möchten, z. B. Campaign, AdGroup. Stellen Sie dieser Liste das Zeichen - voran, um bestimmte Tabellen auszuschließen, z. B. -Campaign, AdGroup. Alle Tabellen werden standardmäßig einbezogen.

   7. Optional: Geben Sie für Fenster aktualisieren eine Zahl zwischen 1 und 30 ein. Wenn nicht festgelegt, beträgt das Aktualisierungsfenster standardmäßig 7 Tage.

7. Wählen Sie im Menü Dienstkonto ein Dienstkonto aus den Dienstkonten aus, die mit Ihrem Google Cloud-Projekt verknüpft sind. Sie können Ihre Übertragung mit einem Dienstkonto verknüpfen, anstatt Ihre Nutzeranmeldedaten zu verwenden. Weitere Informationen zur Verwendung von Dienstkonten mit Datenübertragungen finden Sie unter Dienstkonten verwenden.

   • Wenn Sie sich mit einer föderierten Identität angemeldet haben, ist ein Dienstkonto zum Erstellen einer Übertragung erforderlich. Wenn Sie sich mit einem Google-Konto angemeldet haben, ist ein Dienstkonto für die Übertragung optional.
   • Das Dienstkonto muss die erforderlichen Berechtigungen haben.

8. Optional: Im Abschnitt 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.

9. 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 ebenfalls erforderlich:

• --data_source
• --target_dataset
• --display_name
• --params

Die folgenden Flags sind optional:

• --project_id: Gibt an, welches Projekt verwendet werden soll. Wenn das Flag nicht angegeben ist, wird das Standardprojekt verwendet.
• --service_account_name: Gibt ein Dienstkonto an, das für die Übertragungsauthentifizierung in Search Ads 360 anstelle Ihres Nutzerkontos verwendet werden soll.

bq mk \
--transfer_config \
--project_id=PROJECT_ID \
--target_dataset=DATASET \
--display_name=NAME \
--data_source=DATA_SOURCE \
--service_account_name=SERVICE_ACCOUNT_NAME \
--params='{PARAMETERS,"custom_columns":"[{\"id\": \"CC_ID\",\"destination_table_name\": [\"CC_DESTINATION_TABLE\"],\"bigquery_column_name\": \"CC_COLUMN\"}]","custom_floodlight_variables":"[{\"id\": \"CFV_ID\",\"cfv_field_name\": [\"CFV_FIELD_NAME\"],\"destination_table_name\": [\"CFV_DESTINATION_TABLE\"],\"bigquery_column_name_suffix\": \"CFV_COLUMN_SUFFIX\"}]"}'

Dabei gilt:

• PROJECT_ID (optional): Gibt an, welches Projekt verwendet werden soll. Wenn das Flag nicht angegeben ist, wird das Standardprojekt verwendet.
• DATASET: Das Ziel-Dataset für die Übertragungskonfiguration.

• NAME: Der Anzeigename für die Übertragungskonfiguration. Der Datenübertragungsname kann ein beliebiger Wert sein, mit dem Sie die Übertragung identifizieren können, wenn Sie sie später ändern müssen.

• DATA_SOURCE. Die Datenquelle – search_ads.

• SERVICE_ACCOUNT_NAME (Optional): der Name des Dienstkontos, der zur Authentifizierung der Datenübertragung verwendet wird. Das Dienstkonto sollte zum selben project_id gehören, das für die Erstellung der Übertragung verwendet wurde, und sollte alle erforderlichen Berechtigungen haben.

• PARAMETERS: die Parameter für die erstellte Übertragungskonfiguration im JSON-Format. Beispiel: --params='{"param":"param_value"}'. Sie müssen den Parameter customer_id angeben.

  • table_filter: Gibt an, welche Tabellen in die Datenübertragung einbezogen werden sollen. Wenn das Flag nicht angegeben ist, werden alle Tabellen einbezogen. Wenn Sie nur bestimmte Tabellen einbeziehen möchten, verwenden Sie eine durch Kommas getrennte Liste von Werten (z. B. Ad, Campaign, AdGroup). Wenn Sie bestimmte Tabellen ausschließen möchten, stellen Sie den auszuschließenden Werten einen Bindestrich (-) voran. Wenn Sie beispielsweise -Ad, Campaign, AdGroup verwenden, werden alle drei Werte ausgeschlossen.
  • custom_columns: Hiermit werden benutzerdefinierte Spalten für Ihre Berichte angegeben. Dieser Parameter akzeptiert Stringeingaben im JSON-Array-Format und kann mehrere Spalten unterstützen. Für jedes Element des JSON-Arrays sind die folgenden Parameter erforderlich:
    • CC_ID: Die numerische ID der benutzerdefinierten Spalte. Diese ID wird zugewiesen, wenn eine benutzerdefinierte Spalte erstellt wird.
    • CC_DESTINATION_TABLE: Eine Liste der BigQuery-Tabellen, in denen die benutzerdefinierte Spalte enthalten sein soll. Wenn der BigQuery Data Transfer Service Daten für diese Tabellen abruft, enthält die Datenübertragung das Feld für benutzerdefinierte Spalten in der Abfrage.
    • CC_COLUMN: der benutzerdefinierte freundliche Spaltenname. Das ist der Feldname der benutzerdefinierten Spalte in den in destination_table_name angegebenen Zieltabellen. Der Spaltenname muss den Formatanforderungen für BigQuery-Spaltennamen entsprechen und darf für andere Felder im Standardschema der Tabelle oder in anderen benutzerdefinierten Spalten nur einmal vorkommen.
  • custom_floodlight_variables: Gibt benutzerdefinierte Floodlight-Variablen in der Übertragung an. Dieser Parameter akzeptiert Stringeingaben im JSON-Array-Format und kann mehrere benutzerdefinierte Floodlight-Variablen unterstützen. Für jedes Element des JSON-Arrays sind die folgenden Parameter erforderlich:
    • CFV_ID: die numerische ID der benutzerdefinierten Floodlight-Variablen. Diese ID wird zugewiesen, wenn eine benutzerdefinierte Floodlight-Variable in Search Ads 360 erstellt wird.
    • CFV_FIELD_NAME: Der genaue Name des Felds für die benutzerdefinierte Floodlight-Variable, der auf Ihrem Anwendungsfall basiert. Die unterstützten Werte sind conversion_custom_metrics, conversion_custom_dimensions, raw_event_conversion_metrics und raw_event_conversion_dimensions. Weitere Informationen finden Sie unter Benutzerdefinierte Floodlight-Messwerte.
    • CFV_DESTINATION_TABLE: Eine Liste von BigQuery-Tabellen, in die die benutzerdefinierten Floodlight-Variablen aufgenommen werden sollen. Wenn der BigQuery Data Transfer Service Daten für diese Tabellen abruft, werden die benutzerdefinierten Floodlight-Variablen in die Abfrage aufgenommen.
    • CFV_COLUMN_SUFFIX: der benutzerdefinierte freundliche Spaltenname. Der BigQuery Data Transfer Service hängt das Suffix an den Standardfeldnamen an, um verschiedene benutzerdefinierte Floodlight-Variablen zu unterscheiden. Je nach Anwendungsfall generiert der BigQuery Data Transfer Service einen BigQuery-Spaltennamen auf folgende Weise:

  	Benutzerdefinierte Floodlight-Variablen als Messwerte und Segmente	Benutzerdefinierte Floodlight-Variablen als Rohereignisattribute in der Conversion-Ressource
  metrics	metrics_conversion_custom_metrics_bigquery_column_name_suffix	metrics_raw_event_conversion_metrics_bigquery_column_name_suffix
  dimension	segments_conversion_custom_dimensions_bigquery_column_name_suffix	segments_raw_event_conversion_dimensions_bigquery_column_name_suffix

Achtung: Sie können keine Benachrichtigungen mit dem Befehlszeilentool konfigurieren.

Mit dem folgenden Befehl wird beispielsweise eine Search Ads 360-Datenübertragung mit dem Namen My Transfer unter der Kundennummer 6828088731 und dem Ziel-Dataset mydataset erstellt. Bei der Übertragung wird auch eine benutzerdefinierte Floodlight-Variable angegeben. Die Datenübertragung wird im Standardprojekt erstellt:

bq mk \
--transfer_config \
--target_dataset=mydataset \
--display_name='My Transfer' \
--data_source=search_ads \
--params='{"customer_id":"6828088731", "custom_floodlight_variables":"[{\"id\": \"9876\", \"cfv_field_name\": \"raw_event_conversion_metrics\", \"destination_table_name\": [\"Conversion\"],\"bigquery_column_name_suffix\": \"suffix1\" }]"}'

Wenn Sie den Befehl zum ersten Mal ausführen, erhalten Sie eine Nachricht 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.

Achtung: Wenn Sie eine Search Ads 360-Datenübertragung mit dem Befehlszeilentool erstellen, wird die Übertragungskonfiguration mit den Standardwerten für Zeitplan (alle 24 Stunden bei der Erstellung) und Aktualisierungsfenster (0 – konfiguriert das Standard-Aktualisierungsfenster von 7 Tagen) eingerichtet.

API

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

Search Ads 360-Übertragung manuell auslösen

Wenn Sie für Search Ads 360 manuell eine Übertragung auslösen, werden einmal täglich Snapshots von Match-Tables erstellt und in der Partition für das letzte Ausführungsdatum gespeichert. Wenn Sie eine manuelle Übertragung auslösen, werden Match-Table-Snapshots für die folgenden Tabellen nicht aktualisiert:

• Konto
• Anzeige
• AdGroup
• AdGroupCriterion
• Beliebige ID-Zuordnungstabelle
• Asset
• BidStrategy
• Kampagne
• CampaignCriterion
• ConversionAction
• Keyword
• NegativeAdGroupKeyword
• NegativeAdGroupCriterion
• NegativeCampaignKeyword
• NegativeCampaignCriterion
• ProductGroup

Unterstützung für Search Ads 360-Verwaltungskonten

Die Verwendung von Search Ads 360-Verwaltungskonten bietet im Vergleich zur Verwendung einzelner Kundennummern mehrere Vorteile.

• Sie müssen nicht mehrere Datenübertragungen verwalten, um Berichte für mehrere Kundennummern zu erstellen.
• Kundenübergreifende Abfragen lassen sich einfacher schreiben, da alle Kundennummern in derselben Tabelle gespeichert sind.
• Durch die Verwendung von Verwaltungskonten werden Probleme mit dem Ladekontingent von BigQuery Data Transfer Service behoben, da mehrere Kundennummern in einem Auftrag geladen werden.

Für Bestandskunden, die mehrere kundennummerspezifische Search Ads 360-Datenübertragungen haben, empfehlen wir, stattdessen zu einem Search Ads 360-Verwaltungskonto zu wechseln. Sie können dazu so vorgehen:

1. Richten Sie eine einzelne Search Ads 360-Datenübertragung auf Verwaltungskonto- oder untergeordneter Verwaltungskontoebene ein.
2. Planen Sie einen Backfill.
3. Deaktivieren Sie einzelne Kundennummer-spezifische Search Ads 360-Übertragungen.

Weitere Informationen zu Search Ads 360-Verwaltungskonten finden Sie unter Verwaltungskonten in der neuen Search Ads 360-Version und Konten mit Ihrem Verwaltungskonto verknüpfen.

Hinweis: BigQuery Data Transfer Service ruft Berichte für alle aufgeführten Kundennummern ab. In den Berichten werden aber möglicherweise keine Kundennummern angezeigt, wenn für den angeforderten Tag keine Aktivitäten gemeldet werden.

Beispiel

Die folgende Liste enthält die Kundennummern, die mit bestimmten Search Ads 360-Verwaltungskonten verknüpft sind.

• 1234567890 – Stammverwaltungskonto
  • 1234 – untergeordnetes Verwaltungskonto
    • 1111 – Kundennummer
    • 2222 – Kundennummer
    • 3333 – Kundennummer
    • 4444 – Kundennummer
    • 567 – untergeordnetes Verwaltungskonto
      • 5555 – Kundennummer
      • 6666 – Kundennummer
      • 7777 – Kundennummer
  • 89 – untergeordnetes Verwaltungskonto
    • 8888 – Kundennummer
    • 9999 – Kundennummer
  • 0000 – Kundennummer

In allen Berichten wird jede Kundennummer angezeigt, die mit einem Verwaltungskonto verknüpft ist. Weitere Informationen zur Berichtsstruktur von Search Ads 360 in BigQuery Data Transfer Service finden Sie unter Umwandlung von Search Ads 360-Berichten.

Übertragungskonfiguration für Kundennummer 1234567890

Durch eine Übertragungskonfiguration für das Stammverwaltungskonto (Kundennummer 1234567890) werden Datenübertragungsausführungen generiert, die die folgenden Kundennummern einschließen:

• 1111 (über untergeordnetes Verwaltungskonto 1234)
• 2222 (über untergeordnetes Verwaltungskonto 1234)
• 3333 (über untergeordnetes Verwaltungskonto 1234)
• 4444 (über untergeordnetes Verwaltungskonto 1234)
• 5555 (über untergeordnetes Verwaltungskonto 567 und untergeordnetes Verwaltungskonto 1234)
• 6666 (über untergeordnetes Verwaltungskonto 567 und untergeordnetes Verwaltungskonto 1234)
• 7777 (über untergeordnetes Verwaltungskonto 567 und untergeordnetes Verwaltungskonto 1234)
• 8888 (über untergeordnetes Verwaltungskonto 89)
• 9999 (über untergeordnetes Verwaltungskonto 89)
• 0000 (individuelle Kundennummer)

Übertragungskonfiguration für Kundennummer 1234

Durch eine Übertragungskonfiguration für das untergeordnete Verwaltungskonto 123 (Kundennummer 567) werden Datenübertragungsausführungen generiert, die die folgenden Kundennummern einschließen:

• 1111
• 2222
• 3333
• 4444
• 5555 (über untergeordnetes Verwaltungskonto 567)
• 6666 (über untergeordnetes Verwaltungskonto 567)
• 7777 (über untergeordnetes Verwaltungskonto 567)

Übertragungskonfiguration für Kundennummer 567

Durch eine Übertragungskonfiguration für das untergeordnete Verwaltungskonto 567 (Kundennummer 567) werden Datenübertragungsausführungen generiert, die die folgenden Kundennummern einschließen:

• 5555
• 6666
• 7777

Übertragungskonfiguration für Kundennummer 89

Durch eine Übertragungskonfiguration für das untergeordnete Verwaltungskonto 89 (Kundennummer 89) werden Datenübertragungsausführungen generiert, die die folgenden Kundennummern einschließen:

• 8888
• 9999

Übertragungskonfiguration für Kundennummer 0000

Durch eine Übertragungskonfiguration für die Kundennummer 0000 werden Datenübertragungsausführungen generiert, die nur die einzelne Kundennummer enthalten:

• 0000

Daten abfragen

Beim Übertragen von Daten an BigQuery Data Transfer Service werden die Daten in nach Aufnahmezeit partitionierte Tabellen geschrieben. Weitere Informationen finden Sie unter Einführung in partitionierte Tabellen.

Wenn Sie die Tabellen direkt abfragen, anstatt die automatisch generierten Ansichten zu verwenden, müssen Sie in der Abfrage die Pseudospalte _PARTITIONTIME verwenden. Weitere Informationen finden Sie unter Partitionierte Tabellen abfragen.

Beispielabfragen für Search Ads 360

Mithilfe der folgenden Beispielabfragen für Search Ads 360 können Sie Ihre übertragenen Daten analysieren. Sie können die Abfragen auch in einem Visualisierungstool wie Looker Studio aufrufen.

Die folgenden Abfragen sind Beispiele für den Einstieg in die Abfrage Ihrer Search Ads 360-Daten mit BigQuery Data Transfer Service. Wenn Sie weitere Fragen dazu haben, wie Sie diese Berichte nutzen können, wenden Sie sich an einen technischen Mitarbeiter von Search Ads 360.

Wenn Sie die Tabellen direkt abfragen, anstatt die automatisch generierten Ansichten zu verwenden, müssen Sie in der Abfrage die Pseudospalte _PARTITIONTIME verwenden. Weitere Informationen finden Sie unter Partitionierte Tabellen abfragen.

Kampagnenleistung

Die folgende Beispielabfrage analysiert die Search Ads 360-Kampagnenleistung der letzten 30 Tage.

SELECT
  c.customer_id,
  c.campaign_name,
  c.campaign_status,
  SUM(cs.metrics_clicks) AS Clicks,
  (SUM(cs.metrics_cost_micros) / 1000000) AS Cost,
  SUM(cs.metrics_impressions) AS Impressions
FROM
  `DATASET.sa_Campaign_CUSTOMER_ID` c
LEFT JOIN
  `DATASET.sa_CampaignStats_CUSTOMER_ID` cs
ON
  (c.campaign_id = cs.campaign_id
  AND cs._DATA_DATE BETWEEN
  DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) AND DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY))
WHERE
  c._DATA_DATE = c._LATEST_DATE
GROUP BY
  1, 2, 3
ORDER BY
  Impressions DESC

Ersetzen Sie Folgendes:

• DATASET: der Name des Datasets
• CUSTOMER_ID: die Search Ads 360-Kundennummer

Anzahl Keywords

Die folgende Beispielabfrage analysiert die Keywords unter Berücksichtigung der Kampagne, Anzeigengruppe und des Keyword-Status.

  SELECT
    c.campaign_status AS CampaignStatus,
    a.ad_group_status AS AdGroupStatus,
    k.ad_group_criterion_status AS KeywordStatus,
    k.ad_group_criterion_keyword_match_type AS KeywordMatchType,
    COUNT(*) AS count
  FROM
    `DATASET.sa_Keyword_CUSTOMER_ID` k
    JOIN
    `DATASET.sa_Campaign_CUSTOMER_ID` c
  ON
    (k.campaign_id = c.campaign_id AND k._DATA_DATE = c._DATA_DATE)
  JOIN
    `DATASET.sa_AdGroup_CUSTOMER_ID` a
  ON
    (k.ad_group_id = a.ad_group_id AND k._DATA_DATE = a._DATA_DATE)
  WHERE
    k._DATA_DATE = k._LATEST_DATE
  GROUP BY
    1, 2, 3, 4

Ersetzen Sie Folgendes:

• DATASET: der Name des Datasets
• CUSTOMER_ID: die Search Ads 360-Kundennummer

ID-Zuordnungstabellen

Entitäten in der neuen Search Ads 360-Version, z. B. Kunden, Kampagnen und Anzeigengruppen, haben einen anderen ID-Bereich als die alte Search Ads 360-Version. Bestehende Search Ads 360-Übertragungsnutzer, die Daten aus der alten Search Ads 360-Version mit der neuen Search Ads 360 API kombinieren möchten, können mit dem BigQuery Data Transfer Service die ID-Zuordnungstabellen übertragen, wenn Sie Folgendes tun: Geben Sie in der Übertragungskonfiguration eine gültige Agentur-ID und eine Werbetreibenden-ID an.

Unterstützte Entitäten enthalten zwei Spalten, legacy_id und new_id, die die ID-Zuordnung für Entitäten in alten und neuen Versionen von Search Ads 360 angeben. Für die Entitäten „AD“, „CAMPAIGN_CRITERION“ und „CRITERION“ wird ebenfalls eine new_secondary_id angegeben, da diese Entitäten in der neuen Search Ads 360-Version keine global eindeutigen IDs haben. Im Folgenden finden Sie eine Liste von ID-Zuordnungstabellen.

• IdMapping_AD
• IdMapping_AD_GROUP
• IdMapping_CAMPAIGN
• IdMapping_CAMPAIGN_CRITERION
• IdMapping_CAMPAIGN_GROUP
• IdMapping_CAMPAIGN_GROUP_PERFORMANCE_TARGET
• IdMapping_CRITERION
• IdMapping_CUSTOMER
• IdMapping_FEED_ITEM
• IdMapping_FEED_TABLE

Hinweis: Ähnlich wie bei den Match-Tables werden Snapshots der ID-Zuordnungstabellen einmal täglich erstellt und in der Partition für das letzte Ausführungsdatum gespeichert. Snapshots der ID-Zuordnungstabelle werden nicht für Backfills oder für Tage aktualisiert, die über das Aktualisierungsfenster geladen werden.

Beispielabfragen

Die folgende Abfrage verwendet ID-Zuordnungstabellen, um Messwerte pro Kampagne für Tabellen aus vorherigen und neuen Search Ads 360-Datenübertragungen im neuen ID-Bereich zu aggregieren.

SELECT CustomerID, CampaignID, Sum(Clicks), Sum(Cost) FROM
(SELECT
  cs.customer_id AS CustomerID,
  cs.campaign_id AS CampaignID,
  cs.metrics_clicks AS Clicks,
  cs.metrics_cost_micros / 1000000 AS Cost
FROM
  `DATASET.sa_CampaignStats_CUSTOMER_ID` cs
WHERE cs._DATA_DATE = 'NEW_DATA_DATE'
UNION ALL
SELECT
  customer_id_mapping.new_id AS CustomerID,
  campaign_id_mapping.new_id AS CampaignID,
  cs.clicks AS Clicks,
  cs.cost AS Cost
FROM
  `DATASET.CampaignStats_ADVERTISER_ID` cs
LEFT JOIN
  `DATASET.IdMapping_CUSTOMER_ADVERTISER_ID` customer_id_mapping
ON cs.accountId = customer_id_mapping.legacy_id
LEFT JOIN
  `DATASET.IdMapping_CAMPAIGN_ADVERTISER_ID` campaign_id_mapping
ON cs.campaignId = campaign_id_mapping.legacy_id
WHERE cs._DATA_DATE = 'OLD_DATA_DATE')
GROUP BY
1, 2
ORDER BY
1, 2

Ersetzen Sie Folgendes:

• DATASET: der Name des Datasets
• CUSTOMER_ID: die Search Ads 360-Kundennummer
• ADVERTISER_ID: die Search Ads 360-Werbetreibenden-ID
• NEW_DATA_DATE: das Datendatum für die neue Search Ads 360-Tabelle
• OLD_DATA_DATE: das Datendatum für die vorherige Search Ads 360-Tabelle

Die folgende Abfrage verwendet ID-Zuordnungstabellen, um Messwerte pro Kampagne für Tabellen aus vorherigen und neuen Search Ads 360-Datenübertragungen im alten ID-Bereich zu aggregieren.

SELECT CustomerID, CampaignID, Sum(Clicks), Sum(Cost) FROM
(SELECT
  customer_id_mapping.legacy_id AS CustomerID,
  campaign_id_mapping.legacy_id AS CampaignID,
  cs.metrics_clicks AS Clicks,
  cs.metrics_cost_micros / 1000000 AS Cost
FROM
  `DATASET.sa_CampaignStats_CUSTOMER_ID` cs
LEFT JOIN
  `DATASET.IdMapping_CUSTOMER_ADVERTISER_ID` customer_id_mapping
ON cs.customer_id = customer_id_mapping.new_id
LEFT JOIN
  `DATASET.IdMapping_CAMPAIGN_ADVERTISER_ID` campaign_id_mapping
ON cs.campaign_id = campaign_id_mapping.new_id
WHERE cs._DATA_DATE = 'NEW_DATA_DATE'
UNION ALL
SELECT
  CAST(accountId AS INT) AS CustomerID,
  CAST(campaignId AS INT) AS CampaignID,
  cs.clicks AS Clicks,
  cs.cost AS Cost
FROM
  `DATASET.CampaignStats_ADVERTISER_ID` cs
WHERE cs._DATA_DATE = 'OLD_DATA_DATE')
GROUP BY
1, 2
ORDER BY
1, 2

Ersetzen Sie Folgendes:

• DATASET: der Name des Datasets
• CUSTOMER_ID: die Search Ads 360-Kundennummer
• ADVERTISER_ID: die Search Ads 360-Werbetreibenden-ID
• NEW_DATA_DATE: das Datendatum für die neue Search Ads 360-Tabelle
• OLD_DATA_DATE: das Datendatum für die vorherige Search Ads 360-Tabelle

Potenzielle Kontingentprobleme

Die Search Ads 360 Reporting API weist ein tägliches Kontingent für die Anzahl der Anfragen zu, die vom Google-Projekt gesendet werden können. Wenn Sie ein Projekt für den BigQuery Data Transfer Service und andere Dienste verwenden, haben alle Dienste das gleiche Kontingent und können möglicherweise das Kontingentlimit in jedem Dienst erreichen.

Beachten Sie folgende Optionen, um dieses potenzielle Problem zu vermeiden, ohne vorhandene Workflows zu beeinträchtigen:

• Richten Sie ein separates Projekt für BigQuery Data Transfer Service ein. Ein projektübergreifender Tabellen-Join könnte so aussehen:

    #standardSQL
    select count(a.item1)
    from (select item1, item2 from project-A.data_set_a.table_name_a) a
    inner join
    (select item3, item4 from project-B.data_set_b.table_name_b) b
    on a.item1 = b.item3

• Wenden Sie sich an den Search Ads 360-Support, um zusätzliche Kontingente anzufordern.