Facebook Ads-Daten in BigQuery laden

Wenn Sie wiederkehrende Datenübertragungen von Facebook Ads zu BigQuery planen möchten, erstellen Sie eine Übertragungskonfiguration, um festzulegen, welche Datenobjekte übertragen werden sollen und wie oft die Datenübertragung geplant werden soll. Sie können eine Übertragungskonfiguration mit der Google Cloud Console, dem bq-Befehlszeilentool oder der BigQuery Data Transfer Service API erstellen. Nachdem Sie die Übertragungskonfiguration eingerichtet haben, überträgt BigQuery Data Transfer Service die neuesten Daten gemäß dem angegebenen Zeitplan in eine BigQuery-Tabelle.

Informationen zur Funktionsweise einer Facebook Ads-Übertragung finden Sie unter Einführung in Facebook Ads-Datenübertragungen.

Beschränkungen

Facebook Ads-Datenübertragungen unterliegen den folgenden Einschränkungen:

• Ab dem 6. Juli 2026 wird die Unterstützung für den Bericht AdInsightsMMM vorübergehend deaktiviert. Weitere Informationen finden Sie unter 6. Juli 2026.
• Das Mindestintervall zwischen wiederkehrenden Facebook Ads-Datenübertragungen beträgt 24 Stunden. Das Standardintervall für eine wiederkehrende Datenübertragung beträgt 24 Stunden.
• Der BigQuery Data Transfer Service für Facebook Ads unterstützt nur einen festen Satz von Tabellen. Benutzerdefinierte Berichte werden nicht unterstützt.
• Facebook Ads-Datenübertragungen haben eine maximale Dauer von sechs Stunden. Eine Übertragung schlägt fehl, wenn sie länger als diese maximale Dauer dauert.
• Inkrementelle Übertragungen werden für AdInsights-, AdInsightsActions-, Ads-, Campaigns- und AdSets-Tabellen nicht unterstützt. Wenn Sie eine Datenübertragung erstellen, die die Tabellen AdInsights, AdInsightsActions, Ads, Campaigns und AdSets enthält, und Sie unter Zeitplanoptionen ein Datum angegeben haben, werden alle Daten übertragen, die für dieses Datum verfügbar sind.
• Der BigQuery Data Transfer Service unterstützt ein Aktualisierungsfenster von bis zu 30 Tagen für die Tabellen AdInsights, AdInsightsActions, Ads, Campaigns und AdSets. Das Aktualisierungsfenster gibt an, für wie viele Tage eine Datenübertragung Quelldaten abruft. Wenn Sie eine Datenübertragung zum ersten Mal ausführen, werden alle Quelldaten abgerufen, die innerhalb des Aktualisierungszeitraums verfügbar sind.

• Das langlebige Nutzer-Zugriffstoken, das für Facebook Ads-Übertragungen erforderlich ist, läuft nach 60 Tagen ab.

  Wenn Ihr langlebiges Nutzerzugriffstoken abgelaufen ist, können Sie ein neues abrufen. Rufen Sie dazu die Details zur Datenübertragung auf und klicken Sie auf Bearbeiten. Führen Sie auf der Seite „Übertragung bearbeiten“ dieselben Schritte wie unter Voraussetzungen für Facebook Ads aus, um ein neues langlebiges Nutzerzugriffstoken zu generieren.

• Wenn Sie einen Netzwerkanhang mit dieser Datenübertragung verwenden möchten, müssen Sie zuerst einen Netzwerkanhang erstellen, indem Sie eine statische IP-Adresse definieren.

• Wenn Ihr Netzwerkanhang in einem Google Cloud -Projekt erstellt wurde, das sich vom Google Cloud -Projekt der Datenübertragung unterscheidet, müssen Sie dem Dienst-Agent, der zum Google Cloud -Projekt gehört, in dem die Datenübertragung erstellt wurde, die Berechtigungen compute.networkAttachments.get und compute.networkAttachments.update gewähren.

• Wenn sich der konfigurierte Netzwerkanhang und die VM-Instanz in verschiedenen Regionen befinden, kann es beim Übertragen von Daten aus Facebook Ads zu regionsübergreifenden Datenverschiebungen kommen.

Hinweis

In den folgenden Abschnitten werden die Schritte beschrieben, die Sie vor dem Erstellen einer Facebook Ads-Datenübertragung ausführen müssen.

Voraussetzungen für Facebook-Anzeigen

Beim Erstellen einer Facebook Ads-Datenübertragung benötigen Sie die folgenden Informationen zu Facebook Ads.

Führen Sie die folgenden Schritte aus, um clientID und clientSecret abzurufen:

1. Erstellen Sie eine Facebook-Entwickleranwendung mit dem Anwendungstyp Business.
2. Klicken Sie im Facebook App-Dashboard auf App-Einstellungen > Einfach und suchen Sie die App-ID und das App-Secret, die der App entsprechen.

Führen Sie die folgenden Schritte aus, um ein langlebiges Nutzerzugriffstoken abzurufen, auch als Aktualisierungstoken bezeichnet:

1. Fahren Sie in der Google Cloud Console mit den Schritten zum Erstellen einer Facebook Ads-Übertragung fort.

