Facebook Ads-Übertragung planen

Vorschau

Diese Funktion unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Funktionen sind „wie besehen“ verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in den Beschreibungen der Startphase.

Hinweis: Wenn Sie Support benötigen oder Feedback zu dieser Funktion geben möchten, wenden Sie sich an [e-mail].

Mit dem BigQuery Data Transfer Service für Facebook Ads-Connector können Sie wiederkehrende Ladejobs von Facebook Ads in BigQuery automatisch planen und verwalten.

Beschränkungen

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

• Das Mindestintervall zwischen wiederkehrenden Facebook Ads-Datenübertragungen beträgt 24 Stunden. Das Standardintervall für eine wiederkehrende Ü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-Ü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- und AdInsightsActions-Tabellen nicht unterstützt. Wenn Sie eine Datenübertragung erstellen, die AdInsights- und AdInsightsActions-Tabellen enthält, und in den Planungsoptionen 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 einem Tag für die Tabellen AdInsights und AdInsightsActions. Das Aktualisierungsfenster bezieht sich auf die Anzahl der Tage, an denen bei einer Datenübertragung Quelldaten abgerufen werden. 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 die Übertragung von Facebook-Anzeigen 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. Folgen Sie auf der Seite zum Bearbeiten der Übertragung den Schritten unter Voraussetzungen für Facebook Ads, um ein neues langlebiges Nutzerzugriffstoken zu generieren.

Datenaufnahme aus Facebook Ads-Übertragungen

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

Bei AdInsights- und AdInsightsAction-Tabellen entspricht die Tabellenpartition, in die die Daten geladen werden, dem Datum aus der Datenquelle.

Für AdAccounts-Tabellen werden einmal täglich Snapshots erstellt und in der Partition für das Datum der letzten Übertragung gespeichert. Das Aktualisierungsfenster gilt nicht für die Tabelle AdAccounts.

Hinweise

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.

Facebook Ads-Parameter	Beschreibung
clientID	Der Anwendungs-ID-Name für den OAuth 2.0-Client.
clientSecret	Der Anwendungsschlüssel für den OAuth 2.0-Client.
refreshToken	Das langlebige Nutzerzugriffstoken, auch als Aktualisierungstoken bezeichnet.

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 beim Erstellen einer Datenübertragung ein Aktualisierungstoken angeben, wenn Sie es mit einer der folgenden Methoden erhalten haben:

• Mit der Graph API ein langlebiges Nutzerzugriffstoken generieren 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 Token für Systemnutzer. Mit einem Systemnutzertoken können Sie Assets wie Werbekonten manuell hinzufügen, die in die Datenübertragung einbezogen werden sollen. Wenn das Token eines Systemnutzers 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 Systemnutzertoken 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 den IAM-Rolle BigQuery-Administrator (roles/bigquery.admin) zu gewähren, um die Berechtigungen zu erhalten, die Sie zum Erstellen einer Ü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 Übertragung erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind zum Erstellen einer Übertragung erforderlich:

• bigquery.transfers.update für den Nutzer
• bigquery.datasets.get für das Ziel-Dataset
• bigquery.datasets.update für das Ziel-Dataset

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

Eine Facebook Ads-Datenübertragung erstellen

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 Source type (Quelltyp) für Source (Quelle) die Option Facebook Ads aus.

4. Führen Sie im Abschnitt Details zur Datenquelle folgende Schritte aus:

   • Geben Sie unter Client-ID die Anwendungs-ID ein.
   • Geben Sie unter Clientschlüssel den App-Schlüssel ein.

   • Geben Sie unter Aktualisierungstoken die langlebige Nutzer-Zugriffstoken-ID ein, indem Sie auf Autorisieren klicken. Wenn Sie bereits ein Aktualisierungstoken oder ein Systemnutzertoken haben, können Sie das Aktualisierungstoken auch direkt in dieses Feld eingeben.

     Informationen zum Abrufen eines langlebigen Nutzer-Zugriffstokens finden Sie unter Voraussetzungen für Facebook-Anzeigen.

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

6. Geben Sie im Abschnitt Konfigurationsname für Übertragung für Anzeigename einen Namen für die Datenübertragung ein.

7. Führen Sie im Abschnitt Zeitplanoptionen folgende Schritte aus:

   • Wählen Sie in der Liste Wiederholungshäufigkeit aus, wie oft diese Übertragung ausgeführt werden soll. Wenn Sie eine benutzerdefinierte Wiederholungshäufigkeit angeben möchten, wählen Sie Benutzerdefiniert aus. Wenn Sie On-Demand auswählen, wird diese Übertragung ausgeführt, wenn Sie die Übertragung manuell auslösen.

   • Wählen Sie gegebenenfalls Jetzt starten oder Zu festgelegter Zeit starten aus und geben Sie ein Startdatum und eine Laufzeit an.

8. Optional: Wählen Sie im Menü Dienstkonto ein Dienstkonto aus den Dienstkonten aus, die mit Ihrem Google Cloud-Projekt verknüpft sind. Das ausgewählte Dienstkonto muss die erforderlichen Rollen für diese Übertragung haben.

   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 Datenübertragung optional.

   Weitere Informationen zur Verwendung von Dienstkonten mit Datenübertragungen finden Sie unter Dienstkonten verwenden.

