カスタムイベント内の階層化オブジェクト

この記事では、階層化 JSON データをカスタムイベントと購入のプロパティとして送信する方法と、メッセージングでそれらの階層化オブジェクトを使用する方法について説明します。

階層化オブジェクト (別のオブジェクト内にあるオブジェクト) を使用して、階層化された JSON データをカスタムイベントや購入のプロパティとして送信できます。この階層化されたデータは、メッセージ内のパーソナライズされた情報のテンプレート化、メッセージ送信のトリガー、およびセグメンテーションに使用できます。

制限事項

• 階層化トされたデータは、カスタムイベントと購入イベントの両方でサポートされていますが、他のイベントタイプではサポートされていません。
• 配列またはオブジェクト値を含むイベントプロパティオブジェクトは、最大 50 KB のイベントプロパティペイロードを持つことができます。
• 購入イベントに対してイベントプロパティスキーマを生成することはできません。
• イベントプロパティスキーマは、過去 24 時間のカスタムイベントをサンプリングすることで生成されます。

最小の SDK バージョン

次の SDK バージョンでは、階層化オブジェクトがサポートされています。

ステップ 1: スキーマの生成

カスタムイベント内の階層化データにアクセスするには、階層化イベントプロパティを使用して、各イベントのスキーマを生成します。スキーマを生成するには、次のステップに従います。

1. [データ設定] > [カスタムイベント] に移動します。
2. 階層化プロパティを持つイベントについて、[プロパティの管理] を選択します。
3. アイコンをクリックしてスキーマを生成します。スキーマを表示するには、 プラスボタンをクリックします。

ステップ 2: 階層化オブジェクトの使用

スキーマを生成すると、セグメンテーション中およびパーソナライゼーション中に階層化データを参照できます。使用例については、以下のセクションを参照してください。

• API リクエストの本文
• Liquid のテンプレート作成
• メッセージトリガー
• セグメンテーション
• パーソナライゼーション
• イベントプロパティのセグメンテーション

API リクエストの本文

• music example
• restaurant example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
...
"properties": {
  "songs": [
    {
      "title": "Smells Like Teen Spirit",
      "artist": "Nirvana",
      "album": {
        "name": "Nevermind",
        "yearReleased": "1991"
      }
    },
    {
      "title": "While My Guitar Gently Weeps",
      "artist": "the Beatles",
      "album": {
        "name": "The Beatles",
        "yearReleased": "1968"
      }
    }
  ]
}
...

1
2
3
4
5
6
7
8
9
10
11
12
...
"properties": {
  "r_details": {
    "name": "McDonalds",
    "identifier": "12345678",
    "location" : {
      "city": "Montclair",
      "state": "NJ"
    }
  }
}
...

Liquid のテンプレート作成

次の Liquid テンプレートの例は、前述の API リクエストから保存された階層化プロパティを参照し、Liquid メッセージングで使用する方法を示しています。Liquid とドット表記を使用して、階層化されたデータを詳細に検索し、メッセージに含める特定のノードを検出します。

• music example
• restaurant example

メッセージのトリガー

これらのプロパティを使用してキャンペーンをトリガーするには、カスタムイベントまたは購入を選択し、階層化プロパティフィルターを追加します。メッセージのトリガーはまだアプリ内メッセージでサポートされていませんが、メッセージ内の Liquid パーソナライゼーションの階層化プロパティは引き続き表示されます。

• music example
• restaurant example

セグメンテーション

階層化イベントプロパティに基づいてユーザーをセグメント化するには、セグメントエクステンションを使用する必要があります。スキーマを生成すると、階層化オブジェクトエクスプローラーが [セグメンテーション] セクションに表示されます。

セグメンテーションでは、トリガーと同じ表記法を使用します (「メッセージのトリガー」を参照)。

パーソナライゼーション

[パーソナライゼーションの追加] モーダルを使用して、[パーソナライゼーションタイプ] として [イベントの詳細プロパティ] を選択します。これにより、スキーマの生成後に階層化イベントプロパティを追加するオプションを使用できます。

よくある質問

階層化オブジェクトを使用すると、データポイントが追加で消費されますか?

この機能を追加したことによって消費されるデータポイントに変更はありません。階層化オブジェクトに基づくセグメンテーションでは、セグメントエクステンションが使用されるため、追加のデータポイントは使用されません。

送信できる階層化データの量はどの程度ですか?

イベントの 1 つ以上のプロパティに階層化されたデータが含まれている場合、イベントのすべてのプロパティを合計した最大ペイロードは 50 KB です。そのサイズ制限を超えたリクエストは拒否されます。