2. Kopieren Sie im Abschnitt Details zur Datenquelle den Weiterleitungs-URI, der nach dem Feld Aktualisierungstoken aufgeführt ist.

3. Klicken Sie auf das Facebook App-Dashboard und dann unter Facebook-Anmeldung für Unternehmen auf Einrichten.

   

4. Geben Sie auf der Seite Einstellungen die Weiterleitungs-URL in das Feld Gültige OAuth-Weiterleitungs-URIs ein und klicken Sie auf Speichern.

5. Kehren Sie zur Google Cloud Console zurück. Klicken Sie im Abschnitt Details zur Datenquelle auf Autorisieren. Sie werden auf eine Facebook-Authentifizierungsseite weitergeleitet.

   

6. Wählen Sie die Facebook-Entwickler-App aus, um das Konto zu autorisieren, das eine Verbindung zum BigQuery Data Transfer Service herstellt.

7. Klicken Sie nach Abschluss des Vorgangs auf OK, um zur Google Cloud Console zurückzukehren. Das langlebige Nutzerzugriffstoken wird jetzt in der Übertragungskonfiguration ausgefüllt.

Langlebige Nutzer-Zugriffstokens laufen nach 60 Tagen ab. Informationen zum Abrufen eines neuen langlebigen Nutzerzugriffstokens finden Sie unter Einschränkungen.

Alternativen zu Aktualisierungstokens

Alternativ können Sie ein Aktualisierungstoken angeben, wenn Sie eine Datenübertragung erstellen, sofern Sie eines mit einer der folgenden Methoden erhalten haben:

• Generieren Sie mit der Graph API ein langlebiges Nutzerzugriffstoken. Die Berechtigungen ads_management, ads_read und business_management sind für ein gültiges Token für die Datenübertragung erforderlich.
• Generieren Sie ein Systemnutzer-Token. Mit einem Systemnutzer-Token können Sie Assets wie Werbekonten manuell hinzufügen, die in die Datenübertragung einbezogen werden sollen. Wenn ein Systemnutzer-Token abgelaufen ist, müssen Sie die Übertragungskonfiguration manuell mit neuen Anmeldedaten aktualisieren. Sie haben auch die Möglichkeit, ein Token zu erstellen, das nicht abläuft, wenn Sie ein Systemnutzer-Token erstellen. Weitere Informationen finden Sie unter Unterstützte Zugriffstokens.

Voraussetzungen für BigQuery

• Ü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 Ihrer Daten.
• Wenn Sie Benachrichtigungen zur Übertragungsausführung für Pub/Sub einrichten möchten, benötigen Sie die IAM-Berechtigung (Identity and Access Management) pubsub.topics.setIamPolicy. Wenn Sie nur E-Mail-Benachrichtigungen einrichten, sind keine Pub/Sub-Berechtigungen erforderlich. Weitere Informationen finden Sie unter Ausführungsbenachrichtigungen im BigQuery Data Transfer Service.

Erforderliche BigQuery-Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle BigQuery-Administrator (roles/bigquery.admin) für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen einer BigQuery Data Transfer Service-Datenübertragung benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Erstellen einer BigQuery Data Transfer Service-Datenübertragung erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Weitere Informationen finden Sie unter bigquery.admin-Zugriff gewähren.

Eine Facebook Ads-Datenübertragung erstellen

Wählen Sie eine der folgenden Optionen aus:

bq mk
    --transfer_config
    --project_id=PROJECT_ID
    --data_source=DATA_SOURCE
    --display_name=DISPLAY_NAME
    --target_dataset=DATASET
    --params='PARAMETERS'

bq mk
--transfer_config
--target_dataset=mydataset
--data_source=facebook_ads
--display_name='My Transfer'
--params='{"connector.authentication.oauth.clientId": "1650000000",
    "connector.authentication.oauth.clientSecret":"TBA99550",
    "connector.authentication.oauth.refreshToken":"abcdef",
    "connector.authorizedAdAccountsOnly":true,
    "connector.actionCollections":["Actions", "Conversions"],
    "connector.genericBreakdowns":["PublisherPlatform", "PlatformPosition"],
    "connector.actionBreakdowns":["ActionDevice", "ActionType"]}'

Wenn Sie eine Datenübertragung außerhalb Ihres regulären Zeitplans manuell ausführen möchten, können Sie einen Backfill-Vorgang starten.

Informationen dazu, wie Ihre übertragenen Daten den Meta API-Feldern zugeordnet werden, finden Sie unter Transformation von Facebook Ads-Berichten.

Aktionssammlungen

Aktionssammlungen sind Objekte, die die verschiedenen Arten von Aktionen angeben, die Nutzer als Reaktion auf Ihre Anzeige ausgeführt haben. Sie können Aktionssammlungen angeben, wenn Sie die Übertragungskonfiguration einrichten.

Aktionssammlungen stellen die Felder des Typs list<AdsActionStats> dar, die in der Ad Account, Insights-Endpunktantwort vorhanden sind.

Nach Abschluss einer Übertragung werden diese Aktionssammlungen in der Tabelle AdInsightsActions ausgefüllt.

