カスタム オブジェクトのスタートガイド

単一の「オブジェクト」に複数のプロパティを保存して関連付けられるカスタムオブジェクトについて説明します。 カスタムオブジェクトを使用すると、プロファイルプロパティでは保存できない多様な多重リレーションのデータ概念を Klaviyo にマッピングできます。その後、メッセージやセグメントなどでカスタムオブジェクトを使用できます。

カスタムオブジェクトはプロファイルプロパティとどう違いますか？

プロファイルプロパティは、簡単な情報を保存するのに適した方法です。たとえば、お気に入りの色のプロパティがある場合、各顧客のお気に入りの色を保存できます。

しかし、そのプロパティにさらに多くのデータや複数のバージョンが必要な場合はどうでしょうか？優れた例として、ペットが挙げられます。プロファイルプロパティを使用して、名前、年齢、品種などを保存できますが、これらはプロファイルごとに 1 回しか使用できません。

ペットが複数いる場合は、代わりにカスタムオブジェクトを使用できます。これにより、グレートデーンの Fluffy には名前、年齢、体重などが記録された専用のデジタル ID カードが作成され、ハムスターの Cheeks にも同様に情報が登録されますが、登録情報の内容は（大きく）異なります。

使用例

以下は、Klaviyo に保存できるデータにおいて、カスタムオブジェクトがどのように柔軟であるかを示す例です。

予定

予約をスケジュールできるビジネスの場合、Appointment オブジェクトを使用して、プロファイルの予約データを保存できます。

Appointment オブジェクトの各オブジェクトレコード内で、含めることを推奨するデータの例は次のとおりです。

• 予約 ID
• 予約日
• 担当者（例：特定の医師、インストラクターなど）
• 予約場所
• 予定タイプ

プロファイルには複数の予約がある場合、複数のオブジェクトレコードを持つことができます。また、このオブジェクトデータを使用してセグメントを作成し、パーソナライズされたメッセージとフローを送信できます。

購読

顧客が購読にサインアップできるビジネスの場合、Subscription オブジェクトを使用して、プロファイルの購読データを保存できます。

Subscription オブジェクトの各オブジェクトレコード内で、含めることを推奨するデータの例は次のとおりです。

• サブスクリプション ID
• サブスクリプション商品
• 購読価格
• 購読ステータス
• 次回の請求日

プロファイルは、購読が複数ある場合に複数のオブジェクトレコードを持つことができ、このオブジェクトデータを使用してセグメントを作成したり、パーソナライズされたメッセージやフローを送信したりできます。

予約

顧客が予約できるビジネスの場合、Reservation オブジェクトを使用して、プロファイルの予約データを保存できます。

Reservation オブジェクトの各オブジェクト レコード内で、含めたいデータの例としては次のようなものがあります：

• 予約 ID
• 予約日
• 予約場所
• 予約の機会
• 予約のゲスト数

プロファイルは、複数の予約がある場合に複数のオブジェクトレコードを持つことができ、これらのオブジェクトデータを使用してセグメントを作成し、パーソナライズされたメッセージやフローを送信できます。

ペット

ペットの飼い主にサービスを提供しているビジネスの場合、Pet オブジェクトを使用して、プロファイルのペットに関するデータを保存できます。

Pet オブジェクトの各オブジェクトレコード内で、含めるとよいデータの例は次のとおりです：

• ペットのマイクロチップ ID
• ペットの名前
• ペットの種類（例：犬または猫）
• ペットの品種
• ペットの誕生日

プロファイルに複数のペットがいる場合、プロファイルは複数のオブジェクトレコードを持つことができ、このオブジェクトデータを使用してセグメントを作成し、パーソナライズされたメッセージやフローを送信できます。

アカウント制限

カスタム オブジェクトには、3 つのアカウント上限セットがあります：

• オブジェクトの上限
  アカウントが保有できるオブジェクトの総数。
