{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ja/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Branch Metrics Import Integration","description":"Treasure Data Product Documentation · Collect and Unify · Segment and Activate · Experiment and Analyze · Decisioning Automate with AI Scale and Trust.","siteUrl":"https://docs.treasuredata.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"branch-metrics-import-integration","__idx":0},"children":["Branch Metrics Import Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://branch.io/"},"children":["Branch"]},"は、主要ブランド向けのリンクインフラストラクチャで、モバイル広告キャンペーンのシームレスなトラッキングを可能にします。webhookを通じてBranchのモバイルイベントをTreasure Dataと統合することで、モバイルデータを直接Treasure Dataに取り込み、包括的な分析を行うことができます。この連携により、すべての関連するモバイルイベントがTreasure Dataにキャプチャされ、保存されることが保証されます。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"branchトラッキングイベントの概要","__idx":1},"children":["Branchトラッキングイベントの概要"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["BranchはAndroidおよびiOS SDKを通じたイベントトラッキングをサポートしており、以下のイベントタイプを自動的に収集します:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Install"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Reinstall"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Impression"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Custom Events"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Content Events"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Lifecycle Events"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Subscription and In-App Purchase Events"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["これらのイベントは、BranchのWebhook機能とTreasure Data Ingest APIを使用してTreasure Dataに転送でき、Treasure Data CDP内でモバイルデータの価値を最大化することができます。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["イベントの詳細については、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://help.branch.io/developers-hub/docs/track-branch-events"},"children":["Branch Event Documentation"]},"を参照してください。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"イベントデータ構造","__idx":2},"children":["イベントデータ構造"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["イベントの包括的なリスト、フィールド定義、データ型、およびイベントタイプ別のフィールド可用性については、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://help.branch.io/developers-hub/docs/branch-event-ontology#full-list-of-fields"},"children":["Branch Event Ontology"]},"を参照してください。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"branch-consoleでのpostback連携の設定","__idx":3},"children":["Branch ConsoleでのPostback連携の設定"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Branch ConsoleでWebhook設定を行うには、以下の手順に従ってイベントがTreasure Dataにリアルタイムで転送されるようにします:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"treasure-data-write-only-api-keyの生成","__idx":4},"children":["Treasure Data Write-Only API Keyの生成"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treasure Dataでは、データインポート時の認証にWrite-Only API Keyが必要です。このキーを生成するには:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Treasure コンソールでMy Profileに移動します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["API Keyタブを選択します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Write-Only API Keyを生成します。詳細については、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.treasuredata.com/smart/project-product-documentation/getting-your-api-keys"},"children":["Generating API Keys"]},"を参照してください。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"アプローチ1-ネイティブwebhook連携","__idx":5},"children":["アプローチ1: ネイティブWebhook連携"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["BranchはTreasure Dataとのネイティブ連携をサポートしており、IMPRESSION、CLICK、OPEN、INSTALL、REINSTALL、USER_LIFECYCLE_EVENT、CONTENT_EVENT、COMMERCE_EVENT、CUSTOM_EVENTなどのイベントがBranchのWebhookとTreasure Data Postback APIを通じて直接送信されます。"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["設定するには、Branch ConsoleのData Feeds > Data Integration > Treasure Dataに移動します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Treasure Data Write-Only API Keyと宛先データベースを入力します。"]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["このアプローチは現在、US地域のみでサポートされています。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"アプローチ2-カスタムwebhook連携","__idx":6},"children":["アプローチ2: カスタムWebhook連携"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["アプローチ1でカバーされていないイベント(例: ADD_TO_CARTイベント、またはTreasure DataインスタンスがEU01地域やその他の地域にある場合)については、カスタムWebhookを設定する必要があります。この連携により、パートナー連携と同じデータを収集できます。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"設定---webhook-url","__idx":7},"children":["設定 - Webhook URL"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["WEBHOOK URLメニューでは、イベントの送信先URLを入力できます。このURLはFree Form Editオプションで記述できます。"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Webhook URLフィールドを使用して、BranchイベントをどこにDELIVERするかを指定します。Free Form Editオプションでカスタマイズします。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Webhook URLフィールドを使用して、Branchイベントの送信先を指定します。Free Form Editオプションでカスタマイズできます。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["適切なTreasure Dataリージョンのingestエンドポイントを選択してください:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["USリージョン: https://in.treasuredata.com/postback/v3/event/<database_name>/<table_name>"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["EU01リージョン:  https://eu01.in.treasuredata.com/postback/v3/event/<database_name>/<table_name>"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Tokyoリージョン: https://tokyo.in.treasuredata.com/postback/v3/event/<database_name>/<table_name>"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Koreaリージョン: https://ap02.in.treasuredata.com/postback/v3/event/<database_name>/<table_name>"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["AP03リージョン: https://ap03.in.treasuredata.com/postback/v3/event/<database_name>/<table_name>"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["*<database_name>",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["と"]},"<table_name>*を、Treasure Data内で使用するデータベース名とテーブル名に置き換えてください。"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["詳細については、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/postback/quickstart"},"children":["Treasure Data Postback APIドキュメント"]},"を参照してください。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"設定---filters","__idx":8},"children":["設定 - FILTERS"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["すべてのトリガーイベントにPOSTメソッドを使用します。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["HEADERSセクションには、次のパラメータを含めてください:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Key"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Value"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Content-Type"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["application/json"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["X-TD-Write-Key"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your WRITE APIKEY"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treasure DataはJSON形式のデータを期待します。必要に応じて、カスタムデータ構文にBranchのマクロ機能を使用することもできます。本番稼働前にイベントの取り込みをテストすることを推奨します。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"データ検証とテスト","__idx":9},"children":["データ検証とテスト"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["データ取り込みを検証するには(例: iOS):"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Branchは",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://github.com/BranchMetrics/branch-ios-sdk-samples/tree/main"},"children":["iOSサンプルコード"]},"を提供しています。このサンプルコードをテストAPIキーと共に使用して、実機またはシミュレートされたiPhoneデバイスからイベントを送信できます。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["送信されたイベントについて、Treasure DataのRecent Recordsセクションを確認してください。データは通常3〜5分以内に表示されます。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Treasure Dataでクエリを作成してイベントを検証します。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"よくある質問","__idx":10},"children":["よくある質問"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Q. テーブルの「time」カラムとは何ですか?"," ","A. Treasure Dataは、受信イベントにtimeフィールドが含まれていない場合、UNIXタイムスタンプを自動的に追加します。このタイムスタンプは、Treasure Dataサーバーがイベントリクエストを受信した時刻を表します。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Q. Treasure DataとBranch間でユーザーをどのように紐付けできますか?"," ","A. Treasure Dataでは、Branchのユーザートラッキングフィーチャーを使用して、CRM ID、メールアドレス、またはその他の識別子を含めることを推奨しています。これにより、Treasure DataとBranch間で統合されたID解決が可能になります。詳細については、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://help.branch.io/developers-hub/docs/ios-advanced-features#set-initialization-metadata"},"children":["Branchユーザートラッキングドキュメント"]},"を参照してください。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Q. WebhookのためにIPホワイトリストを設定する必要がありますか?"," ","A. いいえ、Treasure DataのPostbackエンドポイントにはIPホワイトリストは必要ありません。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Q. カラム内のJSONフィールドをどのように解析できますか?"," ","A. Trinoを使用して、次のクエリ例でJSONデータを抽出できます:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"SQL","header":{"controls":{"copy":{}}},"source":"SELECT\n  JSON_EXTRACT_SCALAR(JSON_PARSE(event_data), '$.currency') AS currency\nFROM\n  add_cart_live;\n","lang":"SQL"},"children":[]}]},"headings":[{"value":"Branch Metrics Import Integration","id":"branch-metrics-import-integration","depth":1},{"value":"Branchトラッキングイベントの概要","id":"branchトラッキングイベントの概要","depth":2},{"value":"イベントデータ構造","id":"イベントデータ構造","depth":2},{"value":"Branch ConsoleでのPostback連携の設定","id":"branch-consoleでのpostback連携の設定","depth":2},{"value":"Treasure Data Write-Only API Keyの生成","id":"treasure-data-write-only-api-keyの生成","depth":3},{"value":"アプローチ1: ネイティブWebhook連携","id":"アプローチ1-ネイティブwebhook連携","depth":3},{"value":"アプローチ2: カスタムWebhook連携","id":"アプローチ2-カスタムwebhook連携","depth":3},{"value":"設定 - Webhook URL","id":"設定---webhook-url","depth":4},{"value":"設定 - FILTERS","id":"設定---filters","depth":4},{"value":"データ検証とテスト","id":"データ検証とテスト","depth":2},{"value":"よくある質問","id":"よくある質問","depth":2}],"frontmatter":{"seo":{"title":"Branch Metrics Import Integration"}},"lastModified":"2026-06-01T09:34:27.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ja/int/branch-metrics-import-integration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}