計算された属性 APIs

次の Customer Profiles 計算属性を使用できます。 APIs

CreateCalculatedAttributeDefinition

新しい計算された属性を作成します。これには、ドメイン内の既存のオブジェクトタイプが必要です。1 つのソースオブジェクトから取得する属性と、それらにまとめて適用する数学演算を定義できます。また、時間範囲やオブジェクト数も定義できます。

作成後、Customer Profiles に取り込まれた新しいオブジェクトデータは計算属性に含まれ、を使用してプロファイルに対して取得できますGetCalculatedAttributeForProfileAPI。計算された属性を定義すると、ドメイン内のすべてのプロファイルで使用できるようになります。計算された各属性は、そのから 1 つのフィールド ObjectType と最大 2 つのフィールドのみを参照できます ObjectType。

リクエスト


POST /domains/DomainName/calculated-attributes/CalculatedAttributeName



{
    "CalculatedAttributeName": "string",
    "DisplayName": "string",
    "Description": "string",
    "AttributeDetails": {
       "Attributes": [
           {
               "Name": "string"
           }
           ...
       ],
       "Expression": "string",
    },
    "Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE",
    "Conditions": {
        "Range": {
             "Value": "number",
             "Units": "string"
        },
        "ObjectCount": "number",
        "Threshold": {
            "Value": "string",
            "Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
        }
     },
     "Tags": {}
}

レスポンス



{
    "CalculatedAttributeName": "string",
    "DisplayName": "string",
    "Description": "string",
    "AttributeDetails": {
       "Attributes": [
           {
               "Name": "string"
           }
           ...
       ],
       "Expression": "string",
    },
    "Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE"
    "Conditions": {
        "Range": {
             "Value": "number",
             "Units": "string"
        },
        "ObjectCount": "number",
        "Threshold": {
            "Value": "string",
            "Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
        }
    },
    "CreatedAt": number,
    "LastUpdatedAt": number,
    "Tags": {}
}

リクエストボディ

CalculatedAttributeName

計算された属性の一意の (ドメインごとの) 名前。
- タイプ: 文字列
- 長さの制限：最小長は 1 です。最大長は 64 文字です。
- Pattern: ^[a-zA-Z0-9_-]+$
- 必須：はい
DisplayName

計算された属性の表示名。
- 長さの制限：最小長は 1 です。最大長は 64 文字です。
- パターン: ^[a-zA-Z_][a-zA-Z_0-9-\s]*$
- 必須: いいえ
説明

計算された属性の説明。
- タイプ: 文字列
- 長さの制限：最小長は 1 です。最大長は 1,000 です。
- 必須：いいえ
AttributeDetails

定義に使用されている属性と、属性間の算術演算の詳細。以下のコンポーネントを参照してください。
- 属性
  
  数式で指定された属性項目のリスト。
  - AttributeItem
    
    数式で指定された 1 つの属性項目の詳細。
    
    名前
    
    プロファイルオブジェクトタイプで定義される属性の名前。
    
    型: 文字列
- Expression
  
  属性リストに指定されている属性項目に対して実行される数式。式内の各要素は「{ObjectTypeName.AttributeName}」の構造に従う必要があります。
  - 例: {ObjA.AttributeA} - {ObjA.AttributeB}
  - タイプ: 文字列
  - 次の算術演算のみがサポートされています: + - * /
  - 計算された属性定義を作成した後は、式を変更することはできません。
条件

計算された属性集計基準としきい値を定義します。
- タイプ: 条件オブジェクト
  - [Range] (範囲)
  - ObjectCount
  - Threshold
[Range] (範囲)

データが集計に含まれる相対的な期間。
- タイプ: 範囲オブジェクト
  - 値: 指定した単位の時間の長さ
  - 単位: 時間の単位
    
    有効な値: 日
- 必須：はい
- 初期スコープ: 最大 366 日
ObjectCount

計算された属性に使用されるプロファイルオブジェクトの数。
- タイプ: 数値
- 範囲: 1 から 100
- 必須：いいえ
Threshold

true/false の計算された属性を生成する比較ロジック。
- タイプ: しきい値オブジェクト
  - 値
    
    しきい値の値
    
    型: 文字列
    
    必須: いいえ
  - 演算子
    
    しきい値の演算子
    
    タイプ: ENUM
    
    有効な値:
    
    GREATER_THAN
    
    LESS_THAN
    
    EQUAL_TO
    
    NOT_EQUAL_TO
- 必須：いいえ
Statistic

計算された属性に対して実行する集計操作。
- タイプ: ENUM
- 有効な値:
  - FIRST_OCCURRENCE
  - LAST_OCCURRENCE
  - COUNT
  - SUM
  - MINIMUM
  - MAXIMUM
  - AVERAGE
  - MAX_OCCURRENCE

UpdateCalculatedAttributeDefinition

計算された属性定義を更新します。更新は、表示名、説明、時間範囲、オブジェクト数、およびしきい値に制限されます。これにより部分的な更新APIがサポートされるため、更新が必要なパラメータのみを含める必要があります。

条件を更新する場合、計算属性の日付範囲を広げても、現在の日付範囲を超える履歴データは含まれないことに注意してください。

リクエスト


PUT /domains/DomainName/calculated-attributes/CalculatedAttributeName



{
    "DisplayName": "string",
    "Description": "string",
    "Conditions": {
        "Range": {
             "Value": "number",
             "Units": "string"
        },
        "ObjectCount": "number",
        "Threshold": {
            "Value": "string",
            "Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
        }
   }
}

レスポンス



{
    "CalculatedAttributeName": "string",
    "DisplayName": "string",
    "Description": "string",
    "AttributeDetails": {
       "Attributes": [
           {
               "Name": "string"
           }
           ...
       ],
       "Expression": "string",
    },
    "Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE"
    "Conditions": {
        "Range": {
             "Value": "number",
             "Units": "string"
        },
        "ObjectCount": "number",
        "Threshold": {
            "Value": "string",
            "Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
        }
    },
    "CreatedAt": number,
    "LastUpdatedAt": number,
    "Tags": {}
}

リクエストボディ

DisplayName

計算された属性の表示名。
- 長さの制限：最小長は 1 です。最大長は 64 文字です。
- パターン: ^[a-zA-Z_][a-zA-Z_0-9-\s]*$
- 必須: いいえ
説明

計算された属性の説明。
- タイプ: 文字列
- 長さの制限：最小長は 1 です。最大長は 1,000 です。
- 必須：いいえ
条件

計算された属性集計基準としきい値を定義します。
- タイプ: 条件オブジェクト
  - [Range] (範囲)
  - ObjectCount
  - Threshold
[Range] (範囲)

データが集計に含まれる相対的な期間。
- タイプ: 範囲オブジェクト
  - 値: 指定した単位の時間の長さ
  - 単位: 時間の単位
    
    有効な値: 日
- 必須：はい
- 初期スコープ: 最大 366 日
ObjectCount

計算された属性に使用されるプロファイルオブジェクトの数。
- タイプ: 数値
- 範囲: 1 から 100
- 必須：いいえ
Threshold

true/false の計算された属性を生成する比較ロジック。
- タイプ: しきい値オブジェクト
  - 値
    
    しきい値の値
    
    型: 文字列
    
    必須: いいえ
  - 演算子
    
    しきい値の演算子
    
    タイプ: ENUM
    
    有効な値:
    
    GREATER_THAN
    
    LESS_THAN
    
    EQUAL_TO
    
    NOT_EQUAL_TO
- 必須：いいえ

GetCalculatedAttributeDefinition

計算された属性定義を取得します。

リクエスト


GET /domains/DomainName/calculated-attributes/CalculatedAttributeName

リクエストボディ


The request does not have a request body.

レスポンス



{
    "CalculatedAttributeName": "string",
    "DisplayName": "string",
    "Description": "string",
    "AttributeDetails": {
       "Attributes": [
           {
               "Name": "string"
           }
           ...
       ],
       "Expression": "string",
    },
    "Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE"
    "Conditions": {
        "Range": {
             "Value": "number",
             "Units": "string"
        },
        "ObjectCount": "number",
        "Threshold": {
            "Value": "string",
            "Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
        }
    },
    "CreatedAt": number,
    "LastUpdatedAt": number,
    "Tags": {}
}

URI リクエストパラメータ

DomainName

ドメインの一意の名前。
- 長さの制限：最小長は 1 です。最大長は 64 文字です。
- Pattern: ^[a-zA-Z0-9_-]+$
- 必須：はい
CalculatedAttributeName