• オブジェクトプロパティの制限
  アカウントがオブジェクトごとに保有できるプロパティの数。
• オブジェクト レコード上限
  アカウントで許可されるオブジェクト レコード数。

利用可能なオブジェクト数とオブジェクトレコード数は、すべてのアカウントにわたるアクティブ プロファイルの総数に基づきます。レコードの上限はすべてのアカウントで共有されますが、オブジェクトの上限は各アカウントに個別に適用されます。

プロファイルが250件以下のアカウントでは、静的オブジェクトのレコード上限は2,500件です。

たとえば、5 つの子アカウントを持つアカウントファミリーがあり、各アカウントに 100,000 件のアクティブなプロファイルがある場合、アクティブなプロファイルの合計は 500,000 件になります。以下のグラフに示すとおり、400,000 件を超えるプロファイルがあるアカウントのオブジェクト レコード乗数は 10 です。その結果、これらのアカウントは最大 500 万件のレコード（500,000×10）を合計で保存できます。つまり、残りの 4 つのアカウントのオブジェクトレコード数の合計が 2 百万未満であれば、1 つのアカウントに 3 百万件のレコードを持つことができます。アカウントあたりのオブジェクト数については、プロファイル数の合計が 400,000 を超えているため、各アカウントは最大 5 つのオブジェクトを持つことができます。

さらに、すべてのアカウントには次の制限があります。

• 1 つのオブジェクトにつき、1 つのプロファイルあたり最大 500 件のレコード。
• すべてのカスタム オブジェクトは 8 KB 以下である必要があります。
• すべてのカスタムオブジェクトレコードは 2 KB を超えてはなりません。

オブジェクトを作成する

Klaviyo でオブジェクトの作成を始めるには、[コンテンツ] > [オブジェクト] に移動し、[オブジェクトを作成] をクリックします。

ここから、自分でオブジェクトを作成するか、推奨されるオブジェクトテンプレートを選択できます。オブジェクトをすべて自分で作成するには、[独自に作成] ボタンを選択してください。

オブジェクト作成ワークフローの最初の部分では、オブジェクトに対して次の情報を設定する必要があります：

• 名前
  オブジェクトを識別するための名前
• 説明（任意）
  オブジェクトが表すデータの説明
• データソース
  オブジェクトデータが存在するデータソース。

新しいデータソースを作成するには、[データソース] のドロップダウンをクリックし、[データソースを作成] を選択します。

データソースを作成するには、以下の情報を設定する必要があります。

• 名前
  オブジェクトデータのソースを識別するための一意の名前
• 説明（任意）
  データソースの説明

オブジェクト ID を設定する

オブジェクトの名前を設定し、データソースを選択したら、次のステップはオブジェクト ID を設定し、必要なオブジェクトプロパティをマッピングすることです。このステップでは、カスタムオブジェクト API を介して Klaviyo に送信されたデータソースに関連するデータをプレビューできます。

オブジェクト ID の設定は、オブジェクトレコード同士を区別するために必要です。一意のオブジェクト ID に使用するデータソース プロパティを指定する必要があります。

オブジェクト ID は、オブジェクト レコードの特定のインスタンスを識別するために使用できる、一意のデータソース プロパティである必要があります。たとえば、ギフトカード オブジェクトでは、一意の割引コードのようなものをオブジェクト ID として使用できます。これはデータソースの各インスタンスに固有で、すべてのオブジェクト レコードに存在します。

Klaviyo が、同じオブジェクト ID を持つデータをデータソースから受信するたびに、関連付けられたオブジェクトレコードが更新されます。このため、適切なレコードが更新されるように、オブジェクト ID は一意であることが重要です。

オブジェクト データを送信

既存のオブジェクト レコードを更新すると、レコード全体が置き換えられます。そのため、1 つのプロパティのみを更新したい場合でも、オブジェクト レコード全体を送信することが非常に重要です。

