Facebookをデータパイプラインソースとして設定する ​

Facebookをデータパイプラインソースとして設定し、Meta Marketing APIから同期先に広告アカウント、キャンペーン、パフォーマンスInsightsデータを抽出して同期します。

このガイドでは、機能と前提条件の確認、Facebookのデータパイプラインソースとしての接続、パイプラインの設定、サポートされているオブジェクト、同期モード、スキーマ処理、機密データ処理、既知の制限について説明します。

サポートされている機能 ​

Facebookをパイプラインソースとして使用する場合、次の機能がサポートされます。

• クラウド接続：https://graph.facebook.comを通じてHTTPS経由でMeta Marketing APIに接続します。
• マルチアカウントサポート：コネクションがアクセスできるすべての広告アカウントを同期するか、IDで特定の広告アカウントを選択します。
• オブジェクトレベルの選択：広告階層とパフォーマンスInsightsレポート全体で、サポートされているオブジェクトから選択します。 完全なリストについては、サポートされているオブジェクトを参照してください。
• 増分同期：AdSet、Ad、およびすべてのパフォーマンスInsightsオブジェクトは増分同期されます。 詳細については、同期モードを参照してください。
• 削除トラッキング：すべての完全同期オブジェクト、およびAdSetとAdで、アーカイブ済み、削除済み、または欠落しているレコードを検出し、同期先でソフト削除フラグを付けます。 詳細については、削除追跡を参照してください。
• スキーマドリフトの検出と処理: 新しいフィールドを自動同期でスキーマの変更を自動的に検出して適用するか、新しいフィールドをブロックでスキーマを固定します。
• フィールドレベルのデータ保護: 機密フィールドをそのままレプリケートするか、宛先に到達する前にハッシュ化します。
• 構成可能な同期頻度: 時間ベースの間隔またはcron式を使用して同期をスケジュールします。 サポートされる最小間隔は15分です。

前提条件 ​

Facebookをデータパイプラインソースとして接続する前に、次の要件を満たしてください。

• 同期する予定の広告アカウントにアクセスできるMeta Business Managerアカウント。
• これらの広告アカウントに対してサードパーティアプリケーションを認可する権限を持つFacebookアカウント。

サポートされるコネクションタイプ ​

FacebookデータパイプラインはOAuth 2.0認証をサポートしています。

• OAuth 2.0：Facebook Lead Adsワークフローコネクターと同じOAuthフローを使用し、Facebook Loginを通じてWorkatoを認可します。 パスワードを変更した場合、2要素認証を有効にした場合、またはWorkatoのアプリ権限を削除した場合、Metaは生成されたアクセストークンを無効化します。 その場合は、パイプラインコネクションを再接続してください。

Facebookに接続する ​

Facebookをデータパイプラインソースとして接続するには、次の手順を実行します。

パイプラインの設定 ​

Facebookをデータパイプラインソースとして設定するには、次の手順を実行します。

[minute] [hour] [day of month] [month] [day of week]

0 8 * * *

サポートされるオブジェクト ​

Facebookデータパイプラインは、Meta Marketing API（v25.0）からデータを同期します。 次の表は、サポートされているオブジェクトをカテゴリ別に示しています。 各オブジェクトは同期先で別々のテーブルとして同期されます。ただし、Basic Ad ActionsはMetaのactions配列とaction_values配列をBasic Adの単一の子テーブルにマージします。

広告アカウントとキャンペーン階層 ​

次のオブジェクトは、Metaの広告階層を反映しています。AdAccountはCampaignオブジェクトの親であり、CampaignはAdSetオブジェクトの親であり、AdSetはAdオブジェクトの親です。 各AdはAdCreativeを参照します。

クリエイティブアセット、オーディエンス、ラベル ​

次のオブジェクトには、広告、広告セット、キャンペーンから参照されるサポート用のクリエイティブアセット、オーディエンス定義、またはラベル定義が保持されます。

アクティビティログ ​

次のオブジェクトは、広告階層内の他のオブジェクトの変更履歴ログです。

事前構築済みパフォーマンスレポート ​

次のオブジェクトは、固定レベル（アカウント、キャンペーン、広告セット、または広告）の日次パフォーマンス指標を返します。 Basic Ad ActionsはBasic Adの子テーブルであり、各広告のコンバージョンアクションをアクションタイプごとに1行に展開します。

デモグラフィック内訳とマーケティングミックスモデリング ​

次のオブジェクトは、国、年齢、性別などの追加ディメンションで分類された同じ日次パフォーマンス指標、またはマーケティングミックスモデリングツールに必要な最小限のフィールドセットに絞り込まれた指標を返します。 Demographics Platform & Deviceは、FacebookとInstagramのパフォーマンスの内訳を表示します。これは、Instagram広告が別個のコネクターではなく、同じMarketing APIオブジェクトを通じて同期されるためです。

同期モード ​

Facebookデータパイプラインは、完全同期、増分同期、追加専用同期をサポートしています。 Workatoは各オブジェクトの同期モードを自動的に検出します。

フル同期 ​

完全同期では、実行ごとにオブジェクトの完全なレコードセットを再読み取りし、同期先テーブルを上書きします。 AdAccount、Campaign、AdCreative、AdImage、AdVideo、CustomAudience、AdLabelは完全同期を使用します。これは、MetaのAPIがこれらのオブジェクトに対して信頼できる変更時刻シグナルを公開していないためです。

増分同期 ​

