{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ja/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"JSONイベントプロパティの取り込み - JSONリマッピング","description":"JSONイベントプロパティの取り込み時に、ネストされたフィールドをトップレベルに簡単に昇格させる方法を解説します。Real-Timeパイプラインでのデータアクセスを効率化します。","siteUrl":"https://docs.treasure.ai","lang":"en-US","jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://www.treasure.ai/","name":"Treasure AI","url":"https://www.treasure.ai/","logo":"https://www.treasure.ai/hubfs/assets/images/logos/primary-logo.svg"},{"@type":"WebSite","@id":"https://docs.treasure.ai/#website","name":"Treasure AI Documentation","url":"https://docs.treasure.ai/","inLanguage":["en","ja"],"publisher":{"@id":"https://www.treasure.ai/"}}]},"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":"jsonイベントプロパティの取り込み---jsonリマッピング","__idx":0},"children":["JSONイベントプロパティの取り込み - JSONリマッピング"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["JSON Ingest Remapping"]},"機能により、お客様は深くネストされたJSONフィールドを抽出し、Real-Timeパイプラインへの取り込み時にトップレベルに昇格させることができます。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["これにより、これらのフィールドは、上流でのフラット化、Lambda関数、またはカスタムETLを必要とせずに、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["トリガー、パーソナライゼーション、Reactor、Plazma"]},"を含むリアルタイムワークフローで直接アクセス可能になります。"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"使用するタイミング","__idx":1},"children":["使用するタイミング"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["次の場合にJSON Ingest Remappingを使用します。"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Real-Time取り込みパイプラインにネストされたJSONイベントが送られてくる場合"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["セグメンテーション、トリガー、またはパーソナライゼーションルールで内部フィールド(例: user.id、order.details.totalなど)を使用したい場合"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["データを上流でフラット化したり、ソースシステムを変更したりするコストと複雑さを回避したい場合"]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"動作の仕組み","__idx":2},"children":["動作の仕組み"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["以下を指定する",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["マッピングルール"]},"を定義します。"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ソースフィールドパス(ネストされたJSON内)"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["抽出された値を保持する新しいトップレベルフィールドの名前"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["これらのルールは、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Real-Time API"]},"を介して設定され、database.table単位で適用されます。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["適用されると、テーブルに一致し、ネストされたパスを含む受信イベントには、取り込み時にトップレベルプロパティとしてリマップされたフィールドが注入されます。"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"セットアップ手順","__idx":3},"children":["セットアップ手順"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["アカウントの有効化(1回のみ)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["この機能はフラグの背後でゲートされています。カスタマーサクセスマネージャーまたはTreasure サポートに連絡して、アカウントで有効にしてもらってください。"]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["APIを介してマッピングを設定"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["PUT /event_property_remappingsエンドポイントを使用します:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["リクエストの例:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X PUT 'https://realtime-api.treasuredata.com/event_property_remappings' \\\n--header 'Authorization: TD1 <your_apikey>' \\\n--header 'Content-Type: application/json' \\\n--data '\n{\n  \"event_property_remappings\": [\n    {\n      \"database\": \"demo\",\n      \"table\": \"customers\",\n      \"source_property_path\": \"order.details.total\",\n      \"target_property\": \"order_total\"\n    }\n  ]\n}'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["DigdagまたはWorkflowを介してこれを自動化することもできます。"]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":3},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["イベントの取り込み"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["[Ingest API]または[Personalization API]を介して通常どおりイベントを取り込みます。リマップされたフィールドは、トップレベルに自動的に注入されます。"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["入力の例:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"order\": {\n    \"details\": {\n      \"total\": 149.99\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["リマッピング後の結果:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"order\": {\n    \"details\": {\n      \"total\": 149.99\n    }\n  },\n  \"order_total\": 149.99\n}\n","lang":"json"},"children":[]}]},"headings":[{"value":"JSONイベントプロパティの取り込み - JSONリマッピング","id":"jsonイベントプロパティの取り込み---jsonリマッピング","depth":1},{"value":"使用するタイミング","id":"使用するタイミング","depth":1},{"value":"動作の仕組み","id":"動作の仕組み","depth":1},{"value":"セットアップ手順","id":"セットアップ手順","depth":2}],"frontmatter":{"seo":{"title":"JSONイベントプロパティの取り込み - JSONリマッピング","description":"JSONイベントプロパティの取り込み時に、ネストされたフィールドをトップレベルに簡単に昇格させる方法を解説します。Real-Timeパイプラインでのデータアクセスを効率化します。"}},"lastModified":"2026-06-22T01:38:52.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ja/products/customer-data-platform/real-time/ingesting-json-event-properties-json-remapping","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}