Skip to main content
アカウントでこの機能を有効にするには、MoEngage の CSM (カスタマーサクセスマネージャー) またはサポートチームにお問い合わせください。

はじめに

Object は、データをキーと値のペアで保持する汎用的なデータ型です。Object は、1 つまたは複数のキーと値のペアを保持できます。マーケターとして、ユーザーがカートに追加した特定のアイテムに応じてユーザーをセグメント化したい場合があります。指定したアイテムを定義する列挙可能な属性が複数ある場合、それらを 1 つの Object にまとめてアイテムの識別に使用できます。たとえば、書籍 Atonement をカートに追加したユーザーのリストを記録したいとします。この書籍は次の Object を使用して定義できます。 Code
文字列、数値、ブール値などの既存のデータ型の属性に加えて、Object データ型を使用すると、より詳細なクエリを実行し、よりパーソナライズされたマーケティングキャンペーンのためのカスタムユーザーセグメントを作成できます。

Object の種類

MoEngage は次の種類の Object をサポートしています。

シンプルな Object

シンプルな Object は、次に示すように、複数のキーと値のペアを保持する要素で構成されます。 Code

ネストされた Object

次に示すように、別の Object の内部にある Object をネストされた Object と呼びます。 Code

Object の配列

Object の配列は、次に示すように、それぞれが複数のキーと値のペアを保持する要素の集合です。 Code

Object データ型で使用される用語

次の Object Stationary を考えてみましょう。 Code
Object データ型の用語を以下に説明します。

Object データ型の取り込みに関する主な要素

Object データ型の取り込み

このセクションでは、Object データ型を MoEngage に取り込む方法について説明します。

S2S API

cURL リクエストのサンプル

SDK

cURL リクエストのサンプル

Snowflake

Object データ型は Snowflake でもサポートされています。

互換性のある JSON データを Snowflake に保存する

Snowflake 内に有効な JSON を保存するには、列のデータ型を VARIANT 型に変更する必要があります。詳細については、こちらを参照してください。 Snowflake 内に保存する JSON は有効な JSON である必要があります。そうでない場合、値は JSON として書き込まれません。JSON 列の例を次に示します。 JavaScript

Snowflake 経由で JSON データをインポートする

MoEngage で Object 型としてマークされ、Snowflake の列にマッピング可能な既存の属性: 次に示すように、マッピングの手順で新しい Object 属性を作成することもできます。
MoEngage は、ネストされた属性とのマッピングをサポートしていません。マッピングできるのはトップレベルの属性のみです。

Zapier

Zapier で、Object 型の属性を持つユーザーとイベントを作成できるようになりました。属性を Object 型としてマークするには、それらの属性を Object-type Attributes リスト内で定義する必要があります。 無効な JSON 値を持つ属性は破棄されます。同じフローが Import User Event Action にも適用されます。
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 データ型を編集するには、次の手順に従います。
  1. MoEngage ダッシュボードに移動し、Settings > Analytics and Data > Data management > User attributes または Events をクリックします。
  2. Object データ型のユーザー属性を選択するか、検索バーを使用して検索します。
  3. 属性の行にある縦の三点リーダーをクリックし、Edit をクリックします。
  4. Object の構造を変更します。たとえば、文字列属性をブール値に、数値を文字列に変更するなどです。
  5. Save をクリックします。変更を保存すると警告が表示されます。
  6. 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 属性を表示するには、次の手順に従います。
  1. MoEngage ダッシュボードに移動し、Object 属性を使用してセグメントを作成します。
  2. Create segment ページで Query Results セクションまでスクロールし、クエリを選択します。
  3. サンプルユーザーを選択して User Profile ページに移動します。または、右上の検索バーを使用して ID でユーザーを検索します。
  4. User Profile ページの Tracked Custom Attributes セクションで、すべての Object 型属性を確認できます。

Activity Info

Activity Info でイベントに関連付けられた Object 属性を表示するには、次の手順に従います。
  1. MoEngage ダッシュボードに移動し、Object 属性を使用してセグメントを作成します。
  2. Create segment ページで Query Results セクションまでスクロールし、クエリをクリックして展開します。
  3. サンプルユーザーを選択して User Profile ページに移動します。または、Create segment ページの右上にあるユーザー検索ボックスで (ユーザー ID を使用して) ユーザーを検索します。
  4. User Profile ページから Activity Info タブに移動すると、Object 型セクションですべてのイベントとイベント属性を確認できます。

キャンペーンとチャネルにおける Object データ型のサポート

次の表は、配信タイプと、各キャンペーンで Object データ型がサポートされているかどうかを示しています。 NA* は、そのキャンペーンでは該当する配信タイプがサポートされていないことを示します。 次の表は、各チャネルと、Object データ型がサポートされているかどうかを示しています。 次の表は、キャンペーン作成の手順と、各キャンペーンで Object データ型がサポートされているかどうかを示しています。 次の表は、Flow 作成の手順と、各キャンペーンで Object データ型がサポートされているかどうかを示しています。

ユーザーデータのエクスポート

ユーザーデータのエクスポート (セグメントに対する Export Users アクション) は、Object データ型の属性をサポートしていません。Object または Object の配列の属性を選択した状態でセグメントをエクスポートすると、エクスポートパイプラインが Object データ型をサポートしていないため、その属性は無効または不完全な JSON としてエクスポートされ、確実に解析できません。セグメントからユーザーをエクスポートする方法の詳細については、セグメントの管理を参照してください。

次のステップ