Facebook 広告のデータを BigQuery に読み込む

Facebook 広告から BigQuery にデータを読み込むには、Facebook 広告用の BigQuery Data Transfer Service コネクタを使用します。BigQuery Data Transfer Service を使用すると、Facebook 広告からの最新データを BigQuery に追加する定期的な転送ジョブをスケジュールできます。

サポートされるレポート

Facebook 広告用の BigQuery Data Transfer Service は、次の Facebook 広告レポートの転送をサポートしています。

• Ads
• AdInsights
• AdInsightsActions

Facebook 広告レポートが BigQuery のテーブルとビューに変換される仕組みについては、Facebook 広告データの変換をご覧ください。

制限事項

Facebook 広告データの転送には、次の制限があります。

• Facebook 広告データの定期的な転送の最小間隔は 24 時間です。デフォルトの定期的なデータ転送間隔は 24 時間です。
• Facebook 広告用 BigQuery Data Transfer Service は、固定のテーブルセットのみをサポートしています。カスタム レポートはサポートされていません。
• Facebook 広告データの転送は最大 6 時間です。この最大時間を超えると、転送が失敗します。
• 増分転送は、AdInsights テーブルと AdInsightsActions テーブルではサポートされていません。AdInsights テーブルと AdInsightsActions テーブルを含むデータ転送を作成し、スケジュール オプションで日付を指定すると、その日付に対して利用可能なすべてのデータが転送されます。
• BigQuery Data Transfer Service では、AdInsights テーブルと AdInsightsActions テーブルへの 1 日の更新ウィンドウがサポートされます。更新ウィンドウとは、データ転送でソースデータを取得する日数を指します。データ転送を初めて実行する際に、更新ウィンドウ内で利用可能なすべてのソースデータを取得します。

• Facebook 広告の転送に必要な有効期間の長いユーザー アクセス トークンは、60 日後に期限切れになります。

  有効期間の長いユーザー アクセス トークンの有効期限が切れた場合は、データ転送の詳細に移動して [編集] をクリックすると、新しいトークンを取得できます。転送の編集ページで、Facebook 広告の前提条件の同じ手順に沿って、新しい有効期間の長いユーザー アクセス トークンを生成します。

• 構成したネットワーク アタッチメントと仮想マシン（VM）インスタンスが異なるリージョンにある場合、Facebook 広告からデータを転送するときにリージョン間でデータが移動する可能性があります。

Facebook 広告の転送からのデータの取り込み

AdInsights テーブルと AdInsightsAction テーブルの場合、データが読み込まれるテーブル パーティションは、データソースの日付に対応します。

AdAccounts テーブルの場合、スナップショットは 1 日に 1 回取得され、最後の転送実行日付のパーティションに保存されます。更新ウィンドウは AdAccounts テーブルには適用されません。

始める前に

以下のセクションでは、Facebook 広告データの転送を作成する前に必要な手順について説明します。

Facebook 広告の前提条件

Facebook 広告データの転送を作成する場合は、Facebook 広告について次の情報を用意してください。

clientID と clientSecret を取得する手順は次のとおりです。

1. アプリタイプ Business で Facebook デベロッパー アプリを作成します。
2. Facebook App ダッシュボードで、[App Settings] > [Basic] をクリックして、アプリ ID とアプリに対応するアプリ シークレットを見つけます。

有効期間の長いユーザー アクセス トークン（更新トークン）を取得する手順は次のとおりです。

1. Trusted Cloud コンソールで、Facebook 広告の転送を作成するの手順を実施します。

2. [データソースの詳細] セクションで、[更新トークン] フィールドの後に表示されているリダイレクト URI をコピーします。

   

3. Facebook App ダッシュボードをクリックし、[Facebook login for Business] セクションで [Set up] をクリックします。

   

4. [Settings] ページで、[Valid OAuth Redirect URIs] フィールドにリダイレクト URL を入力し、[Save] をクリックします。

