アカウントでこの機能を有効にするには、MoEngage の CSM (カスタマーサクセスマネージャー) またはサポートチームにお問い合わせください。
はじめに
Object は、データをキーと値のペアで保持する汎用的なデータ型です。Object は、1 つまたは複数のキーと値のペアを保持できます。マーケターとして、ユーザーがカートに追加した特定のアイテムに応じてユーザーをセグメント化したい場合があります。指定したアイテムを定義する列挙可能な属性が複数ある場合、それらを 1 つの Object にまとめてアイテムの識別に使用できます。たとえば、書籍 Atonement をカートに追加したユーザーのリストを記録したいとします。この書籍は次の Object を使用して定義できます。 CodeObject の種類
MoEngage は次の種類の Object をサポートしています。シンプルな Object
シンプルな Object は、次に示すように、複数のキーと値のペアを保持する要素で構成されます。 Codeネストされた Object
次に示すように、別の Object の内部にある Object をネストされた Object と呼びます。 CodeObject の配列
Object の配列は、次に示すように、それぞれが複数のキーと値のペアを保持する要素の集合です。 CodeObject データ型で使用される用語
次の Object Stationary を考えてみましょう。 CodeObject データ型の取り込みに関する主な要素
Object データ型の取り込み
このセクションでは、Object データ型を MoEngage に取り込む方法について説明します。S2S API
cURL リクエストのサンプルSDK
cURL リクエストのサンプルSnowflake
Object データ型は Snowflake でもサポートされています。互換性のある JSON データを Snowflake に保存する
Snowflake 内に有効な JSON を保存するには、列のデータ型を VARIANT 型に変更する必要があります。詳細については、こちらを参照してください。 Snowflake 内に保存する JSON は有効な JSON である必要があります。そうでない場合、値は JSON として書き込まれません。JSON 列の例を次に示します。 JavaScriptSnowflake 経由で JSON データをインポートする
MoEngage で Object 型としてマークされ、Snowflake の列にマッピング可能な既存の属性:

MoEngage は、ネストされた属性とのマッピングをサポートしていません。マッピングできるのはトップレベルの属性のみです。
Zapier
Zapier で、Object 型の属性を持つユーザーとイベントを作成できるようになりました。属性を Object 型としてマークするには、それらの属性を Object-type Attributes リスト内で定義する必要があります。
Object 型を意図しているにもかかわらず Custom Attributes リストで定義されている属性は、文字列として MoEngage に送信されます。この場合、属性の固定されたデータ型に基づいて、MoEngage のデフォルトの型変換ルールが適用されます。
例外
- デフォルトでは、各ワークスペースで取り込める Object は 5 個のみです。
- Object 内または array_objects 内の要素は、null または空白が存在する場合は破棄されます。
- 異種混在の Object の配列はサポートされていません。Object の配列は、配列要素として Object のみで構成する必要があります。
- ケース 1: Object とプリミティブ要素が混在している場合、プリミティブ要素は破棄されます。
- ケース 2: 配列に Object が含まれず、他のプリミティブ要素で構成されている場合、MoEngage は最初の要素のデータ型を基準データ型として、残りの要素をそのデータ型に型変換しようとします。変換に失敗した場合、その要素は破棄されます。
Object データ型の使用
このセクションでは、Object データ型の使用方法について説明します。Data Management
Object データ型の属性を MoEngage に取り込んだ後は、MoEngage ダッシュボードの Data management セクションで管理できます。Object データ型を編集するには、次の手順に従います。- MoEngage ダッシュボードに移動し、Settings > Analytics and Data > Data management > User attributes または Events をクリックします。
- Object データ型のユーザー属性を選択するか、検索バーを使用して検索します。

- 属性の行にある縦の三点リーダーをクリックし、Edit をクリックします。

- Object の構造を変更します。たとえば、文字列属性をブール値に、数値を文字列に変更するなどです。

- Save をクリックします。変更を保存すると警告が表示されます。