計算された属性の一意の (ドメインごとの) 名前。
- タイプ: 文字列
- 長さの制限：最小長は 1 です。最大長は 64 文字です。
- Pattern: ^[a-zA-Z0-9_-]+$
- 必須：はい

DeleteCalculatedAttributeDefinition

既存の計算された属性定義を削除します。計算されたデフォルトの属性を削除することは可能ですが、一度削除すると、そのアクションを元に戻すことはできず、元に戻すCreateCalculatedAttributeDefinitionAPI場合はを使用して自分で作成し直す必要があります。

リクエスト


DELETE /domains/DomainName/calculated-attributes/CalculatedAttributeName

リクエストボディ


The request does not have a request body.

レスポンス


The response does not have a response body.

URI リクエストパラメータ

DomainName

ドメインの一意の名前。
- 長さの制限：最小長は 1 です。最大長は 64 文字です。
- Pattern: ^[a-zA-Z0-9_-]+$
- 必須：はい
CalculatedAttributeName

計算された属性の一意の (ドメインごとの) 名前。
- タイプ: 文字列
- 長さの制限：最小長は 1 です。最大長は 64 文字です。
- Pattern: ^[a-zA-Z0-9_-]+$
- 必須：はい

ListCalculatedAttributeDefinitions

ドメインのすべての計算された属性定義を取得します。

リクエスト


GET /domains/DomainName/calculated-attributes?max-results=MaxResults&next-token=NextToken

リクエストボディ


The request does not have a request body.

レスポンス



{
    "Items": [
        {
            "CalculatedAttributeName": "string",
            "DisplayName": "string",
            "Description": "string",
            "CreatedAt": "timestamp",
            "LastUpdatedAt": "timestamp"
        },
        ...
    ],
    "NextToken": "string"
}

URI リクエストパラメータ

DomainName

ドメインの一意の名前。
- 長さの制限：最小長は 1 です。最大長は 64 文字です。
- Pattern: ^[a-zA-Z0-9_-]+$
- 必須：はい
MaxResults

ページごとに返されるオブジェクトの最大数。
- 有効範囲: 最小値は 1 です。最大値は 100 です
NextToken

前の ListCalculatedAttributeDefinition API呼び出しからのページ分割トークン。
- 長さの制限：最小長は 1 です。最大長は 1,024 です

GetCalculatedAttributeForProfile

計算を開始し、1 つのプロファイルの 1 つの計算された属性の結果を取得します。

リクエスト


GET /domains/DomainName/profile/ProfileId/calculated-attributes/CalculatedAttributeName

リクエストボディ


The request does not have a request body.

レスポンス



{
    "Name": "string",
    "DisplayName": "string",
    "Value": "string",
    "IsDataPatrial": "string"
}

URI リクエストパラメータ

DomainName

ドメインの一意の名前。
- 長さの制限：最小長は 1 です。最大長は 64 文字です。
- Pattern: ^[a-zA-Z0-9_-]+$
- 必須：はい
CalculatedAttributeName

計算された属性の一意の (ドメインごとの) 名前。
- タイプ: 文字列
- 長さの制限：最小長は 1 です。最大長は 64 文字です。
- Pattern: ^[a-zA-Z0-9_-]+$
- 必須：はい

ListCalculatedAttributesForProfile

計算を開始し、1 つのプロファイルのすべての計算された属性の結果を取得します。

リクエスト


GET /domains/DomainName/profile/ProfileId/calculated-attributes?max-results=MaxResults&next-token=NextToken

リクエストボディ


The request does not have a request body.

レスポンス



{
    "Items": [
        {
            "CalculatedAttributeName": "string",
            "DisplayName": "string",
            "Value": "string",
            "IsDataPartial" : "string"
        },
        ...
    ],
    "NextToken": "string"
}

URI リクエストパラメータ

DomainName

ドメインの一意の名前。
- 長さの制限：最小長は 1 です。最大長は 64 文字です。
- Pattern: ^[a-zA-Z0-9_-]+$
- 必須：はい
ProfileId
- Pattern: [a-f0-9]{32}
- 必須：はい
MaxResults

ページごとに返されるオブジェクトの最大数。
- 有効範囲: 最小値は 1 です。最大値は 100 です
NextToken

前の ListCalculatedAttributeDefinition API呼び出しからのページ分割トークン。
- 長さの制限：最小長は 1 です。最大長は 1,024 です

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

Customer Profiles の計算された属性

カスタムの計算された属性定義の作成