Attributes

複合属性は、inner attributesと呼ばれる他の属性を含む属性です。複合属性は、関連する属性をグループ化するために使用されます。たとえば、Searchでは、複合属性rfk_statsを使用して、サイト統計に関連する属性をグループ化します。

rfk_statsの内部属性はstatistical attributesとも呼ばれる。これらは、1 Day Views、7 Days Searches、90 Days Clicksなどのデータを表します。

どの属性が複合であるかを確認するには、Domain SettingsのAttributesタブにある属性のリストのData type列を表示します。

新しい複合属性を追加することはできません。既存の内部属性を編集can 。これは、たとえば、トップビューで並べ替えるオプションを追加する場合に行うことができます。

エンティティに可能なすべての属性を定義したくない場合は、動的属性を使用できます。これらは、エンティティに関する動的情報を含むキーと値のペアのコレクションです。これらの使用を開始するには、動的属性を作成し 、ソースを設定する必要があります。

現在の属性は、AdministrationページのDomain SettingsセクションのAttributesタブで表示できます。属性は、表形式のリストで表示名のアルファベット順に表示されます。リストは、上部の検索バーを使用してDisplay NameとAttribute Nameで検索できます。属性のリストを特定のエンティティの属性のみに制限するには、Entityドロップダウン メニューで選択します。

このビューの属性ごとに、scopeが表示されます。以下に、可能なscope値をリストします。

属性プロパティは、編集ダイアログで指定できます。属性が受け入れることができる値の型を定義するだけでなく、次のプロパティは、その表示形式と使用法も制御します。

Searchで属性を作成するときは、属性にデータ型を割り当てます。 属性の値を抽出する場合は、指定されたデータ型に対してSearchが認識する形式で値を抽出することが重要です。

次の表に、各型でサポートされているデータ型と形式を示します。

{
  "name": "Alice",
  "age": 30
}

[
  {
    "name": "Bob",
    "age": 25
  },
  {
    "name": "Carol",
    "age": 28
  }
]

APIで属性を返すようにした後、Administration > Domain Settings > Feature Configuration > API responseをクリックして設定できます。

属性のReturn in api responseチェックボックスをオンにするだけで、検索結果に属性を含めることができます。オプションで、属性値を返すためのカスタム形式を設定することもできます。たとえば、価格を表す型floatの属性があるとします。この属性の値は、15.6のようになります。サイト訪問者に通貨値として表示するには、文字列に変換し、通貨記号を追加して $15.60にします。

APIレスポンスの属性の型変換は、次の設定オプションを使用して設定します。