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

このページで学べること

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

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

これらの5つの組み込みツールは、認証済みの買い物客のプロファイル上のデータを読み取るか、または書き込みます。これらをカスタムスキルに追加できます。ツールによっては、追加時にイベントタイプやプロファイルプロパティなどの入力を選択する必要があります。

5つはすべて、会話のコンテキスト（メール、電話番号、またはプロファイルID）から購入者を自動的に解決します。これらは、識別済みの購入者に対してのみ機能します。

これらのツールを表示するには、カスタマーエージェント>コネクタに移動し、次にKlaviyoを選択します。スキルエディタからカスタムスキルに追加できます。

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

プロファイルを取得

エージェントが誰と会話しているのかを把握する必要がある場合に使用します。名前、メール設定、プロファイルに保存されている住所、または保存している任意のカスタムプロパティなどが該当します。

例：「こんにちは、サラさん！」プロファイルに記載されている住所が1234で終わっているようです。またその住所を使用しますか？」

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

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

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

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

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

例：

• 買い物客が「私の前回の注文はいつでしたか？」と尋ねます。このスキルは、イベントタイプ = Placed Order でプロファイルイベントの取得を添付し、日付で応答します。
• 買い物客が「最近カートに追加したものは何ですか？」と質問します。このスキルは、イベントタイプ = Added to CartのGet Profile Eventsを関連付け、アイテムを一覧で返します。

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

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

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

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

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

購入者やスキルがKlaviyoの予測インサイト（顧客生涯価値、チャーンリスク、または次回購入の予測）を必要とする場合に使用します。

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

すべてのプロファイルで予測を利用できるわけではありません。予測データがない場合（例：予測に基づくオファーなしで続行する場合）にスキルが実行する内容を指定します。

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

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

例：

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

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

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

プロファイルプロパティの更新では、ツールをスキルに追加する前に、Klaviyoでカスタムプロパティを作成してください。たとえば、テスト用プロファイルに設定して、プロファイルプロパティセレクターで利用できるようにします。

1. [カスタマーエージェント] > [スキル]と進み、カスタムスキルを開くか、[スキルを作成]をクリックします。新しいスキルの場合は、名前を入力し、[このスキルを使用するタイミング]を完了してください。
2. 応答方法に/を入力し、ツールメニューからプロファイルツールを選択してください。
3. ツールの設定サイドバーが開いた場合は、必要な入力と任意の設定を選択し、保存をクリックします。下記のツールを添付するときの設定を参照してください。これらの設定を後で変更するには、エディタで挿入されたツールをクリックします。必要な各ツールについて、手順2～3を繰り返してください。
4. 対応方法セクションで、各ツールをいつ、どのように使用するかをスキルに伝えてください。具体的に記述してください：
   • エージェントがツールを呼び出すタイミング
   • 結果に対して何を行うべきか
   • プロファイルプロパティを更新の場合：書き込むプロパティ、値の形式、そして書き込むべきでないタイミング
5. 新しいスキルを作成している場合は、下書きとして保存をクリックして保存し、詳細を開きます。
6. 手順を確認し、下書きのスキルの場合は公開を、公開中のスキルの場合は更新をクリックしてください。これにより、変更がライブ会話で利用可能になります。

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

一部のプロファイルツールでは、挿入する各ツールに対して事前に入力できる入力項目があります。事前入力を行うと、そのツールインスタンスの各呼び出しで値が固定されるため、より厳密に制御でき、実行時にエージェントが値を推測する必要がなくなります。

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

• イベントタイプ （必須） — 取得するメトリック（例：Placed Order、Checkout Started、Added to Cart、Opened Email、Viewed Product）。
• 制限 — 返すイベントの最大数。1、5、10、25、または50を選択します。デフォルトは10です。最新のイベントを取得するには、1件のイベントと新しい順を選択します。
• 並べ替え順 — 新しい順（デフォルト）または古い順。
• Lookback window — どこまでさかのぼって検索するか。デフォルトは 90 日です。

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

プロファイルプロパティを更新では、プロファイルプロパティを選択する必要があります。ツールが更新する既存のカスタムプロパティを選択し、保存をクリックしてください。応答方法で、どの値を保存するか、およびいつ保存するかをエージェントに伝えてください。

プロファイルリストとセグメントの取得では、メンバーシップタイプを選択して、リスト、セグメント、またはその両方を返すようにできます。デフォルトでは両方が返されます。

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

買い物客から香りの好みを伝えられたら、プロファイルプロパティの更新を呼び出して、次のいずれか（floral、earthy、citrus、fresh）を使用してscent_preferenceプロパティに保存します。買い物客が明示的に確認した場合にのみ書き込んでください。ツールが成功を報告した場合にのみ、保存したことを買い物客に1文で確認してください。失敗した場合は、設定が保存されなかったことを説明してください。

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

買い物客が最近の注文について尋ねた場合は、Get Profile Eventsを呼び出して注文履歴を取得してください。それらのイベントに記録されている日付と、利用可能な注文の詳細を要約してください。買い物客が自分が誰か、またはファイルに何が記録されているかを尋ねた場合は、Get Profileを使用してください。

（イベントタイプ = Placed Order、制限 = 5 events、並べ替え順 = 新しい順で、プロファイルイベントの取得を添付します。）

ヒント

• 書く前にお読みください。応答をパーソナライズする場合は、最初に Get Profile または Get Profile Events を添付してください。エージェントは、取得していないデータを参照できません。
• プロパティは、まず存在している必要があり、かつカスタムプロパティである必要があります。プロファイルプロパティを更新は、会社のプロファイルにすでに存在するカスタムプロファイルプロパティにのみ書き込みます。システムフィールド（メール、名、電話番号、ロケーションのサブフィールド）と派生フィールド（作成日時、最初のアクティブ、$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の標準のプロファイルおよび同意モデルを通じてフローします。Update Profile Propertyでカスタム設定を保存しても、買い物客がマーケティングを購読することにはなりません。

次の手順

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

関連記事