カスタマーエージェントのプロファイルツール

このページで学べること

カスタマーエージェントのプロファイルツールとは何か、各ツールでできること、スキルの使用方法について説明します。これらのツールを使用すると、会話中にエージェントが買い物客の Klaviyo プロファイルを読み取り更新できます。これにより、応答をパーソナライズし、「私の…は何ですか」のような質問に回答し、新しいデータをプロファイルに取り込むことができます。

5 つのプロファイルツール

カスタマーエージェントには、認証済みの買い物客のプロファイル上のデータを読み取りまたは書き込みする 5 つの組み込みツールが用意されています。設定は不要です。どのスキルにもアタッチできます。

5 つすべてで、会話のコンテキスト（メールアドレス、電話番号、またはプロファイル ID）から買い物客を自動的に解決します。識別済みの買い物客に対してのみ機能します。

カスタマーエージェントの [ツール] ページで 5 つすべてを確認でき、スキルエディターから任意のスキルに添付できます。

それぞれを使用するタイミング

プロファイルを取得

エージェントが会話相手を把握する必要がある場合（名前、メール設定、直近の配送先住所、または保存している任意のカスタムプロパティなど）に使用します。

例：「こんにちは、Sarah！最後の注文は、末尾が 1234 の住所に発送されていることが確認できます。もう一度同じ住所を使用しますか？」

Get Profileは、ショッパーがどこにいるかも返します。会話に対してカスタマーエージェントが検出した国と、プロファイル上の場所です。国別に同じリクエストを異なる方法で処理するために使用します。

例：「Get Profileを呼び出して、買い物客の国を確認します。」国がカナダの場合は、注文がトロントの倉庫から発送されることを説明します。」

スキル全体またはコンテンツの一部を一部の国に限定するには、代わりに地域を使用してください。複数の国と地域向けにカスタマーエージェントを設定する方法をご覧ください。

プロファイルイベントを取得

エージェントが買い物客の行動を把握する必要がある場合に使用します。注文、メールの開封、フォームの送信、ページビュー、購読など、プロファイル上のイベントとしてトラッキングされるあらゆるものです。

例：

• 買い物客が「私の前回の注文はいつでしたか？」と尋ねます。このスキルは、イベントタイプ = Placed Order でプロファイルイベントの取得を添付し、日付で応答します。
• 買い物客が「カートに何が入っていましたか？」と尋ねますスキルは イベントタイプ = Added to Cart の Get Profile Events を添付し、商品をリストで返します。

ツールを添付する際に、ツール サイドバーでイベント タイプとその他の設定を選択します。詳細は、以下の ツールを添付する際の設定 をご覧ください。

プロファイルのリストとセグメントを取得

エージェントの動作を、買い物客がどのオーディエンスに属しているかに応じて変える必要がある場合に使用します。VIP 顧客？すでに再入荷リストに登録済みですか？プロモーションメールの対象外ですか？

例： 購入者が VIP セグメントに属している場合、エージェントは返品時に無料のアップグレードを提供します。

プロファイル予測サマリーを取得

Klaviyo の予測インサイト（顧客生涯価値、チャーン リスク、次回購入の予測、顧客ヘルス スコア）が必要な場合に使用します。

例: リテンション スキルは、解約リスクをチェックしてから、継続を促す割引を提示します — リスクが高い購入者には、より強いオファーが表示されます。

プロファイルプロパティを更新

会話中にエージェントが購入者のプロファイルに何かを書き戻す必要がある場合（クイズの回答、好み、フィードバックなど、通常フォームで収集するあらゆる情報）に使用します。

例：

• 買い物客がクイズに回答する：「アーシーな香りが好みです。」→ エージェントが scent_preference: earthy を作成します。
• 購入者が返品時にフィードバックを提供します。「合いませんでした。小さめでした。」→ エージェントが last_return_reason: sizing を保存します。

プロパティがプロファイルに追加されると、Klaviyo の他のあらゆる要素（フロー、セグメント、キャンペーン、今後のカスタマーエージェントとの会話）で使用できます。

スキルでこれらのツールを使用する方法

1. 更新するスキルを開きます（または新しいスキルを作成します）。
2. スキル エディターで、必要なプロファイル ツールを添付してください。
3. ツールに構成入力がある場合は、それらを入力します（以下を参照）。
4. 対応方法セクションで、各ツールをいつ、どのように使用するかをスキルに伝えてください。具体的に記述してください：
   • エージェントがツールを呼び出すタイミング
   • 結果に対して何を行うべきか
   • プロファイルプロパティを更新の場合：書き込むプロパティ、値の形式、そして書き込むべきでないタイミング

ツールを接続する際のツールの設定

一部のプロファイルツールには、スキルレベルで事前入力できる入力項目があります。事前入力すると、スキルが行うすべての呼び出しで値が固定されるため、より厳密に制御でき、実行時にエージェントが値を判断する手間も省けます。

[プロファイル イベントを取得] が主な例です。スキルにアタッチすると、次を設定できます：

• イベントタイプ （必須） — 取得するメトリック（例：Placed Order、Checkout Started、Added to Cart、Opened Email、Viewed Product）。
• 制限 — 返す最近のイベントの数。最新のものだけが必要な場合は 1 を使用します。
• 並べ替え順 — 新しい順または古い順。
• Lookback window — どこまでさかのぼって検索するか。デフォルトは 90 日です。