例えば、レコード内の 5 つのプロパティのうち、1 つだけを更新したいとします。ID と更新したい 1 つのプロパティだけを含めて更新データを送信すると、他の 4 つのプロパティは null に設定されます。新しく null になったフィールドのいずれかがプロファイルの関連付け（例：メール アドレスなどのプロファイル識別子）で使用されていた場合、そのオブジェクトはそのプロファイルに関連付けられなくなります。

オブジェクトのプロパティをマッピングする

オブジェクトプロパティをマッピングすると、データソース内のどの情報を Klaviyo のオブジェクト内で利用可能にするかを選択できます。

ただし、この理由から、オブジェクト取り込み API を使用して、標準化された日付およびタイムスタンプ形式でオブジェクトデータを送信することを推奨します。特定のプロパティの値が不明な場合は、そのプロパティに null 値を設定できます。

オブジェクトのプロパティをマッピングするには：

1. データソースプロパティ 列で、オブジェクトに含めたいデータソースプロパティを選択します。
2. マッピング済みプロパティ列に、オブジェクト内でデータソース プロパティに付けたい名前を入力します。
3. データタイプ 列で、データソースプロパティに適した データタイプ を選択してください。
4. 必須列で、このプロパティをオブジェクト内で必須にしたい場合はチェックボックスを選択します。
5. 追加のオブジェクトプロパティをマッピングする必要がある場合は、[マッピングを追加] ボタンを選択します。

マッピングにおけるネストされたデータ

デフォルトでは、オブジェクト マネージャー インターフェースは 1 レベルのネストに対応しています。より深いデータにアクセスするには、任意のパスを手動で入力する必要があります。

例として、以下のデータ ソースをご覧ください。

textCopy

{
  "type": "data-source-record",
  "attributes": {
    "record": {
      "child": {
        "child_id": "d64b8458",
        "name": {
          "first": "Theodore",
          "last": "Customer"
        },
        "birth_date": "2022-04-12",
        "email": "jon.customer@klaviyo.com",
        "phone_numbers": [
              "+11234567899",
              "+13456789123"
        ]
      }
    }      
  }
}

子どもの名に関するデータにアクセスするには、データがインターフェースでアクセスするには深くネストされすぎているため、次のパスを入力できます。

ソースデータに配列がある場合、位置でマッピングするプロパティを見つけることができます。たとえば、パスの末尾に [0] を追加すると、phone_numbers 配列内の最初の電話番号を取得できます。

リレーションシップを追加する

オブジェクト ID を設定し、オブジェクト プロパティをマッピングしたら、次のステップはオブジェクトにリレーションシップを追加することです。

リレーションシップは、オブジェクトを関連するプロファイルに接続します。リレーションシップを設定するには、次の情報を定義します：

• 関連付け名
  関連付けの名前を設定します。たとえばペット オブジェクトがある場合、リレーションシップ名を “Pet owner”. のように設定することもできます。
• ソースデータ
  プロファイルに関連付けるデータソース プロパティを選択します。
• プロファイル識別子
  プロファイル識別子（例：メール、電話番号など）を設定します。オブジェクトをプロファイルに関連付けるには、これをデータソースに含める必要があります。追加のプロパティと識別子のペアを追加するには、[別のプロパティをリンク] ボタンを使用します。

マッピングを確認してオブジェクトを作成

オブジェクト プロパティのマッピングとリレーションシップの設定が完了したら、確認モーダルでマッピングを確認し、[オブジェクトを作成] ボタンを選択します。オブジェクトが作成されると既存のマッピングは編集できず、データの同期が直ちに開始されることに注意してください。

Klaviyo のオブジェクトページに、以下の情報とともにオブジェクトが一覧表示されます：

• オブジェクト名
• 作成日
• 最終更新日
• ステータス

カスタムオブジェクトのステータス状態

カスタムオブジェクトを公開する際のステータスは 3 つあります。

• 下書き
  オブジェクトはまだ編集可能で、公開またはアクティブ化されていません。
