Facebook Custom Audience 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 Custom Audience に直接書き込むことができます。

Custom Audience をアップロードまたは作成する際、Facebook では Custom Audience Terms への同意が必要です。カスタマーファイルをターゲットとする広告オブジェクトをエクスポートする場合、または Value-based Custom Audiences をエクスポートする場合に通知が表示されます。Facebook Custom Audience の利用規約に関する通知は、その後 90 日ごとに表示されます。詳細については、Better Facebook Ads ROI with Data-Driven Custom Audiences を参照してください。

ジョブ結果を Facebook Custom Audience に書き込む方法のサンプルワークフローについては、Treasure Boxes を参照してください。

前提条件

• TD Toolbelt を含む Treasure Data の基本知識
• Facebook 広告アカウント
• Facebook 広告アカウントへの Treasure Data Facebook アプリのアクセス許可
  • 広告アカウントの役割として、管理者または広告主が必要です
• オプション: Access Token および App Secret

(オプション) Access Token の取得または生成

System User Access Token

1. Facebook Business Manager にログインし、システムユーザーを作成します。

2. 新しいシステムユーザーを選択し、そのユーザー用の新しいトークンを生成します。

   Treasure Data では、「有効期限なし」のトークンを生成することを推奨しています。

1. 以下の権限を付与します:

• ads_management

• ads_read

• pages_manage_ads

• pages_manage_metadata

• pages_read_engagement

• pages_read_user_content

• read_insights

Facebook への接続用の Access Token を生成できない場合は、System Users on Business Management APIs を参照してください。

サポートされている Facebook データの正規化とハッシュ化の要件

Facebook にデータを送信する前に、データは ソルトなしの SHA256 でハッシュ化する 必要があります (ソルトとは、データをハッシュ化する一方向関数への追加入力として使用されるランダムデータです)。この要件は、External Identifiers、App User IDs、および Page Scoped User IDs を除くすべてのデータに適用されます。

データを送信する前にデータの準備 (正規化とハッシュ化) を行う場合は、オプション No need to normalize and hash records を True に設定できます。

Treasure Data の結果出力は、Facebook の正規化ルールに従って値を自動的に正規化します。

Facebook にアップロードしてマッチングを行うすべての値は、Facebook の正規化ルールを使用して正規化する必要があります。正規化されていない場合、値のマッチング機会が失われます。データを手動で正規化する必要がある場合は、出力結果を生成する前に独自の正規化を適用してください。

Facebook の Marketing API のパラメータに渡される顧客情報の値について詳しく学んでください。

データタイプに応じて、結果出力の作成中に以下の変換動作が適用されます。

TD Console を使用する

新しい Connection の作成

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

ターゲットプラットフォームにデータをエクスポートする前に、Facebook Custom Audience の認証を確立する必要があります。認証を作成する手順は次のとおりです。

1. TD Console を開きます。

2. Integrations Hub > Catalog に移動します。

3. Facebook Custom Audiences を検索して選択します。

4. Create Authentication を選択します。

5. Authentication Method で Access Token または Oauth のいずれかを選択します。

   

6. • Access Token: Access Token と App Secret を入力します。

   • Oauth: Facebook Custom Audiences の既存の OAuth 接続を選択するか、OAuth connection の下にある Click here リンクを選択して新しい接続を作成します。Facebook アカウントへのログインと Treasure Data コネクターアプリケーションへのアクセス許可を求められます。

   • Allow fetching Ads Account: このオプションを有効にすると、アクティベーション作成時に事前に入力されたドロップダウンから Ads Account を選択できます。

     Catalog にリダイレクトされた後、新しい OAuth 接続を選択します。

7. Continue を選択します。

8. 接続に名前を付けます。

9. Done を選択します。

クエリの定義

カラム名は大文字と小文字を区別しません。たとえば、email または EMAIL を使用できます。

出力結果は Facebook User schema に従う必要があります。サポートされているカラム名は次のとおりです。

• EXTERN_ID: External ID
• MADID: Mobile advertiser ID
• EMAIL: メールアドレス
• PHONE: 電話番号
• GEN: 性別
• DOBY: 生年（年）
• DOBM: 生月（月）
• DOBD: 誕生日（日）
• LN: 姓
• FN: 名
• FI: 名のイニシャル
• CT: 市区町村
• ST: 都道府県
• ZIP: 郵便番号
• COUNTRY: 国コード
• PAGEUID: Page scope user id
• LOOKALIKE_VALUE: value-based Custom Audience の値

クエリ結果にサポートされているカラムが見つからない場合は、エラーが発生します。

クエリデータの宛先へのエクスポート