たとえば、買い物客の最新のカートを確認する必要があるスキルでは、イベントタイプ = Checkout Started、制限 = 1、並べ替え順 = Newest first、ルックバック ウィンドウ = 30 days の Get Profile Events を添付することがあります。これにより、エージェントはそれらの選択について考える必要がありません。あらかじめ組み込まれています。

例：「How to respond」スニペット（プロファイルプロパティを更新）：

購入者が香りの好みを伝えたら、Update Profile Property を呼び出して、scent_preference プロパティに次のいずれか（floral、earthy、citrus、fresh）を使用して保存します。購入者が明確に確認した場合にのみ記述してください。購入者への保存の確認は、1 文で行ってください。

例「How to respond」スニペット（Get Profile + Get Profile Events）：

購入者がお客様の最近の注文について質問した場合は、Get Profile Events を呼び出して注文履歴を取得します。日付、アイテム数、現在のステータスを含めて結果を要約します。購入者が自分が誰か、または記録されている内容について質問した場合は、Get Profile を使用します。

(Attach Get Profile Events with [イベントタイプ] = Placed Order, [制限] = 3, [並べ替え順].)

ヒント

• 書く前にお読みください。応答をパーソナライズする場合は、最初に Get Profile または Get Profile Events を添付してください。エージェントは、取得していないデータを参照できません。
• プロパティは、まず存在している必要があり、かつカスタム プロパティである必要があります。プロファイルプロパティの更新は、会社のプロファイル上にすでに存在する custom プロファイルプロパティにのみ書き込みます。システム フィールド（Email、First Name、phone number、location subfields）と派生フィールド（Created、First Active、$id）は書き込みできません。まず Klaviyo でカスタム プロパティを作成し、正確な名前でそのプロパティをスキルに関連付けてください。
• 作成時に値のセットを制約します。スキルの手順で許可される値を明記します（「次のうちのいずれか：フローラル、アース、シトラス、フレッシュ」）。値を明記しないと、エージェントが自由入力のテキストを書いてしまい、セグメントが一致しなくなります。
• いつ書かないかをエージェントに伝えてください。「買い物客が明確に確認した場合にのみ書き込む」は、誤った上書きを防ぎます。
• 買い物客への書き込みを確認します。「承知しました。設定として保存しました。」などの短い返信で一連の寄り取を完了させます。
• ツールを問い合わせに合わせます。「自分が前に何を購入したか確認したい」 → プロファイルイベント。「自分がVIPかどうか確認したい」 → リストとセグメント。「自分が解約する可能性はどのくらい？」 → 予測サマリー。
• Composerを使用してこれらを接続してください。わかりやすい英語で希望を記述すると、Composerが適切なツールを追加し、確認して公開できるようにスキルの手順を下書きします。たとえば：「レコメンデーションスキルで、買い物客のカートに入っていた内容を参照して、類似の商品をおすすめしたい。」
• 国で分岐する前にリージョンを使用してください。スキル全体が一部の国にのみ適用される場合は、そのスキルでリージョンを設定してください。1つのスキルに国別の小さな違いが必要な場合は、Get Profileを使用してください。

これらのツールでできないこと

• これらは匿名の会話に直接は機能しません。エージェントがこれらのツールのいずれかを呼び出そうとしても、買い物客が特定されていない場合は、先にログインするよう買い物客に求められます。特定されると、ツールが実行されます。
• [プロファイルプロパティを更新] では、新しい購入者は作成されません。プロファイルはすでに存在している必要があります。
• [プロファイルプロパティを更新] はイベントを書き込みません。イベントの書き込みは別のツールになります — 近日公開予定です。
• 読み取りツールはいずれもデータを変更しません。フェッチするだけです。

FAQ

Update Profile Property を使用して任意のプロファイルプロパティに書き込めますか？

カスタム プロファイルプロパティ（scent_preference や isMom など、プロファイルで定義するもの）のみです。システムフィールド（Email、First Name、$phone_number）、$locale_country などの位置情報のサブフィールド、Viewed Items などの list-patch フィールドは、現時点では書き込みできません。システムが計算して生成する派生フィールド（Created、First Active、$id）は、恒久的に読み取り専用です。

プロパティがまだ存在しない場合はどうなりますか？

このツールは、プロファイル上にすでに存在するプロパティのみを読み取り、書き込みます。まず Klaviyo でプロパティを作成し（例：テスト用プロファイルに設定する、またはフロー経由で設定する）、その後、名前でスキルがそのプロパティを参照するように指定してください。

1 回のターンで、スキルから複数のプロファイルツールを呼び出せますか？

はい。スキルは、1 回の応答で任意の組み合わせのプロファイル ツールを呼び出せます。たとえば、応答する前に全体像を把握するために、Get Profile と Get Profile Events を一緒に使用できます。

匿名の買い物客の場合はどうなりますか？

エージェントがこれらのツールのいずれかを使用しようとしても購入者が特定されていない場合、購入者にログインするよう求められます。特定されるとツールが実行され、会話が継続します。

これらのツールには、Klaviyo の他の機能と同じ同意ルールが適用されますか？

はい。データは Klaviyo の標準的なプロファイルおよび同意モデルを通じて流れます。

次の手順

• カスタマーエージェントのツールについて
• スキルについて理解する
• 完全にカスタムのスキルを作成する方法

関連記事