Facebook Conversions API Export Integration

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Cursorに接続

  CursorにMCPサーバーをインストール
• VS Codeに接続

  VS CodeにMCPサーバーをインストール

Treasure Data から Facebook に直接ジョブ結果(イベントデータの形式)を送信するために Facebook Conversions API を使用できます。これにより、Facebook 広告が購入、登録、申し込み、その他のウェブコンバージョンなどの実世界での成果にどの程度つながっているかを測定できます。

Facebook Pixel が3rdパーティデータとして取り込むコンバージョンデータに加えて、1stパーティデータをコンバージョンデータとしてアップロードできます。

また、ウェブサーバーログから抽出した CV ログを Facebook Conversion API にアップロードすることもできます。

前提条件

• Treasure Data の基本知識

• Facebook Conversions と Facebook Event の基本知識

• イベントデータをアップロードするには、Facebook の以下のいずれかへのアクセスが必要です:

  • Business Manager admin
  • イベントセットを作成した Admin system user

• イベントセットに接続されている ad_account の Admin

• Facebook Pixel ID

• Facebook Access Token

Facebook Pixel ID と Access Token の取得

1. Business Manager ダッシュボードを開き、Event Manager を選択します。

2. Event Set を選択します。Settings を選択すると、Pixel ID が表示されます。

3. Create Access Token を選択します。

4. Pixel を選択します。
5. Next を選択します。

6. Generate Access Token を選択します。

7. アクセストークンをコピーして保存します。セキュリティのため、サンプルではトークンを非表示にしています。
8. Next を選択します。

アップロードの検証

アップロードテストを試すには、Test Events タブでテストコードを確認してください。

TD Console を使用した接続の作成

新しい接続の作成

Treasure Data では、クエリを実行する前に、エクスポート中に使用するデータ接続を作成して設定する必要があります。データ接続の一部として、インテグレーションにアクセスするための認証情報を提供します。

1. TD Console を開きます。
2. Integrations Hub > Catalog に移動します。
3. Facebook Conversion API を検索して選択します。

1. Create Authentication を選択します。

以下のフィールドを入力します:

• Pixel ID

• Access Token

  

2. Continue を選択します。接続名を入力し、Done を選択します。

クエリの定義

クエリで列マッピングを定義する必要があります。クエリ内の列は、Facebook にアップロードされるイベントデータを表します。

Conversions API を使用して共有されるすべてのウェブサイトイベントには、以下のデータパラメータが必要です:

• client_user_agent
• action_source
• event_source_url

ただし、非ウェブイベントには action_source パラメータのみが必要です。

これらのパラメータは、広告配信に使用されるイベントの品質を向上させ、キャンペーンのパフォーマンスを改善する可能性があります。さらに、一部の列については、Facebook に送信される前にデータがハッシュ化および正規化されます。

エクスポート結果を設定するには、少なくとも1つの顧客情報列が必要です。ハッシュ化と正規化の要件および Facebook Conversions API の詳細をご覧ください。

Facebook Conversions API のインテグレーションパラメータ

クエリの例

custom_data に属する currency などのデータをエクスポートする場合は、JSON 形式でデータを設定する必要があります。

例えば、クエリは次のようになります：

WITH sample_data AS(
  SELECT
     *
  FROM
    (
    VALUES(
      1,
      'USD',
      104.2
    ),
    (
      2,
      'JPY',
      10000.2
    ),
    (
      3,
      'USD',
      103.4
    )
    ) AS t(
      id,
      currency,
      VALUE
    )
) SELECT
  CAST(
    MAP(
      ARRAY['currency',
      'value'],
      ARRAY[currency,
      CAST(
        VALUE AS VARCHAR
      ) ]
    ) AS JSON
  ) AS custom_data,
  id
FROM
  sample_data

同じ名前で複数の値をクエリするには、クエリ内で名前を複数回指定します。

イベントデータを取得するクエリの例

Treasure Data から、Facebook Conversions への接続にエクスポート結果を出力する次のクエリを実行します：

• テーブルからの通常の SELECT クエリ

SELECT
  an_event_name_column AS event_name,
  an_event_time_column AS event_time,
  an_email_column AS em,
  a_country_column AS country
