# カウンターアトリビュートの作成と表示

カウンターアトリビュートを作成して、値をカウントまたは合計できます。これは以下のような状況で役立ちます:

* アクティブユーザーセッションのカウント
* 記事と製品/ページビューのカウント
* カート放棄頻度の監視
* LTV関連アクティビティの追跡
* セキュリティ/エンゲージメントのためのログイン頻度の追跡
* サポートチケット送信の監視


カスタマージャーニーオーケストレーションは、2種類のカウンターアトリビュートをサポートしています:

* **スライディングカウンター**: イベント/アクションのカウントを取得します。カウンター期間内のより小さな期間のカウントを取得するためのサブカウンターを作成します。たとえば、1か月のスライディングカウンターを作成し、1週間のサブカウンターを設定します。


他の有用な例としては、さまざまなアプリケーション全体のバリエーションが考えられます:

* Eコマース
  * 過去7日間の製品ビュー(最近の関心スコアリング用)
  * 過去30日間の購入(ロイヤルティティア評価用)
  * 過去1時間のカート追加(即座のパーソナライゼーション用)
* サブスクリプションビジネス
  * 過去14日間のログイン頻度(エンゲージメントヘルス用)
  * 過去30日間の機能使用(アップセルターゲティング用)
  * 過去90日間のサポートチケット(プロアクティブアウトリーチ用)
* コンテンツ/メディア
  * 過去24時間の記事読み取り(トレンドコンテンツ用)
  * 過去1週間のビデオ完了(レコメンデーションエンジン用)
  * 過去1時間の検索クエリ(リアルタイム提案用)
* マーケティング
  * 過去7日間のメールクリック(エンゲージメントスコアリング用)
  * 過去30日間のキャンペーンタッチポイント(頻度上限用)
  * 過去セッション中のWebサイト訪問(離脱意図トリガー用)
* **トータルカウンター**: 履歴ベース値の上に特定の値の合計カウントを取得します。トータルカウンターは、Batch Backfillで提供された履歴合計と、最後のバッチ更新以降にリアルタイムで記録されたイベントを組み合わせます。たとえば、生涯購入数を追跡するカウンターを作成できます。


他の有用な例としては、以下が考えられます:

* ライフタイムバリュートラッキング
  * これまでの合計購入数(VIP顧客識別用)
  * 合計支出額(ライフタイムバリューセグメンテーション用)
  * 獲得した合計ロイヤルティポイント(ティアステータス用)
* エンゲージメントマイルストーン
  * サインアップ以降の合計ログイン数(ユーザー成熟度スコアリング用)
  * 読んだ合計記事数(コンテンツエンゲージメントレベル用)
  * 使用した合計機能数(製品採用深度用)
* アチーブメント/ゲーミフィケーション
  * 獲得した合計バッジ数(ユーザープロファイル表示用)
  * 完了した合計チャレンジ数(アチーブメントシステム用)
  * 行った合計紹介数(アンバサダープログラム用)
* ビジネスインテリジェンス
  * これまでの合計サポートチケット数(顧客ヘルススコアリング用)
  * 合計ダウンロード数(製品人気ランキング用)
  * 合計セッション数(ユーザースティッキネス分析用)
* サブスクリプションメトリクス
  * 合計更新数(チャーン予測モデル用)
  * 合計アップグレード数(顧客成長追跡用)
  * 合計キャンセル数(ウィンバックキャンペーン用)


上記の例で説明されているように、パラメーターとして時間のサブ期間を使用する場合は、スライディングカウンターの使用をお勧めします。

このトピックには以下が含まれます:

* [カウンターアトリビュートの作成](/ja/products/customer-data-platform/real-time/creating-a-counter-attribute#create-a-counter-attribute)
* [カウンターアトリビュートの表示](/ja/products/customer-data-platform/real-time/creating-a-counter-attribute#view-counter-attributes)


## 前提条件

カウンターアトリビュートを作成するには、すべてのペアレントセグメントに対して_Full_[Data Workbenchパーミッション](/products/control-panel/security/policies/policy-based-data-workbench-permissions)が必要です。

## カウンターアトリビュートの作成

1. Treasure コンソールを開きます。
2. **Data Workbench > Parent Segments**に移動します。
3. カウンターアトリビュートを追加するペアレントセグメントを選択します。
4. **Real-time Configuration**を選択します。
5. **Attributes**タブを選択し、次に**Add Attributes**を選択します。
6. **Counter**を選択します。


![](/assets/creating-counter-attributes-2024-07-11.64232de0ea0bcdaddf4ed5104c110f7718247732ba9687ff2cd9620b473f033e.cf3845cb.png)

1. 次のフィールドの情報を確認してフォームを完成させ、**Create**を選択します。


- **Name**(必須): カウンターアトリビュートの名前を入力します。
- **System ID**(必須): アトリビュートの一意のシステムIDを作成します。システムIDは、アルファベットまたはアンダースコア(*)で始まり、オプションで英数字と(*)が続く文字列です。スペースや特殊文字は使用できません。システムIDは大文字と小文字を区別します。**例** *systemID924*
- **Description**: カウンターアトリビュートの説明を入力します。
- **Key event**(必須): ペアレントセグメントからキーイベントを選択します。オプションで、キーイベントにフィルターを追加します。詳細については、[イベント定義の設定](/ja/products/customer-data-platform/real-time/creating-a-real-time-configuration#configure-event-definitions)を参照してください。
- **Counter type**(必須): **Sliding**または**Total**を選択します。これらのカウンタータイプを完成させるための基準は、次の行で説明されています。


**スライディングカウンター設定**

- **Duration**(必須): タイムラインの分、時間、または日数を追加します。
  * **+** **Add sub-duration**を選択
    * **Name:** サブ期間アトリビュートの名前を作成します。
    * **System ID**: このサブ期間アトリビュートのシステムIDを作成します。
    * **Duration**: 分、時間、または日数を追加します。
**Duration** 期間内のすべてのイベントがアトリビュートに保存されます。たとえば、期間が1週間の場合、最大1週間のイベントがアトリビュートに保存されます。時間が経過すると、1週間を超えたイベントは削除されます。
**Sub-Duration**
  * スライディングカウンターアトリビュートがリアルタイムジャーニーとアクティベーションでアクセスされるには、サブ期間を指定する必要があります。
  * より小さな期間のカウントを抽出します。サブ期間は、メインカウンターの期間を超えることはできません。
  * カウンター内のサブ期間の最大数は20です。
- **Increment by**: 次のいずれかを選択します:
  * **Value**: デフォルトの増分値1を保持するか、カウンター設定に追加する別の数値に変更します。
  * **Value of event field**: カウンターを増分するフィールドを選択します。例: amount。


**トータルカウンター設定**

- **Duration**: デフォルトの期間である1日を保持するか、別の数値と時間値に変更します。
- **Increment by**: 次のいずれかを選択します:
  * **Value**: デフォルトの増分値1を保持するか、カウンター設定に追加する別の数値に変更します。
  * **Value of event field**: カウンターを増分するフィールドを選択します。例: amount。
- **Batch Backfill**: トータルカウンターの履歴ベース値を提供するバッチアトリビュートを設定します。バッチ値は、バッチタイムスタンプ以降に発生したリアルタイムイベントと**常に**組み合わせて生涯合計を算出します。これはリアルタイムデータが不在の場合にのみ使用されるフォールバックではありません。
トータルカウンタータイプを使用する場合は、必ずBatch Backfillを設定してください。設定しない場合、カウンターは真の生涯合計を累積するのではなく、固定ウィンドウ（最大60日間）内のスライディングカウンターとして動作します。
Batch Backfillはスライディングカウンターでは使用できません。
  * **Batch attribute to backfill**: 履歴ベース合計として使用するバッチアトリビュートを選択します。
  * **Batch attribute timestamp**: バッチ値のタイムスタンプを保存するフィールドをUnix秒形式で選択します。このタイムスタンプ**以降**に発生したイベントのみが合計のリアルタイムコンポーネントに含まれます。最新のタイムスタンプを持つアトリビュートが使用されます。


**Null要素を持つキーイベント**

キーイベントフィールド名を使用する場合、Nullは比較を行う際に「False」と同じように扱われます（等しいおよび等しくない）。

たとえば:


```
> 1 == null
false
> 1 != null
true
> null != null
false
> null == null
true
```

## カウンターアトリビュートの表示

1つ以上のカウンターアトリビュートを作成した後、Data Workbenchでそれらを表示できます。

1. Treasure コンソールを開きます。
2. **Data Workbench** >**Parent Segments**に移動します。
3. ペアレントセグメントを選択します。
4. カウンターアトリビュートが一覧表示されている行の省略記号を選択します。


![](/assets/creating-a-counter-attribute-2024-07-30.93e78768acd524f3e435c78fbb37d6e46c41b126b0183d480a9a27cf04e8bc64.cf3845cb.png)

1. **View Details**を選択します。


注: 期限切れになると、カウンターの期間を超えたイベントがリアルタイムストアから削除されます。カウンターアトリビュート自体は削除されません。

[リアルタイムアトリビュートFAQ](/ja/products/customer-data-platform/real-time/real-time-attribute-faqs)も参照してください。