• 公開
  オブジェクトは、データソースに送信したデータからカスタムオブジェクトレコードを作成しています。データソースから数千件のレコードを送信した場合、オブジェクトはすぐに公開されます。数百万件のレコードを送信した場合、公開までに数時間かかることがあります。完了すると、ステータスが アクティブ に変更されます。
• アクティブ
  オブジェクトは公開済みで稼働中です。すべてのカスタムオブジェクトレコードは、データソースから送信されたデータに従って作成されています。このオブジェクトに送信される新しいデータは、プロファイルにリンクされた追加のカスタムオブジェクトレコードを生成します。

プロファイルページ上のオブジェクト

関連するオブジェクトはプロファイル ページにも表示されるため、プロファイルに関連するオブジェクト レコードを確認できます。オブジェクト レコードを表示するには、プロファイル ページの ［オブジェクト］タブに移動します。オブジェクトカードの上にあるドロップダウンメニューを使用して、オブジェクトを切り替えることができます。

オブジェクト レコード全体を表示するには、3 つのドット メニューを選択し、View をクリックします。オブジェクト レコード全体を含むサイドパネルが表示されます。

オブジェクト内のすべてのレコードを参照

単一のプロファイルに関連付けられたレコードだけでなく、オブジェクト内のすべてのレコードを参照するには、レコードエクスプローラーを使用してください。[Content] > [Objects]をクリックし、次にオブジェクト名をクリックしてレコードエクスプローラーを開き、そのレコードを表示します。

オブジェクトを更新

オブジェクトの新しいデータの送信を開始する場合は、データソースに追加のオブジェクトプロパティを追加してから、オブジェクトのマッピングを編集し、この新しいプロパティを含めます。以前に作成されたすべてのオブジェクトでは、そのデータが利用できないため、このプロパティは null を返しますが、今後は、このプロパティを使用してオブジェクトが作成および更新されます。

まだオブジェクトにマッピングされていない新しいオブジェクト プロパティを送信する場合は、カスタムオブジェクトを更新してそれを含めることができます。その後、すべてのカスタムオブジェクト レコードが再処理され、このデータが含まれるようになります。

オブジェクトを更新するには：

1. Klaviyo のサイドバーで [コンテンツ] > [オブジェクト] をクリックします。
2. 編集したいオブジェクトの名前を選択します。
3. 右上の [次へ] をクリックします。
4. Map object properties セクションで、Add mapping をクリックします。

1. データソースプロパティ 列で、オブジェクトに含めたいデータソースプロパティを選択します。
2. マッピング済みプロパティ列に、オブジェクト内でデータソース プロパティに付けたい名前を入力します。
3. データ型 列で、データソースプロパティの適切な データ型を選択します。

1. 右上の [次へ] をクリックします。
2. 右上の [次へ] をクリックします。リレーションシップに変更を加える必要はありません。
3. [変更内容を公開] をクリックします。

このプロセスが完了すると、データソースのすべてのレコードが再処理され、既存のカスタムオブジェクトレコードはそれに応じて更新されます。

オブジェクトを削除する

オブジェクトを削除するには：

1. Klaviyo のサイドバーで [コンテンツ] > [オブジェクト] をクリックします。
2. オブジェクトの右側のメニューで、[削除] をクリックします。
   

3. [削除] をもう一度クリックして、オブジェクトの削除を確定します。
4. オブジェクトと関連するすべてのカスタムオブジェクトレコードが削除されます。

以前のオブジェクトのデータソースを使用して新しいカスタムオブジェクトを作成すると、すでに同期済みのデータを使用して新しいカスタムオブジェクト レコードが生成されます。同じデータを使用していても、新しいレコードを持つ新しいオブジェクトと見なされるため、すべてのセグメント、フロー、テンプレート、キャンペーンは、この新しいオブジェクトを使用するように更新する必要があります。

その他のリソース