- Continue をクリックして確定します。
Object 属性は 24 時間に 1 回編集できます。そのため、編集オプションは今回の編集から 24 時間後にのみ有効になります。
Data Management で Object 属性に対して実行できる操作
- 任意のカスタムユーザー属性またはイベント属性について、データ型を Object または Array of Object に固定できます。
- Object または Array of Object データ型については、システムが Object の構造を自動検出し、セグメンテーション用のメタデータとして保存します。
- 検出される構造には、Object のすべての子要素とそのデータ型が 2 レベルまで含まれている必要があります。
- Object または Array of Object 型の属性について、各子ノードを手動で定義できます。
- Object 属性のスキーマを手動で定義した場合、(実行中のキャンペーンやトリガーでの予期しない問題を避けるため) 24 時間は変更できません。スキーマを手動で定義した後、受信データはすべてそのスキーマに照らして検証され、定義に準拠していない場合は拒否されます。
- Object または Array of Object 型の属性については、サンプル JSON を貼り付けて、定義済みの Object 構造を生成できます。
- 各子ノードのデータ型を 2 レベルまで指定できます。サポートされるデータ型は次のとおりです。
- Numeric
- Boolean
- String
- Date type
- Primitive Array
- JSON (任意のレベルのネストされた Object を取り込む場合)
- 任意の Object 定義に対して 100 個を超える子ノードを作成できます。Object に 100 個を超える子ノードがある場合、MoEngage は先に定義された最初の 100 個の子ノードのみを受け付けます。
- 既存の属性を Object として固定した場合、以前の値は型変換されず、そのまま残ります。
- その属性に対して新たに受信する値は、シナリオに応じて次のように扱われます。
- 受信した値が定義された上限内の Object である場合、受け付けられます。
- 受信した値がプリミティブデータ型 (数値、文字列、ブール値) の場合、カプセル化されて Object として型変換されます。
- Object として固定された属性のデータ型を「Any」または任意のプリミティブデータ型に変更できます。
- Object データ型のサブ属性の Block/Unblock および Show/Hide は、ルートレベルの属性に対してのみ変更できます。
- Object データ型属性のスキーマは、次の方法で編集できます。
- 最大 2 レベルのネストまで、Object に新しいサブ属性を追加する。
- 既存のサブ属性を削除する。
例外
- 属性は、Object として、または任意のプリミティブデータ型としてデータを取り込むことができます。
- Object データ型のデータポイントを 1 つでも取り込んだ属性は暗号化できません。
- プリミティブデータ型でデータを取り込んでおり、PII 暗号化属性としてマークされている属性は、今後 Object データポイントを取り込むことができません。
ユーザープロファイル
このセクションでは、ユーザープロファイルについて説明します。User Info
Object データ型の属性を MoEngage に取り込んだ後は、MoEngage ダッシュボードの User Profile セクションで確認できます。Object 属性を表示するには、次の手順に従います。- MoEngage ダッシュボードに移動し、Object 属性を使用してセグメントを作成します。
- Create segment ページで Query Results セクションまでスクロールし、クエリを選択します。
- サンプルユーザーを選択して User Profile ページに移動します。または、右上の検索バーを使用して ID でユーザーを検索します。
- User Profile ページの Tracked Custom Attributes セクションで、すべての Object 型属性を確認できます。

Activity Info
Activity Info でイベントに関連付けられた Object 属性を表示するには、次の手順に従います。- MoEngage ダッシュボードに移動し、Object 属性を使用してセグメントを作成します。
- Create segment ページで Query Results セクションまでスクロールし、クエリをクリックして展開します。
- サンプルユーザーを選択して User Profile ページに移動します。または、Create segment ページの右上にあるユーザー検索ボックスで (ユーザー ID を使用して) ユーザーを検索します。
- User Profile ページから Activity Info タブに移動すると、Object 型セクションですべてのイベントとイベント属性を確認できます。
キャンペーンとチャネルにおける Object データ型のサポート
次の表は、配信タイプと、各キャンペーンで Object データ型がサポートされているかどうかを示しています。
NA* は、そのキャンペーンでは該当する配信タイプがサポートされていないことを示します。
次の表は、各チャネルと、Object データ型がサポートされているかどうかを示しています。
次の表は、キャンペーン作成の手順と、各キャンペーンで Object データ型がサポートされているかどうかを示しています。
次の表は、Flow 作成の手順と、各キャンペーンで Object データ型がサポートされているかどうかを示しています。