5. Trusted Cloud コンソールに戻ります。[データソースの詳細] セクションで、[承認] をクリックします。Facebook 認証ページにリダイレクトされます。

   

6. Facebook デベロッパー アプリを選択して、BigQuery Data Transfer Service に接続するアカウントを承認します。

7. 完了したら、[OK] をクリックして Trusted Cloud コンソールに戻ります。有効期間の長いユーザー アクセス トークンが転送構成に挿入されます。

有効期間の長いユーザー アクセス トークンは 60 日後に期限切れになります。新しい有効期間の長いユーザー アクセス トークンを取得する方法については、制限事項をご覧ください。

更新トークンの選択肢

または、次のいずれかの方法で取得した更新トークンを、データ転送の作成時に指定することもできます。

• Graph API を使用して有効期間の長いユーザー アクセス トークンを生成します。データ転送用の有効なトークンには、ads_management、ads_read、business_management 権限が必要です。
• システム ユーザー トークンを生成します。システム ユーザー トークンを使用すると、広告アカウントなどのアセットを手動で追加して、データ転送に含めることができます。システム ユーザー トークンの有効期限が切れている場合は、新しい認証情報を使用して転送構成を手動で更新する必要があります。システム ユーザー トークンを作成するときに、有効期限のないトークンを作成することもできます。詳細については、サポートされているアクセス トークンをご覧ください。

BigQuery の前提条件

• BigQuery Data Transfer Service を有効にするために必要なすべての操作が完了していることを確認します。
• データを保存する BigQuery データセットを作成します。
• Pub/Sub の転送実行通知を設定する場合は、pubsub.topics.setIamPolicy Identity and Access Management（IAM）権限があることを確認します。メール通知のみを設定する場合は、Pub/Sub 権限は必要ありません。詳細については、BigQuery Data Transfer Service の実行通知をご覧ください。

必要な BigQuery のロール

転送の作成に必要な権限を取得するには、BigQuery 管理者（roles/bigquery.admin）IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

この事前定義ロールには、転送の作成に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

Facebook 広告のデータ転送を作成する

次のオプションのいずれかを選択します。

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

転送構成のトラブルシューティング

Facebook 広告のデータ転送の設定に問題がある場合は、次のトラブルシューティング手順を試してください。

• Facebook アクセス トークン デバッガを使用して、ユーザー アクセス トークンの有効期限が切れていないかどうかを確認します。有効期間の長いユーザー アクセス トークンは 60 日後に期限切れになります。有効期間の長いユーザー アクセス トークンの有効期限が切れた場合は、転送の詳細に移動し、[編集] をクリックして転送の構成を変更します。転送の編集ページで、Facebook 広告の前提条件の同じ手順に沿って新しい転送を生成します。
• 必要な権限（ads_management、ads_read、business_management）で有効期間の長いユーザー アクセス トークンが生成されていることを確認します。生成されていない場合は、Facebook 広告の前提条件の手順に沿って、新しい有効期間の長いユーザー アクセス トークンを生成します。
• Facebook アプリ ダッシュボードの [必要な操作] タブで、注意が必要な項目を確認してください。

Meta API のレート制限エラーに関連する次のエラー メッセージが表示される場合があります。

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

解決策: 同じアプリまたは認証情報を使用している並列ワークフローがないことを確認します。これらのエラーが解消されない場合は、権限を高度なアクセスにアップグレードして、レート制限の割り当てを増やしてみてください。詳しくは、Marketing API のレート制限をご覧ください。

モニタリング指標に関する一般的なメッセージ

BigQuery Data Transfer Service のモニタリング指標を確認して、データ転送エラーの原因を特定することもできます。次の表に、Facebook 広告データの転送に関する一般的な ERROR_CODE メッセージを示します。

料金

この機能のプレビュー版では、Facebook 広告データを BigQuery に転送する際に料金は発生しません。

次のステップ

• BigQuery Data Transfer Service の詳細を確認する。
• 構成や実行履歴の表示など、転送の操作の詳細を確認する。
• クロスクラウドの操作でデータを読み込む方法を学習する。