9. Optional: Gehen Sie im Abschnitt Benachrichtigungsoptionen so vor:

   • Klicken Sie zum Aktivieren von E-Mail-Benachrichtigungen auf die Ein/Aus-Schaltfläche E-Mail-Benachrichtigung. Wenn Sie diese Option aktivieren, erhält der Übertragungsadministrator eine E-Mail-Benachrichtigung, wenn eine Übertragung fehlschlägt.
   • Klicken Sie auf die Ein/Aus-Schaltfläche Pub/Sub-Benachrichtigungen, um Pub/Sub-Benachrichtigungen über die Ausführung von Übertragungen für diese Datenübertragung zu aktivieren. Sie können den Namen für das Thema auswählen oder auf Thema erstellen klicken, um eines zu erstellen.

10. Klicken Sie auf Speichern.

Wenn diese Datenübertragung ausgeführt wird, füllt BigQuery Data Transfer Service automatisch die folgenden Tabellen aus.

Tabellenname	Beschreibung
AdAccounts	Die für einen Nutzer verfügbaren Anzeigenkonten.
AdInsights	Bericht zu Anzeigenstatistiken für alle Anzeigenkonten
AdInsightsActions	Bericht zu Anzeigenstatistiken-Aktionen für alle Anzeigenkonten.

bq

Geben Sie den Befehl bq mk ein und geben Sie das Flag --transfer_config für die Übertragungserstellung an.

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

Dabei gilt:

• PROJECT_ID (Optional) Ihre Google Cloud-Projekt-ID. Wenn --project_id nicht bereitgestellt wird, um ein bestimmtes Projekt anzugeben, wird das Standardprojekt verwendet.
• DATA_SOURCE: Die Datenquelle (z. B. facebook-ads).
• DISPLAY_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.
• DATASET: Das Ziel-Dataset für die Datenübertragungskonfiguration.
• PARAMETERS enthält die Parameter für die erstellte Datenübertragungskonfiguration im JSON-Format. Beispiel: --params='{"param":"param_value"}'. Im Folgenden finden Sie die Parameter für eine Facebook Ads-Übertragung:
  • connector.authentication.oauth.clientId: Der Anwendungs-ID-Name für den OAuth 2.0-Client.
  • connector.authentication.oauth.clientSecret: Der Anwendungsschlüssel für den OAuth 2.0-Client.
  • connector.authentication.oauth.refreshToken: die langlebige Token-ID.

Mit dem folgenden Befehl wird beispielsweise eine Facebook Ads-Datenübertragung im Standardprojekt mit allen erforderlichen Parametern erstellt:

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"}'

API

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

Fehlerbehebung bei der Übertragungskonfiguration

Wenn bei der Einrichtung einer Facebook Ads-Datenübertragung 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 zum Bearbeiten der Übertragung den Schritten unter Voraussetzungen für Facebook Ads, um eine neue zu erstellen.
• Prüfen Sie, ob das langlebige Nutzer-Zugriffstoken mit den erforderlichen Berechtigungen generiert wurde: ads_management, ads_read und business_management. Andernfalls folgen Sie der Anleitung unter Voraussetzungen für Facebook Ads, um ein neues langlebiges Nutzerzugriffstoken zu generieren.
• 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 keine parallelen Workflows mit denselben Apps oder Anmeldedaten ausgeführt werden. Wenn diese Fehler weiterhin auftreten, aktualisieren Sie Ihre Berechtigungen auf Erweiterter Zugriff, um ein höheres Kontingent für die Ratenbegrenzung zu erhalten. Weitere Informationen finden Sie unter Marketing API Rate Limiting.

Häufige Meldungen zu Monitoring-Messwerten

Sie können auch die Monitoring-Messwerte für BigQuery Data Transfer Service prüfen, um die Ursache für einen Datenübertragungsfehler zu ermitteln. In der folgenden Tabelle sind einige häufige ERROR_CODE-Nachrichten für die Übertragung von Facebook Ads-Daten aufgeführt.

Fehler	Beschreibung
INVALID_ARGUMENT	Die angegebene Konfiguration ist ungültig.
PERMISSION_DENIED	Die Anmeldedaten sind ungültig
UNAUTHENTICATED	Authentifizierung erforderlich
SERVICE_UNAVAILABLE	Der Dienst kann diese Datenübertragung vorübergehend nicht verarbeiten
DEADLINE_EXCEEDED	Die Datenübertragung wurde nicht innerhalb der maximalen Dauer von sechs Stunden abgeschlossen
NOT_FOUND	Eine angeforderte Ressource wird nicht gefunden
INTERNAL	Ein anderer Grund hat zum Fehler geführt
RESOURCE_EXHAUSTED	Das Kontingent oder Limit einer Datenquelle wurde überschritten

Preise

Die Übertragung von Facebook Ads-Daten in BigQuery ist kostenlos, solange sich dieses Feature in der Vorschau befindet.

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 cloudübergreifenden Vorgängen laden