カスタムオブジェクトに関するよくある質問
このページで学べること
Klaviyo のカスタム オブジェクトに関連するよくある質問をご覧ください。以下のリソースに質問が見当たらない場合は、コミュニティフォーラム からお問い合わせください。
オブジェクトに関する一般的な質問
オブジェクトを作成するには開発者が必要ですか？
はい。この機能は、API を使用してデータソースを送信し、最終的にオブジェクトを作成することに依存します。
Klaviyo のフォームまたは CSV アップロードを使用してカスタムオブジェクトを作成できますか？
Klaviyo では現在、新しいカスタムオブジェクトを作成するために、API 経由でデータを送信していただく必要があります。
カスタム オブジェクトとプロファイルプロパティまたはイベントは、いつ使い分けるべきですか？
カスタムオブジェクトが表すカテゴリとプロファイルの間に多対 1 の関係がある場合は、カスタムオブジェクトを使用してください。たとえば、顧客のペットに関する情報を保持したい場合に、顧客が複数のペットを飼っている可能性があるなら、これらをカスタムオブジェクトとして表す方が、プロファイルプロパティやイベントよりもはるかに適しています。
メンバーシップ ステータスのように、プロファイルが同時に保持できるステータスが 1 つのみである項目をトラッキングする場合は、プロファイルプロパティの方が適しています。ただし、プロファイルのメンバーシップに関する他の詳細も保存したい場合は、オブジェクトの方が適していることがあります。
メールの受信者がメールを開封した回数など、広範囲のものをトラッキングする場合は、イベントの使用をおすすめします。
作成後にカスタムオブジェクトを更新できますか？
はい。カスタムオブジェクトには、必須ではない追加プロパティをいつでも追加できます。詳しくは、カスタムオブジェクトを更新するをご覧ください。
イベントを送信するのと、カスタムオブジェクトのプロパティを更新するのとでは、どちらを行うべきですか？
イベントはフローを迅速にトリガーすることを目的としており、タイムリーで関連性の高いメッセージを送信できます。オブジェクトのステータスが変わり、その結果としてメッセージをトリガーしたい場合は、新しい情報でオブジェクトを更新し、フローをトリガーするためのイベントを送信してください。
イベント トリガー フロー内のオブジェクト情報を使用して、テンプレートをパーソナライズできます。これを実現する方法は 2 つあります。
{{ event }}タグを使用して、テンプレートで使用するイベントのメタデータに関連プロパティを追加します。これは、タイムリーさが重要な場合に効果的です。- オブジェクトの ID をイベントのメタデータに含めます。これにより、
{% customobject id={{ event.pet_id }} as pet %}を使用してテンプレートでオブジェクトを取得できます。ただし、オブジェクトが最新のプロパティで更新されるまでに時間がかかる場合があるため、オブジェクトが更新される前にフローがメッセージ送信をトリガーした可能性があります。
オブジェクト データ送信に関する質問
カスタムオブジェクトのデータ送信を開始するにはどうすればよいですか？
- API を使用して新しいデータソースを作成します。
- データ構造を定義します（JSON の例を参照）。
- API 経由でデータソースのレコードを Klaviyo に送信します。
- 作成して、カスタムオブジェクトを作成します。
- カスタムオブジェクトとプロファイルの間のリレーションシップを作成します。
データソースはどのように作成され、どのように使用されますか？
カスタムオブジェクトはデータソースから作成されます。開発者は、カスタムオブジェクト API を使用して新しいデータソースを作成する必要があります。
新しいデータソースを作成すると、Klaviyo は API リクエストへのレスポンスの一部として一意の識別子を返します。これにより、Klaviyo はデータソースを識別できます。特に、アカウントに複数のデータソースがある場合（例：ブランドがビジネスで依存している各カスタム外部連携、データウェアハウス、またはカスタムサードパーティ外部連携ごとに 1 つ）に役立ちます。
この一意の識別子を使用して、開発者は Klaviyo の API を介してデータソースレコードを作成できます。
データはどのようにフォーマットすればよいですか？
開発者は、JSON 形式のデータを Klaviyo に送信する必要があります。データは、カンマ区切りリストを含むテキストとして送信することをお勧めします。セグメンテーションとフローフィルターの「含む」演算子を使用して、このカンマ区切り文字列内の値で絞り込めるようになります。フィルタリングの詳細については、セグメント条件リファレンス を参照してください。
カスタムオブジェクトでサポートされている データ型：
- テキスト
- 整数
- 小数
- 日付 - すべての日時はシステム内で UTC に変換されます。たとえば「2025-04-03」をアップロードすると、「2025-04-03 00:00:00」に変換されます。タイムゾーンが 3時間進んでいる顧客の場合、日時は「2025-04-02 21:00:00」と表示されます。
- ブール型
リスト データ型は現在サポートされていません。データソース レコード API のペイロード例については、データソース レコードの一括作成を参照してください。
電話番号を送信する場合は、E.164 形式である必要があります。日付を送信する場合は、許容されるタイムスタンプ形式のいずれかである必要があります。
カスタム オブジェクトのデータ上限はどのくらいですか？
プロパティごとに最大 2 KB、レコード合計で最大 8 KB までアップロードできます。
ネストされたデータでマッピングできますか？
カスタム オブジェクトに使用したいプロパティをネストせずに、JSON オブジェクトを定義することを推奨します。ソース データが深くネストされている場合、またはリストを使用している場合は、オブジェクト マネージャーに JSON パスを手動で入力する必要があります。リストの場合、プロパティをそのリスト内の位置にのみマッピングできます（例：1 つ目または 2 つ目の値）。
1 つのプロファイルに複数の識別子を関連付けできますか？
はい。2 つ以上のプロファイル識別子（例：メールアドレスと電話番号）を使用してカスタムオブジェクトのレコードをプロファイルに関連付ける場合は、どちらか一方の値が null であっても、すべての同期に両方のプロパティを含めてください。
フローでオブジェクトを使用する際の質問
オブジェクトでフローがトリガーされず、イベントの object id がない場合でも、メッセージングをパーソナライズできますか？
はい、メッセージをパーソナライズする際に [オブジェクトフィルター] を使用して適切なオブジェクトを見つけることができます。
オブジェクトがフローをトリガーした場合、フロー メッセージをプレビューできますか？
現時点では、{{ object }} タグを使用している場合、アプリのプレビュー機能を使用してメッセージを表示することはできません。
フローのメッセージをテストするには：
- 日付トリガー フローを作成し、ライブに設定します。
- 少なくとも 24 時間後にトリガーされる日付を含むオブジェクトでプロファイルを作成します。
Webhook や Klaviyo コードなどのフローアクションを使用して、オブジェクトを更新できますか？
現時点では、まず元のデータ ソースを更新し、その後、許可されている形式で改訂したオブジェクトを Klaviyo に送り返すことを推奨します。この 2 つのシステムの同期がずれると、システムから古いレコードを Klaviyo に送り返してしまい、元の値に戻ってしまうリスクがあります。