{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ja/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Audience APIを使用したアトリビュートグルーピングの作成","description":"Audience APIを使用してアトリビュートグルーピングを作成する方法を解説。セグメントオブジェクトの属性設定と`groupingName`の活用を詳しく説明します。","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":"audience-apiを使用したアトリビュートグルーピングの作成","__idx":0},"children":["Audience APIを使用したアトリビュートグルーピングの作成"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["アトリビュートグルーピングは、Treasure Dataのペアレントセグメントオブジェクトに含まれる",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["attributes"]},"オブジェクトの",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["groupingName"]},"フィールドの値によって定義されます。デフォルトでは、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["groupingName"]},"はNULLに設定されています。ただし、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["groupingName"]},"が文字列値に設定されている場合、その名前でTreasure コンソールにアトリビュートグルーピングが作成されます。",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["groupingName"]},"にその文字列が指定されている",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["attributes"]},"オブジェクトは、すべてアトリビュートグルーピングに含まれます。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["この記事の最後にある図1には、ペアレントセグメントオブジェクトの完全なリストがあります。オブジェクトの",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["attributes"]},"(つまり、セグメントのテーブルカラム)は34行目から始まります。",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["attributes"]},"オブジェクトで記述されている両方のオブジェクトの",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["groupingName"]},"が",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},"に設定されていることに注意してください(47行目と61行目)。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"    34:   \"attributes\":[\n    35:      {\n    36:         \"audienceId\":\"12345\",\n    37:         \"id\":\"56662\",\n    38:         \"name\":\"c1-test\",\n    39:         \"type\":\"string\",\n    40:         \"parentDatabaseName\":\"_mobile_sdk\",\n    41:         \"parentTableName\":\"android\",\n    42:         \"parentColumn\":\"c1\",\n    43:         \"parentKey\":\"c0\",\n    44:         \"foreignKey\":\"c_comment\",\n    45:         \"matrixColumnName\":\"c1\",\n    46:         \"usedBySegmentInsight\":false,\n    47:         \"groupingName\": null\n    48:      },\n    49:      {\n    50:         \"audienceId\":\"12345\",\n    51:         \"id\":\"56663\",\n    52:         \"name\":\"c2-test\",\n    53:         \"type\":\"string\",\n    54:         \"parentDatabaseName\":\"_mobile_sdk\",\n    55:         \"parentTableName\":\"android\",\n    56:         \"parentColumn\":\"activity_date\",\n    57:         \"parentKey\":\"c0\",\n    58:         \"foreignKey\":\"c_comment\",\n    59:         \"matrixColumnName\":\"activity_date\",\n    60:         \"usedBySegmentInsight\":false,\n    61:         \"groupingName\": null\n    62:      }\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ただし、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["groupingName"]},"が例えば",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["wtt_test"]},"に変更された場合(47行目に示されているように)、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["wtt_test"]},"という名前のアトリビュートグルーピングが作成されます。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"    35:      {\n    36:         \"audienceId\":\"12345\",\n    37:         \"id\":\"56662\",\n    38:         \"name\":\"c1-test\",\n    39:         \"type\":\"string\",\n    40:         \"parentDatabaseName\":\"_mobile_sdk\",\n    41:         \"parentTableName\":\"android\",\n    42:         \"parentColumn\":\"c1\",\n    43:         \"parentKey\":\"c0\",\n    44:         \"foreignKey\":\"c_comment\",\n    45:         \"matrixColumnName\":\"c1\",\n    46:         \"usedBySegmentInsight\":false,\n    47:         \"groupingName\": 'wtt_test'\n    48:      },\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/attrgrpconsole.8ba1bace301a487115dfa39b431161fb6283d15b6c5ddba5e12cd23cc259e326.cf3845cb.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"アトリビュートグルーピングの作成","__idx":1},"children":["アトリビュートグルーピングの作成"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["アトリビュートグルーピングを作成するには、3つのステップがあります:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["ペアレントセグメントIDの取得"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["ペアレントセグメントオブジェクトの取得"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["groupingName"]},"を使用したペアレントセグメントオブジェクトのパッチ"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ペアレントセグメントidの取得","__idx":2},"children":["ペアレントセグメントIDの取得"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["作業対象のペアレントセグメントのIDを取得する方法は2つあります。Treasure コンソールを使用する方法と、Audience APIコールを行う方法です。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treasure コンソールで、Audience Studioに移動し、作業対象のペアレントセグメントを選択します。セグメントIDは、URLの",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/app/ps/"]},"というテキストの後に記載されています。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/consoleps.9dfc3a18810682c0a90f219583260a7d0f491393f806376ee59f821b4ae3f2a3.cf3845cb.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["または、すべてのペアレントセグメントを表示するためのAudience APIコールを行うと、すべてのペアレントセグメントの",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]},"と",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]},"がレスポンスの一部として返されます。例えば、以下に示すようなコールを実行できます。レスポンスはフォーマットされていないJSONで返されます。ただし、この例では、レスポンスが編集され、読みやすくフォーマットされています。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"$ curl -H 'AUTHORIZATION: TD1 1/1234567891234567891234567891234567891234' 'https://api-cdp.treasuredata.com/audiences/'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n   \"id\":\"12345\",\n   \"name\":\"Attribute Grouping\",\n   \"description\":\"Contains grouping names set through Audience API.\",\n   \"scheduleType\":\"none\",\n   \"scheduleOption\":null,\n    .\n    .\n    .\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["レスポンスに多数のペアレントセグメントがある場合、出力を簡素化する1つの戦略は、フォーマットしてからidと",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]},"でフィルタリングすることです。これを実現する方法の例を以下に示します。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -H 'AUTHORIZATION: TD1 1/1234567891234567891234567891234567891234' 'https://api-cdp.treasuredata.com/audiences/' | python -m json.tool | grep '^\\s\\s\\s\\s\\s\\s\\s\\s\\\"id\\|^\\s\\s\\s\\s\\s\\s\\s\\s\\\"name'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"% Total    % Received % Xferd  Average Speed   Time    Time     Time  CurrentDload  Upload   Total   Spent    Left  Speed\n100 1188k    0 1188k    0     0  81378      0 --:--:--  0:00:14 --:--:--  323k\n\"id\": \"12345\",\n\"name\": \"Attribute Grouping\",\n\"id\": \"23456\",\n\"name\": \"PS1\",\n\"id\": \"34567\",\n\"name\": \"PS2\",\n\"id\": \"45678\",\n\"name\": \"Test Segment\",\n    .\n    .\n    .\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ペアレントセグメントオブジェクトの取得","__idx":3},"children":["ペアレントセグメントオブジェクトの取得"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ペアレントセグメントIDを取得したら、ペアレントセグメントオブジェクトを取得できます。以下の例では、ペアレントセグメントオブジェクトIDは",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["12345"]},"です。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -H 'AUTHORIZATION: TD1 1/1234567891234567891234567891234567891234' https://api-cdp.treasuredata.com/audiences/12345\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["レスポンスはフォーマットされていないJSONとして返されます。JSONフォーマットツールを使用してレスポンスを読みやすくすることが役立ちます。例えば、Pythonの",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["json.tool"]},"を使用してレスポンスをフォーマットする例を以下に示します。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"$ curl -H 'AUTHORIZATION: TD1 1/1234567891234567891234567891234567891234' 'https://api-cdp.treasuredata.com/audiences/12345' | python -m json.tool\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["groupingName"]},"を使用したペアレントセグメントオブジェクトのパッチ"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ペアレントセグメントオブジェクトを取得したら、レスポンスを編集し、グルーピングに含めたい1つ以上のアトリビュートの",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["groupingName"]},"の",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},"設定を変更できます。",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["groupingName"]},"に指定する文字列値が、アトリビュートグルーピングの名前になります。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ペアレントセグメントオブジェクトの編集が完了したら、この編集されたオブジェクトをPATCHリクエストのリクエストペイロードとして使用します。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["複数の埋め込みオブジェクトを含む大きなフォーマットされていないJSONオブジェクトは、扱いにくい場合があります。そのため、リクエストペイロードとして使用されるペアレントセグメントオブジェクトはフォーマットされ、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["attrGroupingRequest.json"]},"という名前のファイルに保存されています(以下の図1を参照)。ファイルを必要に応じて編集した後、次のようなPATCHリクエストにファイルを含めることができます:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"$ curl --location --request PATCH -H 'AUTHORIZATION: TD1 1/1234567891234567891234567891234567891234' -H 'Content-Type: application/json' -d @attrGroupingRequest.json https://api-cdp.treasuredata.com/audiences/12345\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"アトリビュートグルーピングの変更","__idx":4},"children":["アトリビュートグルーピングの変更"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["アトリビュートグルーピングの変更は、ペアレントセグメントオブジェクトを編集し、必要に応じて",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["groupingName"]},"の値を変更することで構成されます。すべてのアトリビュートグルーピングからカラムを削除するには",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},"に変更するか、名前を別のアトリビュートグルーピングに変更して、事実上カラムを新しいアトリビュートグルーピングに移動できます。ペアレントセグメントオブジェクトを変更した後、変更されたオブジェクトを使用してPATCHリクエストを送信します。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"アトリビュートグルーピングの削除","__idx":5},"children":["アトリビュートグルーピングの削除"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["アトリビュートグルーピングを削除するには、ペアレントセグメントオブジェクトを編集し、削除したいアトリビュートグルーピングの名前を削除します。",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["groupingName"]},"のすべてのインスタンスから名前を削除します。ほとんどの場合、値を単に",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},"に変更します。ペアレントセグメントオブジェクトを変更した後、新しいオブジェクトを使用してPATCHリクエストを送信します。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["図1: ペアレントセグメントオブジェクトを含むattrGroupingRequest.jsonのファイルリスト"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": \"12345\",\n  \"name\": \"Attribute Grouping\",\n  \"description\": \"Contains grouping names set through Audience API.\",\n  \"scheduleType\": \"none\",\n  \"scheduleOption\": null,\n  \"timezone\": \"UTC\",\n  \"createdAt\": \"2022-02-10T19:17:45.107Z\",\n  \"updatedAt\": \"2022-02-10T19:17:45.107Z\",\n  \"createdBy\": {\n    \"id\": \"111\",\n    \"td_user_id\": \"4567\",\n    \"name\": \"firstName lastName\"\n  },\n  \"updatedBy\": {\n    \"id\": \"3210\",\n    \"td_user_id\": \"45678\",\n    \"name\": \"Me\"\n  },\n  \"matrixUpdatedAt\": \"2022-02-10T19:25:09.676Z\",\n  \"workflowHiveOnly\": false,\n  \"hiveEngineVersion\": \"cdpaudience\",\n  \"hivePoolName\": null,\n  \"prestoPoolName\": null,\n  \"population\": 150000,\n  \"enrichmentWordTaggingEnabled\": true,\n  \"enrichmentIpEnabled\": true,\n  \"enrichmentTdJsSdkEnabled\": true,\n  \"rootFolderId\": \"987654\",\n  \"master\": {\n    \"parentDatabaseName\": \"test_db_1\",\n    \"parentTableName\": \"sample\"\n  },\n  \"attributes\": [\n    {\n      \"audienceId\": \"12345\",\n      \"id\": \"56662\",\n      \"name\": \"c1-test\",\n      \"type\": \"string\",\n      \"parentDatabaseName\": \"_mobile_sdk\",\n      \"parentTableName\": \"android\",\n      \"parentColumn\": \"c1\",\n      \"parentKey\": \"c0\",\n      \"foreignKey\": \"c_comment\",\n      \"matrixColumnName\": \"c1\",\n      \"usedBySegmentInsight\": false,\n      \"groupingName\": null\n    },\n    {\n      \"audienceId\": \"12345\",\n      \"id\": \"56663\",\n      \"name\": \"c2-test\",\n      \"type\": \"string\",\n      \"parentDatabaseName\": \"_mobile_sdk\",\n      \"parentTableName\": \"android\",\n      \"parentColumn\": \"activity_date\",\n      \"parentKey\": \"c0\",\n      \"foreignKey\": \"c_comment\",\n      \"matrixColumnName\": \"activity_date\",\n      \"usedBySegmentInsight\": false,\n      \"groupingName\": null\n    }\n  ],\n  \"behaviors\": [\n    {\n      \"audienceId\": \"12345\",\n      \"id\": \"23456\",\n      \"name\": \"Orders\",\n      \"parentDatabaseName\": \"test_db_1\",\n      \"parentTableName\": \"orders\",\n      \"parentKey\": \"o_custkey\",\n      \"foreignKey\": \"c_custkey\",\n      \"matrixDatabaseName\": \"audience_76543\",\n      \"matrixTableName\": \"behavior_orders\",\n      \"allColumns\": false,\n      \"scheduleType\": \"none\",\n      \"scheduleOption\": null,\n      \"defaultTimeFilterEnabled\": true,\n      \"filterRule\": {},\n      \"schema\": [\n        {\n          \"name\": \"o_clerk\",\n          \"type\": \"string\",\n          \"parentColumn\": \"o_clerk\",\n          \"matrixColumnName\": \"o_clerk\"\n        }\n      ]\n    }\n  ]\n}\n","lang":"json"},"children":[]}]},"headings":[{"value":"Audience APIを使用したアトリビュートグルーピングの作成","id":"audience-apiを使用したアトリビュートグルーピングの作成","depth":1},{"value":"アトリビュートグルーピングの作成","id":"アトリビュートグルーピングの作成","depth":1},{"value":"ペアレントセグメントIDの取得","id":"ペアレントセグメントidの取得","depth":2},{"value":"ペアレントセグメントオブジェクトの取得","id":"ペアレントセグメントオブジェクトの取得","depth":2},{"value":"アトリビュートグルーピングの変更","id":"アトリビュートグルーピングの変更","depth":1},{"value":"アトリビュートグルーピングの削除","id":"アトリビュートグルーピングの削除","depth":1}],"frontmatter":{"seo":{"title":"Audience APIを使用したアトリビュートグルーピングの作成","description":"Audience APIを使用してアトリビュートグルーピングを作成する方法を解説。セグメントオブジェクトの属性設定と`groupingName`の活用を詳しく説明します。"}},"lastModified":"2026-06-17T07:22:53.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ja/products/customer-data-platform/audience-studio/segment/using-audience-api-to-create-attribute-groupings","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}