カスタムオブジェクトについて学びましょう。カスタムオブジェクトを使用すると、1つの"オブジェクトに複数のプロパティを格納したり関連付けたりすることができます。" カスタムオブジェクトは、プロファイルプロパティでは格納できない多様なマルチリレーショナルデータコンセプトをKlaviyoにマッピングすることができます。カスタムオブジェクトは、メッセージやセグメントなどで使用できます。
カスタムオブジェクトとプロファイルプロパティはどう違うのですか？
プロファイルプロパティは、シンプルな情報を保存するのに最適な方法です。 例えば、favorite colorプロパティがあれば、各顧客の好きな色を保存することができます。
しかし、より多くのデータやそのプロパティの複数のバージョンを必要とする場合はどうでしょうか？その好例がペットです。プロファイルプロパティは名前、年齢、犬種などを保存するのに使えますが、1つのプロファイルにつき1回しか使えません。
複数のペットを飼っている場合は、カスタムオブジェクトを使うこともできます。そうすれば、グレート・デーンのフラッフィーは自分の名前、年齢、体重などのデジタルIDカードを持ち、ハムスターのチークスは同じ情報を持っていますが、答えは（まったく）違います。
使用例
以下は、カスタムオブジェクトがKlaviyoに保存できるデータの柔軟性を示す例です。
予定
もしあなたが顧客がアポイントメントを予約できるビジネスをしているのであれば、プロファイルのアポイントメントデータを保存するためにAppointment オブジェクトを使用することができます。
Appointmentオブジェクトの各オブジェクトレコード内には、以下のようなデータの例があります：
- 予約ID
- 任命日
- アポイントメント担当者（特定の医師、指導者など）
- 予約場所
- 予約タイプ
プロファイルは複数のアポイントメントを持っている場合、複数のオブジェクトレコードを持つことができ、このオブジェクトデータを使用してセグメントを作成し、パーソナライズされたメッセージやフローを送信することができます。
サブスクリプション
顧客がサブスクリプションにサインアップできるビジネスであれば、プロファイルのサブスクリプションデータを格納するためにSubscription オブジェクトを使用できます。
サブスクリプション・オブジェクトの各オブジェクト・レコードの中に、いくつかのデータの例を含めることができます：
- サブスクリプションID
- サブスクリプション商品
- サブスクリプション価格
- 購読状況
- 次回請求日
プロファイルは、複数のサブスクリプションを持っている場合、複数のオブジェクトレコードを持つことができ、このオブジェクトデータを使用してセグメントを作成し、パーソナライズされたメッセージやフローを送信することができます。
ご予約
顧客が予約できるビジネスであれば、プロファイルの予約データを保存するためにReservation オブジェクトを使用できます。
Reservationオブジェクトの各オブジェクトレコード内には、以下のようなデータの例があります：
- 予約ID
- 予約日
- 予約場所
- 予約状況
- 予約人数
プロファイルは複数の予約を持っている場合、複数のオブジェクトレコードを持つことができ、このオブジェクトデータを使用してセグメントを作成し、パーソナライズされたメッセージやフローを送信することができます。
ペット
ペットを飼っている人向けのビジネスであれば、Pet オブジェクトを使ってプロファイルのペットに関するデータを保存することができます。
ペット・オブジェクトの各オブジェクト・レコード内には、以下のようなデータの例があります：
- ペットのマイクロチップID
- ペットの名前
- ペットの種類（犬や猫など）
- ペット品種
- ペットの誕生日
複数のペットがいる場合、プロファイルは複数のオブジェクトレコードを持つことができ、このオブジェクトデータを使用してセグメントを作成し、パーソナライズされたメッセージやフローを送信することができます。
アカウント制限
お客様のアカウントのオブジェクトの上限は、Klaviyo Data Platformのアドバンスプランの有無と、お客様のアカウントのプロフィールの上限によって異なります。 この機能へのアクセスには、最低でも有料のメールプラン、またはKlaviyo Data Platformのアドバンストライアルが必要です。 アカウントファミリーでご利用の場合、Klaviyoデータプラットフォームのアドバンスプランの制限が適用されます。 課金の詳細については、Klaviyoでの共有課金の仕組みをご覧ください。
カスタムオブジェクトには3つのアカウント制限があります：
-
オブジェクト制限
アカウントが持つことができるオブジェクトの総数。 -
オブジェクトプロパティの制限
アカウントがオブジェクトごとに保有できるプロパティの数。 -
オブジェクトレコードの制限
アカウントに許可されるオブジェクトレコードの数。
利用可能なオブジェクトとオブジェクトレコードの数は、すべてのアカウントのアクティブなプロファイルの合計数に基づいています。レコードの上限はすべてのアカウントで共有されますが、オブジェクトの上限は各アカウントに個別に適用されます。
例えば、子供が5人いて、各アカウントのアクティブプロファイルが100,000である場合、アクティブプロファイルの合計は500,000となります。 下図に示すように、400,000以上のプロファイルを持つアカウントは、オブジェクトレコードの倍率が10倍です。その結果、これらのアカウントは合計で最大500万レコード（50万×10）を保存することができます。つまり、300万件のレコードを持つ1つのアカウントがあっても、残りの4つのアカウントのオブジェクトレコードの合計が200万件以下であればよいということです。 1アカウントあたりのオブジェクト数については、プロファイルを合わせると40万を超えるので、1アカウントあたり最大5つのオブジェクトを持つことができます。
Klaviyoデータプラットフォームアドバンスプランをご利用の場合、オブジェクトレコード倍率は、アカウント上のプロファイルの総数に基づいて計算されます。 Eメールプランのみをご利用の場合、この倍率はご利用のアカウントのアクティブプロファイルの上限に基づいて計算されます。
| プロファイル | Advanced KDP プラン | オブジェクト数 | オブジェクトプロパティの数 | オブジェクトレコード倍率 |
| 無料プラン | なし | 0 | 0 | 該当なし |
| 250 - 400,000 | なし | 1 | 15 | 10x |
| 有料 | 5 | 30 | 10x | |
| 40万人以上 | なし | 10x | ||
| 有料 | 10x |
また、すべてのアカウントには以下の制限があります：
- 1つのプロファイルにつき、1オブジェクトあたり最大500レコード。
- すべてのカスタムオブジェクトは8KB以下でなければなりません。
- 各カスタムオブジェクトのレコードは2KB以下でなければなりません。
オブジェクトの作成
Klaviyo でオブジェクトの作成を始めるには、[コンテンツ] > [オブジェクト] に移動し、[オブジェクトを作成] をクリックします。
ここから、自分でオブジェクトを作成するか、推奨されるオブジェクトテンプレートを選択できます。オブジェクトをすべて自分で作成するには、[自分で作成] ボタンを選択してください。
オブジェクト作成ワークフローの最初の部分では、オブジェクトに以下の情報を設定する必要があります：
-
名称
オブジェクトを識別するための名前 -
説明 (オプション)
オブジェクトが表すデータの説明 -
データソース
オブジェクトデータが存在するデータソース
新しいデータソースを作成するには、[データソース] のドロップダウンをクリックし、[データソースを作成] を選択します。
データソースを作成するには、以下の情報を設定する必要があります。
-
名前
オブジェクトデータのソースを識別するための一意の名前 -
説明（任意）
データソースの説明
オブジェクトIDの設定
オブジェクトの名前を設定し、データ・ソースを選択したら、次はオブジェクト ID を設定し、必要なオブジェクト・プロパティをマッピングします。このステップでは、カスタムオブジェクトAPIを通じてKlaviyoに送信されたデータソースに関連するデータをプレビューすることができます。
オブジェクトIDの設定は、オブジェクトレコード同士を区別するために必要です。一意のオブジェクト ID に使用するデータ・ソース・プロパティを指定する必要があります。
オブジェクト ID は、オブジェクト・レコードの特定のインスタンスを識別するために使用できる一意のデータ・ソース・プロパティでなければなりません。例えば、ギフトカードオブジェクトの場合、一意の割引コードのようなものをオブジェクトIDとして使うことができます。これはデータ・ソースのインスタンスごとに一意であり、オブジェクト・レコードごとに存在します。
Klaviyoがデータソースから同じオブジェクトIDのデータを受信するたびに、関連するオブジェクトレコードが更新されます。このため、適切なレコードが更新されるよう、オブジェクトIDが一意であることが重要です。
オブジェクトデータの送信
既存のオブジェクト レコードを更新すると、レコード全体が置き換えられます。したがって、1つのプロパティだけを更新したい場合でも、オブジェクトレコード全体を送信することが重要です。
例えば、レコード内の5つのプロパティのうち1つだけを更新したいとします。更新されたデータを ID と更新したい 1 つのプロパティだけで送信すると、他の 4 つのプロパティは null に設定されます。新しく NULL になったフィールドの 1 つがプロファイルのリレーションシップで使用されていた場合 (たとえば、電子メールアドレスのようなプロファイル識別子)、オブジェクトはそのプロファイルに関連付けられなくなります。
電話番号を送信する場合は、E.164形式でなければなりません。日付を送信する場合は、弊社が許容するタイムスタンプ形式のいずれかである必要があります。
マップオブジェクトのプロパティ
オブジェクトのプロパティをマッピングすることで、データソース内のどの情報をKlaviyoのオブジェクト内で利用できるかを選択することができます。
ドロップダウンで使用できるのは、プレビュー対象のデータ ソースの特定のインスタンスに表示されているデータのみです。新規データサンプル ］ボタンを使用して、データソースのインスタンスを循環させることができます。
しかし、このような理由から、標準化された日付とタイムスタンプ形式でオブジェクトデータをオブジェクト取り込みAPIを通じて送信することをお勧めします。特定のプロパティの値が不明な場合、そのプロパティにヌル値を設定することができます。
オブジェクトのプロパティをマッピングします：
- データ・ソース・プロパティ列で、オブジェクトに含めたいデータ・ソース・プロパティを選択します。
- Mapped property 列に、オブジェクト内でデータ・ソース・プロパティに付けたい名前を入力します。
- データ型の列で、データ・ソース・プロパティの適切なデータ型を選択します。
- Required列で、このプロパティをオブジェクトで必須にしたい場合はチェックボックスを選択します。
- 追加のオブジェクト・プロパティをマッピングする必要がある場合は、 Add mapping ボタンを選択します。
オブジェクト・プロパティがRequired に設定されている場合は、データ・ソースに存在する必要があり、NULL 値を設定することはできません。必要なプロパティが存在しない場合、オブジェクト・レコードは作成されません。
デフォルトでは、オブジェクト・マネージャ・インターフェースは1レベルの入れ子に対応しています。より深いデータにアクセスするには、選択したパスを手動で入力する必要があります。
例として、以下のデータソースを見てください。
{
" タイプ":"データ-ソース-レコード",
" 属性" ：{
" レコード" ：{
" child" ：{
" child_id":"d64b8458",
" name":{
"first": "Theodore",
"last": "Customer"
},
" birth_date":"2022-04-12",
" email":"jon.customer@klaviyo.com" 、"phone_numbers" ：[
" +11234567899",
" +13456789123"
]
}。
}
}
}関係追加
オブジェクトIDを設定し、オブジェクトのプロパティをマッピングしたら、次はオブジェクトにリレーションシップを追加します。
リレーションシップは、あなたのオブジェクトと関連するプロファイルを結びつけます。 リレーションシップを設定するには、以下の情報を定義します：
-
リレーションシップ名
関係の名前を設定します。例えば、ペット・オブジェクトがある場合、リレーションシップ名を "Pet owner "のように設定することができます。 -
ソース・データ
プロファイルに関連付けるデータ・ソースのプロパティを選択します。 -
プロファイル識別子
プロファイル識別子（Eメール、電話番号など）を設定します。 これは、オブジェクトをプロファイルに関連付けるためのデータソースに含まれている必要があります。プロパティと識別子のペアを追加するには、「Link another property 」ボタンを使用します。
マッピングの確認とオブジェクトの作成
オブジェクト・プロパティのマッピングとリレーションシップの設定が完了したら、確認モーダルでマッピングを確認し、[オブジェクトを作成] ボタンを選択します。オブジェクトが作成されると、既存のマッピングを編集することはできません。
Klaviyoのオブジェクト ページに、以下の情報とともにオブジェクトが表示されます：
- オブジェクト名
- 作成日
- 最終更新日
- ステータス
カスタムオブジェクトの状態
カスタムオブジェクトを公開する際のステータスは3種類あります：
-
ドラフト
オブジェクトはまだ編集可能で、パブリッシュやアクティブではありません。 -
パブリッシング
オブジェクトは、データソースに送信したデータからカスタムオブジェクトレコードを作成します。 データソースから数千レコードを送信した場合、オブジェクトは即座に公開されます。数百万件のレコードを送信した場合、公開に数時間かかることがあります。完了すると、ステータスはアクティブに変更されます。 -
アクティブ
オブジェクトはパブリッシュされ、ライブ状態です。すべてのカスタム・オブジェクト・レコードは、データ・ソースから送信されたデータに従って作成されています。このオブジェクトに送信された新しいデータは、あなたのプロファイルにリンクされた追加のカスタムオブジェクトレコードを生成します。
プロファイルページ上のオブジェクト
関連するオブジェクトは、プロファイルページにも表示されますので、プロファイルに関連するオブジェクトの記録を見ることができます。 オブジェクトの記録を表示するには、プロファイルページの「オブジェクト」タブに移動します。オブジェクトカードの上にあるドロップダウンメニューを使って、オブジェクトを切り替えることができます。
オブジェクトの全記録を表示するには、3つのドットメニューを選択し、[表示]をクリックします。オブジェクトの全記録を含むサイドパネルが表示されます。
オブジェクトの更新
カスタムオブジェクトを変更すると、アクティブなカスタムオブジェクトも変更されます。
オブジェクトの新しいデータの送信を開始したい場合は、追加のオブジェクト・プロパティをデータ・ソースに追加し、オブジェクト・マッピングを編集してこの新しいプロパティを含めます。以前に作成されたすべてのオブジェクトは、そのデータが利用できないため、このプロパティに対してNULLを返します。
まだオブジェクトにマッピングされていない新しいオブジェクト・プロパティを送信する場合、カスタム・オブジェクトを更新してそれを含めることができます。その後、すべてのカスタム・オブジェクト・レコードは、このデータを含むように再処理されます。
オブジェクトを更新するには
- Klaviyoサイドバーのコンテンツ> オブジェクトをクリックします。
- 編集したいオブジェクトの名前を選択します。
- 右上の「次へ 」をクリックします。
-
マップオブジェクトのプロパティセクションで 、マッピングの追加をクリックします。
このオプションは、オブジェクトに追加可能なプロパティがある場合にのみ使用できます。
- データ・ソース・プロパティ列で、オブジェクトに含めたいデータ・ソース・プロパティを選択します。
- Mapped property 列に、オブジェクト内でデータ・ソース・プロパティに付けたい名前を入力します。
-
データ型の列で、データ・ソース・プロパティの適切なデータ型を選択します。
新しくマッピングされたプロパティは、必須としてマークすることはできません。
- 右上の「次へ 」をクリックします。
- 右上の「次へ 」をクリックします。人間関係を変える必要はありません。
- 変更の公開をクリックします。
このプロセスを完了すると、データ・ソースからのすべてのレコードが再処理され、既存のカスタム・オブジェクト・レコードがそれに応じて更新されます。
オブジェクトの削除
一度削除したオブジェクトは元に戻せません。これらのカスタムオブジェクトを使用していたセグメント、フロー、テンプレート、キャンペーンは、意図したとおりに機能しなくなります。
オブジェクトを削除するには
- Klaviyoサイドバーのコンテンツ> オブジェクトをクリックします。
- オブジェクトの右にあるメニューで、Deleteをクリックします。
- オブジェクトの削除を確定するには、もう一度Delete をクリックします。
- オブジェクトと関連するすべてのカスタム・オブジェクト・レコードが削除されます。
以前のオブジェクトのデータ・ソースを使用して新しいカスタム・オブジェクトを作成する場合、新しいカスタム・オブジェクト・レコードは、すでに同期したデータを使用して生成されます。同じデータを使用していますが、新しいレコードを持つ新しいオブジェクトとみなされるため、すべてのセグメント、フロー、テンプレート、キャンペーンは、この新しいオブジェクトを使用するように更新する必要があります。