1. Creating a Destination Integration の手順を完了します。
2. Data Workbench > Queries に移動します。
3. データをエクスポートするクエリを選択します。
4. クエリを実行して結果セットを検証します。
5. Export Results を選択します。
6. 既存の Integration Authentication を選択します。
7. 追加の Export Results の詳細を定義します。エクスポート統合コンテンツで、統合パラメータを確認します。 たとえば、Export Results 画面が異なる場合や、入力する追加の詳細がない場合があります。
8. Done を選択します。
9. クエリを実行します。
10. 指定した宛先にデータが移動したことを検証します。

Facebook Custom Audiences の統合パラメータ

Audience Studio での Facebook Custom Audiences の Ad Account ドロップダウンメニュー

Audience Studio のアクティベーション作成/編集画面で、Ad Account ID フィールドに手動入力の代わりに便利なドロップダウンメニューが追加されました。ユーザーがフィールドを選択すると、アクセス権のある Facebook Ad アカウントのリストが自動的に表示されます。ドロップダウンの各エントリには、簡単に識別できるように Ad Account ID とそれに関連付けられた名前（例: "106640720131327 - Nhien An"）の両方が表示されます。ユーザーは ID を手動で入力するのではなく、リストから目的のアカウントをクリックするだけでよく、入力エラーが減り、ユーザーエクスペリエンスが向上します。

クエリの例

クエリでエイリアスを使用して、クエリ結果のカラム名を変更できます。例：

SELECT
an_email_column AS EMAIL,
another_phone_column AS PHONE
FROM your_table;

以下は、クエリ結果の出力前のオーディエンスリストの例です：

Treasure Dataから、Facebook Custom Audienceへの接続に結果を出力して、以下のクエリを実行します：

SELECT email, fn, ln FROM (
  VALUES ('demo1@example.com', 'John', 'Doe'),
         ('demo2@example.com', 'Isaac', 'Miceli'),
         ('demo3@example.com', 'Christopher', 'Agar')
)  tbl (email, fn, ln)

またはPage scope user IDの場合：

SELECT
  pageuid
FROM (
  VALUES('2018728488162687') ,
        ('1785406501565085') ,
        ('2341287802551031') ,
        ('2487019361340533') ,
        ('1093039407464499')
  ) tbl (pageuid)

このクエリは実際のユーザーとは一致しません。デモ目的のみです。また、このクエリはソーステーブルを必要としませんが（この機能をテストしやすくするため）、データベースを選択する必要がありますので、「sample_datasets」または他の任意のテーブルを選択してください。Page scope user IDをアップロードするには、ページIDが必要です。例：ページID：136400506505739

クエリは数秒で完了するはずです。その後、オーディエンスリストを確認してください：

(オプション) 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 を有効にすることで、クエリの開始時刻を遅延させることができます。

広告配置の編集

Instagram Custom Audienceにユーザーリストを出力した後、

1. Facebook/Instagram Ads Managerを開いて広告配置を編集します。デフォルトでは、FacebookはInstagram広告内に表示することを選択します。

   

2. 自動配置（デフォルト）：

3. 配置の編集：

   

Business Managerへの広告アカウント追加エラーメッセージのトラブルシューティング

次のエラーが表示された場合：

This ad account is not connected to Business Manager. To create or edit a customer file Custom Audience, your admin needs to connect this ad account to a business account.

広告アカウントをBusiness Managerアカウントに追加する必要があります。

以下の手順に従ってください：

1. Business Managerアカウントを作成：https://www.facebook.com/business/help/1710077379203657

2. 広告アカウントを追加：https://www.facebook.com/business/help/910137316041095

   

3. 以下のいずれかを選択：

   パラメータ	説明
   広告アカウントを追加	広告アカウントを追加すると、アカウントは永続的にBusiness Managerに移行されます。広告アカウントを追加するには、広告アカウントの所有者であり、かつBusiness Managerの管理者である必要があります。広告アカウントを追加してBusiness Managerに移行した場合、その操作を元に戻すことはできません。また、広告アカウントのすべての管理は、Business Managerプロファイル内で完了する必要があることに注意してください。別のBusiness Managerが所有する広告アカウントは追加できません。それでも別のビジネスが所有する広告アカウントで作業したい場合は、そのアカウントへのアクセスをリクエストできます。
   広告アカウントへのアクセスをリクエスト	Business Manager内の広告アカウントへのアクセスをリクエストすると、そのBusiness Managerの管理者がそのアカウントで作業する権限を付与できます。
   新しい広告アカウントを作成	Business Managerで新しい広告アカウントを作成すると、そのアカウントは永続的にそのBusiness Managerに属します。Business Manager内で作成された広告アカウントは、Business Managerロールを所有していない個人の所有者に譲渡することはできません。

Workflowでのエクスポート結果の構成（オプション）

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

詳細については、TD Toolbeltを使用したWorkflowによるデータエクスポートを参照してください。