Skip to content
Last updated

Facebook Offline Conversions Export Integration CLI

この機能はベータ版です。詳細については、カスタマーサクセス担当者にお問い合わせください。

Facebook Offline Conversions BETAを使用して、Treasure Dataから直接FacebookにジョブResult(オフラインイベントデータの形式)を送信し、Facebookの広告が店舗での購入、電話注文、予約など、実世界でどの程度の成果をもたらしているかを測定できます。

前提条件

  • Treasure Dataの基本的な知識

  • Facebook Offline ConversionsとFacebook Offline Eventの基本的な知識

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

    • Business Manager管理者
    • Offline Event Setを作成したAdmin System User
    • Offline Event Setに接続されているad_accountの管理者

コマンドラインからの接続の作成

CLIを使用して接続を設定できます。

td query --database your_database --result configuration query

次の表は、設定キーとその説明を示しています。

Config KeyTypeRequiredDescription
typestringyesfacebook_offline_conversions
access_tokenstringYesシステムユーザーまたはlong-livedアクセストークン
app_secretstringNoFacebookアプリシークレット
event_set_idlongYesFacebook offline event set ID
upload_tagstringYesイベントアップロードを追跡するために使用
match_keysstringYesFacebook上でユーザーとマッチングするために使用される識別情報。カンマ区切りの文字列で指定します。例: email,phone,fn,ln,st,country…
namespace_idlongNoextern_idまたはtpidを解決するために使用されるスコープ。別のデータセットまたはデータパートナーIDを指定できます。例: 12345
skip_invalidbooleanNo無効なレコードが検出された場合にジョブを終了する(revertなし)ために使用。例えば、レコードに必須列(event_nameevent_timeなど)が欠けている場合
retry_limitintNo各API呼び出しの最大リトライ回数。デフォルト: 6
initial_retry_wait_msecslongNo最初のリトライの待機時間。デフォルト: 60000ミリ秒
max_retry_wait_msecslongNoリトライ間の最大待機時間。デフォルト:30000ミリ秒
connection_timeout_secslongNoAPI呼び出し時の接続タイムアウト時間。デフォルト: 300
write_timeout_secslongNoリクエストへのデータ書き込みの待機時間。デフォルト: 180
read_timeout_secslongNoレスポンスからのデータ読み取りの待機時間。デフォルト: 60

例: クエリの実行とOffline Event Setへの結果のエクスポート

td query --database my_db \
--result '{
           "type": "facebook_offline_conversions",
           "access_token": "xxx"
           "app_secret": "yyy"
           "event_set_id: 361738844830373,
           "upload_tag": "store_data"
         }' \
'SELECT email, fn, ln, event_time, event_name, value, currency from your_table'

サポートされているクエリカラム名について詳しく学んでください。

実行のスケジュール設定

以下を必ずご確認ください: