カスタムイベント内の階層化オブジェクト
この記事では、階層化 JSON データをカスタムイベントと購入のプロパティとして送信する方法と、メッセージングでそれらの階層化オブジェクトを使用する方法について説明します。
階層化オブジェクト (別のオブジェクト内にあるオブジェクト) を使用して、階層化された JSON データをカスタムイベントや購入のプロパティとして送信できます。この階層化されたデータは、メッセージ内のパーソナライズされた情報のテンプレート化、メッセージ送信のトリガー、およびセグメンテーションに使用できます。
制限事項
- 階層化トされたデータは、カスタムイベントと購入イベントの両方でサポートされていますが、他のイベントタイプではサポートされていません。
- 配列またはオブジェクト値を含むイベントプロパティオブジェクトは、最大 100 KB のイベントプロパティペイロードを持つことができます。
- 購入イベントに対してイベントプロパティスキーマを生成することはできません。
- イベントプロパティスキーマは、過去 24 時間のカスタムイベントをサンプリングすることで生成されます。
最小の SDK バージョン
次の SDK バージョンでは、階層化オブジェクトがサポートされています。
ステップ 1: スキーマの生成
カスタムイベント内の階層化データにアクセスするには、階層化イベントプロパティを使用して、各イベントのスキーマを生成します。スキーマを生成するには、次のステップに従います。
- [データ設定] > [カスタムイベント] に移動します。
- 階層化プロパティを持つイベントについて、[プロパティの管理] を選択します。
- スキーマを生成するには、 ボタンを選択する。スキーマを表示するには、 プラスボタンを選択する。
ステップ 2: 階層化オブジェクトの使用
スキーマを生成すると、セグメンテーション中およびパーソナライゼーション中に階層化データを参照できます。使用例については、以下のセクションを参照してください。
API リクエストの本文
以下は、「Created Playlist」(作成された再生リスト) カスタムイベントの /users/track
の例です。再生リストが作成されたら、再生リストのプロパティを収集するために、プロパティとして「songs」(曲) と 曲の階層化プロパティの配列をリストする API リクエストを送信します。
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"
}
}
]
}
...
以下は、「Ordered」(注文を受けた) カスタムイベントの/users/track
の例です。注文が完了した後、その注文のプロパティを収集するために、プロパティとして「r_details」とその注文の階層化プロパティをリストする API リクエストを送信します。
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 とドット表記を使用して、階層化されたデータを詳細に検索し、メッセージに含める特定のノードを検出します。
「Created Playlist」(作成した再生リスト) イベントによってトリガーされるメッセージ内の Liquid でのテンプレート。
{{event_properties.${songs}[0].album.name}}
:”Nevermind”
{{event_properties.${songs}[1].title}}
:”While My Guitar Gently Weeps”
「Ordered」(注文を受けた) イベントによってトリガーされるメッセージ内の Liquid でのテンプレート:
{{event_properties.${r_details}.location.city}}
:”Montclair”
メッセージのトリガー
これらのプロパティを使用してキャンペーンをトリガーするには、カスタムイベントまたは購入を選択し、階層化プロパティフィルターを追加します。メッセージのトリガーはまだアプリ内メッセージでサポートされていませんが、メッセージ内の Liquid パーソナライゼーションの階層化プロパティは引き続き表示されます。
「Created Playlist」イベントから階層化プロパティを持つキャンペーンをトリガーします。
トリガー条件 songs[].album.yearReleased
[である] 「1968」は、1968 年にリリースされたアルバムに収録されたいずれかの曲があるイベントと一致します。配列の内部を詳しく調べるために大かっこ ([]
) の表記を使用し、その配列内のいずれかの項目がイベントプロパティと一致すれば、「一致」になります。
「Ordered」 (注文された) イベントから階層化プロパティを持つキャンペーンをトリガーします。
![] (/docs/ja/assets/img/nested_object1.png?24c5344c91145bf8ebe512f86a362c6f )。
r_details.name
:”Mcdonalds”
r_details.location.city
:”Montclair”
イベントプロパティに []
または .
の文字が含まれている場合は、チャンクを二重引用符で囲んでエスケープします。例えば、 "songs[].album".yearReleased
はリテラルプロパティ "songs[].album"
を持つイベントと一致します。
セグメンテーション
階層化イベントプロパティに基づいてユーザーをセグメント化するには、セグメントエクステンションを使用する必要があります。スキーマを生成すると、階層化オブジェクトエクスプローラーが [セグメンテーション] セクションに表示されます。
セグメンテーションでは、トリガーと同じ表記法を使用します (「メッセージのトリガー」を参照)。
パーソナライゼーション
[パーソナライゼーションの追加] モーダルを使用して、[パーソナライゼーションタイプ] として [イベントの詳細プロパティ] を選択します。これにより、スキーマの生成後に階層化イベントプロパティを追加するオプションを使用できます。
よくある質問
階層化オブジェクトを使用すると、データポイントが追加で消費されますか?
この機能を追加したことによって消費されるデータポイントに変更はありません。階層化オブジェクトに基づくセグメンテーションでは、セグメントエクステンションが使用されるため、追加のデータポイントは使用されません。
送信できる階層化データの量はどの程度ですか?
イベントの 1 つ以上のプロパティに階層化されたデータが含まれている場合、イベントのすべてのプロパティを合計した最大ペイロードは 100 KB です。そのサイズ制限を超えたリクエストは拒否されます。