増分同期では、前回の実行以降に変更されたレコードのみを抽出します。 AdSetとAdは、Metaのupdated_timeフィールドをカーソルとして使用します。

すべてのパフォーマンスInsightsオブジェクトは、変更時刻カーソルではなくローリング日付ウィンドウを使用します。 各実行でウィンドウが前方に進み、直近28日分のデータが常に再取得されるため、最近の数値は実行間で変わる可能性があります。 このウィンドウは28日に固定されており、設定できません。

各オブジェクトの同期モードを確認するには、サポートされるオブジェクトの表を参照してください。

追加専用同期 ​

AdActivityは、Metaの広告オブジェクトの変更履歴ログです。 各実行では、アカウントのアクティビティ履歴を読み取り、以前の実行で書き込まれた行を変更または削除せずに、新しいイベントを同期先に追加します。

削除追跡 ​

Campaign、AdSet、Adについては、WorkatoはMetaのeffective_statusフィールドを通じてソフト削除されたレコードを検出しますが、アーカイブ済みオブジェクトに限られます。 Workatoはアーカイブ済みのキャンペーン、広告セット、または広告を検出できますが、Metaが完全に削除したものは検出できません。 AdCreativeとAdImageについては、Workatoは代わりに各レコード自身のstatusフィールドを読み取ります。

AdAccount、AdVideo、CustomAudience、AdLabelは実行ごとに完全同期されるため、Workatoは各実行の完全なスナップショットを前回のスナップショットと比較して削除を検出し、MetaのAPIがこれらのオブジェクトに対して明示的な削除シグナルを公開していない場合でも、表示されなくなったレコードにフラグを付けます。

パフォーマンスInsightsレコードは日付範囲が過ぎると不変になるため、削除トラッキングは適用されません。また、AdActivityは削除されることのない追加専用ログです。

スキーマとデータ型の処理 ​

Facebookからデータを同期する場合、スキーマとデータ型には次の考慮事項が適用されます。

タイムスタンプ ​

Facebookオブジェクトは異なるタイムスタンプ表現を使用し、Workatoはそれぞれを異なる方法で処理します。

• AdAccount、Campaign、AdSet、Ad、AdCreative、AdImage、AdVideo、AdActivityは、UTCオフセットが埋め込まれたISO 8601タイムスタンプを返します。 Workatoは、これらの値を同期先に書き込む際にUTCに正規化します。
• CustomAudienceのtime_created、time_updated、time_content_updatedフィールドは、ISO 8601文字列ではなくUnixエポック秒を返します。 Workatoはこの形式を自動的に検出して解析します。
• パフォーマンスInsightsオブジェクトは、date_startとdate_stopを時刻コンポーネントのないカレンダー日付（YYYY-MM-DD）として返します。 Workatoは、これらをタイムスタンプではなく日付値として保存します。

ネストされた可変フィールド ​

Facebookはユーザー定義のカスタムフィールドをサポートしていませんが、複数のオブジェクトには、キャンペーン目的やクリエイティブタイプによって構造が異なるフィールドが含まれています。 Workatoは、次のフィールドをフラット化せずにJSON文字列列として保存します。

• AdSet.targeting
• AdCreative.object_story_spec
• AdCreative.asset_feed_spec
• Campaign.promoted_object

合成列 ​

Workatoは、削除トラッキングがあるオブジェクトの同期先テーブルに、次の合成列を追加します。

機密データの処理 ​

Facebookオブジェクトには、個人を特定できる情報（PII）や支払い詳細が含まれる場合があります。 MetaのMarketing APIは個々のユーザーレベルのデータを公開しません（すべてのパフォーマンスInsightsデータは集計されています）が、次のオブジェクトには一般的に機密フィールドが含まれます。

AdAccount.funding_source_detailsにはbusiness_management権限が必要です。 コネクションのトークンにその権限がない場合の動作については、前提条件を参照してください。

GDPRまたは同様の規制の下で運用している場合は、MetaがMarketing APIを通じてCustomAudienceメンバーシップデータ（オーディエンス内のユーザーのリスト）を公開しない点に注意してください。 Metaはそのデータを排他的に保持するため、Workatoは抽出または転送できません。

PIIが同期先に到達する前に保護するには、パイプライン設定時にフィールドレベルのデータ保護でハッシュオプションを使用します。特にAdAccount.funding_source_detailsに対して使用してください。 詳細については、パイプラインを構成手順を参照してください。

制限事項 ​

Facebookをデータパイプラインソースとして使用する場合、次の制限が適用されます。

Insights履歴は37か月に制限される ​

MetaはInsightsデータを37か月間保持します。 それより前の履歴開始日を設定した場合でも、Basic Ad、Basic AdSet、Basic Campaign、Basic Account、デモグラフィック内訳オブジェクト、Marketing Mix Modelingでは、37か月より古いデータを同期できません。 AdAccount、Campaign、AdSet、Ad、AdCreative、AdImage、AdVideo、AdActivity、CustomAudience、AdLabelには、履歴開始日がまったくありません。 これらは、コネクションを作成した日以降の履歴のみを蓄積します。

リーチ関連指標は古い日付範囲では使用できない ​

13か月以上前に開始する日付範囲については、MetaはBasic Adとデモグラフィック内訳オブジェクトでreach、frequency、cppを返さなくなります。 Metaはまた、そのしきい値を過ぎた日付範囲について、アカウントを1日あたり10件の非同期リーチリクエストに制限します。

最小同期頻度 ​

サポートされる最小同期間隔は15分です。