Facebook Ads-Übertragung planen

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

Beschränkungen

Facebook Ads-Übertragungen unterliegen den folgenden Einschränkungen:

  • Das Mindestintervall zwischen wiederkehrenden Facebook Ads-Übertragungen beträgt 15 Minuten. 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 nicht unterstützt.
  • BigQuery Data Transfer Service unterstützt die Übertragung von Daten von bis zu einem Tag (gestern) in die Tabellen AdInsights und AdInsightsActions.

Hinweise

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

Voraussetzungen für Facebook-Anzeigen

Beim Erstellen einer Facebook Ads-Ü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.

    Weiterleitungs-URI kopieren

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

    Einstellungen für Facebook Login for Business konfigurieren

  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.

    Langlebiges Nutzer-Zugriffstoken generieren

  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 Zugriffstoken wird jetzt in der Übertragungskonfiguration ausgefüllt.

Alternativ können Sie 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 Übertragung erforderlich.

Langlebige Nutzer-Zugriffstokens laufen nach 60 Tagen ab.

Voraussetzungen für BigQuery

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 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. Öffnen Sie in der Google Cloud Console die Seite BigQuery Studio.

    Zu BigQuery Studio

  2. Klicken Sie auf Datenübertragungen > Übertragung erstellen.

  3. Wählen Sie im Abschnitt Source type (Quelltyp) für Source (Quelle) die Option Facebook Ads aus.

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

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

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

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

    Informationen zum Abrufen dieser Werte finden Sie unter Voraussetzungen für Facebook-Anzeigen.

  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 Ü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 Ü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 Ü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'

Wobei:

  • 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 Ü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 Übertragungskonfiguration.
  • PARAMETERS: die Parameter für die erstellte Ü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-Ü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 Sie Probleme beim Einrichten einer Facebook Ads-Übertragung haben, suchen Sie im Facebook App-Dashboard auf dem Tab Erforderliche Aktionen nach Elementen, die beachtet werden sollten.

Preise

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

Nächste Schritte