FROM your_table;

• custom_data カラムのクエリ

SELECT
  'PageView' as event_name,
  1598531676 as event_time,
  'elizabetho@fb.com' as em,
  '{"a":12, "b":"c"}' as custom_data

App Data Event のクエリ例

SELECT
  event_name,
  event_time,
  em,
  action_source,
  advertiser_tracking_enabled,
  application_tracking_enabled,
  campaign_ids,
  install_referrer,
  installer_package,
  url_schemes,
  vendor_id,
  windows_attribution_id,
  extinfo_version,
  app_package_name,
  short_version,
  long_version,
  os_version,
  device_model_name,
  locale,
  timezone_abbr,
  carrier,
  screen_width,
  screen_height,
  screen_density,
  cpu_core,
  external_storage_size,
  free_space_in_external_storage_size,
  device_time_zone,
  anon_id,
  madid,
  client_ip_address,
  client_user_agent
FROM
  conversion_table

Facebook Conversions API の統合パラメータ

Treasure Data は、送信前にFacebook側のデータ要件に基づいて、統合内でデータの正規化とハッシュ化を処理します。

詳細は Facebook のコンテンツページを参照してください。

(オプション) Query Export ジョブをスケジュールする

Scheduled Jobs と Result Export を使用して、指定したターゲット宛先に出力結果を定期的に書き込むことができます。

Treasure Data のスケジューラー機能は、高可用性を実現するために定期的なクエリ実行をサポートしています。

2 つの仕様が競合するスケジュール仕様を提供する場合、より頻繁に実行するよう要求する仕様が優先され、もう一方のスケジュール仕様は無視されます。

例えば、cron スケジュールが '0 0 1 * 1' の場合、「月の日」の仕様と「週の曜日」が矛盾します。前者の仕様は毎月 1 日の午前 0 時 (00:00) に実行することを要求し、後者の仕様は毎週月曜日の午前 0 時 (00:00) に実行することを要求するためです。後者の仕様が優先されます。

TD Console を使用してジョブをスケジュールする

1. Data Workbench > Queries に移動します

2. 新しいクエリを作成するか、既存のクエリを選択します。

3. Schedule の横にある None を選択します。

4. ドロップダウンで、次のスケジュールオプションのいずれかを選択します:

   ドロップダウン値	説明
   Custom cron...	Custom cron... の詳細を参照してください。
   @daily (midnight)	指定されたタイムゾーンで 1 日 1 回午前 0 時 (00:00 am) に実行します。
   @hourly (:00)	毎時 00 分に実行します。
   None	スケジュールなし。

Custom cron... の詳細

 *    *    *    *    *
 -    -    -    -    -
 |    |    |    |    |
 |    |    |    |    +----- day of week (0 - 6) (Sunday=0)
 |    |    |    +---------- month (1 - 12)
 |    |    +--------------- day of month (1 - 31)
 |    +-------------------- hour (0 - 23)
 +------------------------- min (0 - 59)

次の名前付きエントリを使用できます:

• Day of Week: sun, mon, tue, wed, thu, fri, sat.
• Month: jan, feb, mar, apr, may, jun, jul, aug, sep, oct, nov, dec.

各フィールド間には単一のスペースが必要です。各フィールドの値は、次のもので構成できます:

1. (オプション) Delay execution を有効にすることで、クエリの開始時刻を遅延させることができます。

クエリを実行する

クエリに名前を付けて保存して実行するか、単にクエリを実行します。クエリが正常に完了すると、クエリ結果は指定された宛先に自動的にエクスポートされます。

(オプション) Delay execution を有効にすることで、クエリの開始時刻を遅延させることができます。

Workflow でエクスポート結果をオプションで設定する

Treasure Workflow 内で、この統合を使用してデータをエクスポートするように指定できます。

詳細は パラメータを使用したデータのエクスポートを参照してください。

timezone: UTC

_export:
  td:
    database: sample_datasets

+td-result-into-target:
  td>: queries/sample.sql
  result_connection: facebook_conversions
  result_settings:
    test_event_code: 361738844830373
    skip_invalid: false