Im Folgenden finden Sie eine Liste der Aktionssammlungen, die bei einer Facebook Ads-Datenübertragung unterstützt werden:

• ActionValues
• Actions
• AdClickActions
• AdImpressionActions
• CatalogSegmentActions
• CatalogSegmentValue
• CatalogSegmentValueMobilePurchaseRoas
• CatalogSegmentValueOmniPurchaseRoas
• CatalogSegmentValueWebsitePurchaseRoas
• ConversionValues
• Conversions
• ConvertedProductQuantity
• ConvertedProductValue
• CostPer15_secVideoView
• CostPer2SecContinuousVideoView
• CostPerActionType
• CostPerAdClick
• CostPerConversion
• CostPerOneThousandAdImpression
• CostPerOutboundClick
• CostPerThruplay
• CostPerUniqueActionType
• CostPerUniqueConversion
• CostPerUniqueOutboundClick
• InteractiveComponentTap
• MobileAppPurchaseRoas
• OutboundClicks
• OutboundClicksCtr
• PurchaseRoas
• UniqueActions
• UniqueConversions
• UniqueOutboundClicks
• UniqueOutboundClicksCtr
• UniqueVideoView15_sec
• Video15_secWatchedActions
• Video30_secWatchedActions
• VideoAvgTimeWatchedActions
• VideoContinuous2SecWatchedActions
• VideoP100_watchedActions
• VideoP25WatchedActions
• VideoP50WatchedActions
• VideoP75WatchedActions
• VideoP95WatchedActions
• VideoPlayActions
• VideoPlayCurveActions
• VideoPlayRetentionGraphActions
• VideoTimeWatchedActions
• WebsiteCtr
• WebsitePurchaseRoas

Aufschlüsselungen kombinieren

Facebook Ads hat Einschränkungen für die Kombination von Spalten. Wenn Sie diese eingeschränkten Kombinationen verwenden, schlägt die Datenübertragung fehl.

Weitere Informationen dazu, welche Aufschlüsselungen kombiniert werden können, finden Sie unter Aufschlüsselungen kombinieren.

Fehlerbehebung bei der Übertragungskonfiguration

Wenn bei der Einrichtung von Facebook Ads-Datenübertragungen Probleme auftreten, führen Sie die folgenden Schritte zur Fehlerbehebung aus:

• Mit dem Facebook Access Token Debugger können Sie prüfen, ob Ihr Nutzerzugriffstoken abgelaufen ist. Langlebige Nutzer-Zugriffstokens laufen nach 60 Tagen ab. Wenn Ihr langlebiges Nutzerzugriffstoken abgelaufen ist, rufen Sie die Übertragungsdetails auf und klicken Sie auf Bearbeiten, um die Übertragungskonfiguration zu ändern. Folgen Sie auf der Seite „Übertragung bearbeiten“ den Schritten unter Voraussetzungen für Facebook Ads, um eine neue zu generieren.

• Prüfen Sie, ob das langlebige Nutzer-Zugriffstoken mit den erforderlichen Berechtigungen generiert wurde: ads_management, ads_read und business_management. Sie können die Berechtigungen für Ihr langlebiges Nutzer-Zugriffstoken prüfen, indem Sie den folgenden Link in Ihren Browser eingeben:

  https://graph.facebook.com/me/permissions?access_token=TOKEN
  

  Dabei ist TOKEN der Wert des langlebigen Nutzerzugriffstokens.

  Wenn Sie nicht die erforderlichen Berechtigungen haben, generieren Sie ein neues langlebiges Nutzerzugriffstoken. Folgen Sie dazu der Anleitung unter Voraussetzungen für Facebook Ads.

• Suchen Sie im Facebook App-Dashboard auf dem Tab Erforderliche Aktionen nach Elementen, die beachtet werden sollten.

Möglicherweise werden die folgenden Fehlermeldungen im Zusammenhang mit Meta API-Ratengrenzwertfehlern angezeigt:

Fehler: There have been too many calls from this ad-account. Wait a bit and try again.

Lösung: Prüfen Sie, ob parallele Workflows dieselben Apps oder Anmeldedaten verwenden. Wenn diese Fehler weiterhin auftreten, versuchen Sie, Ihre Berechtigungen auf Erweiterter Zugriff zu aktualisieren, um ein höheres Kontingent für die Ratenbegrenzung zu erhalten. Weitere Informationen finden Sie unter Ratenbegrenzung für die Marketing API.

Häufige Meldungen zu Monitoring-Messwerten

Sie können auch die Monitoring-Messwerte des BigQuery Data Transfer Service prüfen, um die Ursache eines Datenübertragungsfehlers zu ermitteln. In der folgenden Tabelle sind einige gängige ERROR_CODE-Meldungen für Facebook Ads-Datenübertragungen aufgeführt.

Nächste Schritte

• Weitere Informationen zum BigQuery Data Transfer Service
• Weitere Informationen zum Arbeiten mit Übertragungen, z. B. zum Aufrufen von Konfigurationen und dem Ausführungsverlauf
• Daten mit BigQuery Omni-Vorgängen laden