パーソナライズ

Fóirは、リクエストに応じる前に、コンテンツのどのバージョンを返すかを決めます。Webサイト、ネイティブアプリ、エージェントが同じ問いかけをして同じコンテンツを受け取り、クライアント側で解決することは何も残りません。

実際のレコードで試す

このパネルはFóir APIから実際のレコードを読み取っています。稼働中のブランドのホームページのヒーローです。訪問者を切り替えると、同じクエリで異なるコンテンツが返ります。

サイトが伝えるのは、カートにどの種類の商品が入っているかだけです。訪問者がどこにいるか、何を購入したか、いくら使ったかはFóirがサーバー側で判断するため、リクエストを書き換えてパリに移ったりVIPになったりすることはできません。このページでは、各ケースを確認できるように、それらを自分で設定します。

サイトから送信される内容

カートに何が入っていますか?

Fóirがサーバー上で算出する内容

訪問者はどこにいますか?
これまでにランニングシューズを購入したことがありますか?
これまでの購入額はいくらですか?

返ってきた結果

サイトが送信する読み取り内容

personalisationDemo(
  naturalKey: "home-hero"
) {
  heading
  body
  ctaLabel
  _variant
}

Fóirがサーバー上で追加する内容

location
51.51,-0.13
segment.runner
false
segment.vip
false

サーバーが選ぶ

読み取りでは、リクエストについて分かっていることをFóirに伝えます。デバイス、ロケール、そして独自のディメンション、たとえばカート内の商品の種類や、訪問者がどの市場で買い物をしているかなどです。残りはFóirが自分で補います。リクエストの発信元、ユーザーがサインインしているかどうか、所属するセグメントです。

Fóirは、ルールに一致するバリアントを選び、そのバリアントの値がすでに入った状態でレコードを返します。コードは、どちらのバージョンが返っても同じフィールドを読みます。

訪問者が主張できないもの

場所、サインイン状況、セグメントへの所属、プロフィールデータは、呼び出し元からは決して受け取りません。Fóirがリクエストの発信元を自分で特定し、残りはリクエストの主張にかかわらず、ユーザーのトークンから導き出します。

セグメントのルールは、クライアントに見せないプロフィールフィールドも読めます。そのため、非公開にしている値でも、顧客に何を見せるかを決められます。

オーディエンスは一度だけ定義する

バリアントの対象は、バリアントカタログのエントリーで決まります。優先度を持つ名前付きのルールの集合です。ルールは、ディメンションとセグメントをANDとORで組み合わせられます。

いくつでもレコードが1つのエントリーを指せます。エントリーを編集すると、それを使うすべてのバリアントのターゲットが変わります。

ページ、フィールド、段落

バリアントは、独自の下書きとバージョン履歴を持つレコード全体を置き換えられます。1つのフィールド、またはproseフィールドやリストの中の1エントリーだけを上書きして、残りはそのままにすることもできます。

編集者は、各バージョンを同じエディターで書き、対象のオーディエンスとして下書きをプレビューします。

例:パリのマラソン

あるランニングブランドは、ホームページの先頭でマラソンを取り上げたいと考えています。ただし対象は、パリにいて、以前にそのブランドでランニングシューズを購入した人だけです。

どちらの事実もサイトからは得られません。Fóirがリクエストごとに発信元を特定するため、ルールでパリから30km以内の訪問者を指定できます。セグメントはサインイン済みの顧客のプロフィールを読み取ります。購入したカテゴリにランニングシューズが含まれる、という条件です。

1つのカタログエントリーがこの2つを組み合わせ、マラソンの見出しと画像を持つホームページのバリアントがそれを指します。フロントエンドは何も変わりません。

その読み取りが返すもの

この読み取りは、すべての訪問者のページがすでに行っているもので、顧客のトークンを付けて送ります。パリにいてランニングシューズを購入済みの顧客にはマラソンのページが返り、レスポンスの_variantが、配信されたバリアントを示します。

リヨンにいる訪問者や、サインインしていない人には、既定のページが返ります。セグメントはリクエストのたびに評価されるため、同期し続けるランナーのリストはありません。

例:合計購入額によるVIP

VIPオーディエンスは1つのセグメントです。顧客のプロフィールの合計購入額が、自分で選んだしきい値を超えている、というルールです。

カタログエントリーをそれに向ければ、バナー、価格表、ランディングページ全体のいずれでも、あらゆるレコードがVIP向けのバージョンを持てます。顧客は、しきい値を超えた後の最初の読み取りでそれを目にします。

プレビュー、キャッシュ、トレース

エディターは、選んだロケールとオーディエンスで下書きを解決するため、承認した内容がそのまま公開されます。解決済みのバリアントを含むレスポンスはプライベートとしてマークされ、共有キャッシュには保存されません。

読み取りのデバッグ用スイッチは、検討されたバリアントと、1つが返された理由を、デバッグスコープを持つキーに報告します。

詳細を読む

バリアント、オーディエンスとセグメント、読み取り時の解決はそれぞれ一部を詳しく扱っており、ルールの構文はターゲティングガイドにあります。