コンテンツの適応

ユーザーごとにコンテンツを最適化する

認証方法を設定すると、そのデータを使ってサイトのコンテンツをさまざまなユーザー向けに調整できるようになります。

ドキュメントの多くの部分を調整してパーソナライズできます。たとえば、以下のようなものです:

• 非表示または表示 ページ

• サイトの非表示または表示 バリアント

• サイトの非表示または表示 セクション

• 非表示または表示 ヘッダーリンク

• 次に、パーソナライズされたコンテンツを追加する インライン式

条件エディタの使い方

条件エディタでは、ページ、バリアント、またはセクションを表示するか非表示にするかの条件を設定します。条件エディタを開いたら、条件を次のような 式 として記述し、サイトの訪問者から送られてくるデータに対して実行できます。

例

ユーザーを通じて GitBook に渡したデータは、次の名前のオブジェクトに付加されます visitor.claims.

たとえば、ベータプログラムの参加者にだけページを表示する条件文を書きたい場合を見てみましょう。 ベータプログラムの参加者であるユーザーにだけページを表示する と定義できるかもしれません。

visitor.claims.isBetaUser == true

上の式は、このクレームに一致するユーザー、つまり isBetaUser が true （ユーザーのクレーム内で true）であるユーザーは、そのページを表示してアクセスできます。このクレームに一致しないユーザー（クレームが設定されていない訪問者を含む）は、そのページを表示もアクセスもできません。

条件エディタにはオートコンプリートも組み込まれており、サイトの過去の訪問者から見つかったクレームや属性を提案して、ページ、バリアント、またはセクションの条件文作成を支援します。

オートコンプリートを使っていると、 変数 も使用できることに気づくでしょう。ユーザーデータから得られるクレームと、定義済みの変数を組み合わせて条件式を書くことができます。たとえば、次のようなことができます。

1. 製品の最新バージョン用の変数を設定する

2. 次に、ドキュメントを閲覧している訪問者がどのバージョンの製品を使用しているかを示すクレームを設定する

3. 最後に、ユーザーがドキュメントの最新バージョンを使用しているときだけ特定のページを表示する式を書く

有効な JavaScript で書かれていれば、さまざまな種類の式を記述できます。たとえば、 && または || 演算子 を使って複数のクレームを条件エディタで組み合わせ、特定のユーザーに一致させることができます。演算子について詳しくは.

こちら

セグメントを使ったテスト

セグメントは、条件のテスト用に設定できるモックユーザーデータを表します。

たとえば、エンタープライズプランの開発者や、無料プランのサインイン済みユーザーを表すセグメントを設定し、どのページがそのユーザーに表示されるかを確認できます。

条件付きページ

ページの条件エディタを開くには、ページの横にあるアクションメニューに移動し、 をクリックします。 条件を追加。 条件エディタは、 ページのオプション.

からも開けます。ページにページ条件アイコン が付いている場合、そのスペース内で条件が設定されているページを確認できます。

条件付きバリアント

バリアントの条件エディタを開くには、バリアントの横にあるアクションメニューに移動し、 をクリックします。 条件を追加.

バリアントにページ条件アイコンが付いている場合、ドキュメント内で条件が設定されているバリアントを確認できます。 が付いている場合、そのスペース内で条件が設定されているページを確認できます。

条件付きセクション

セクションの条件エディタを開くには、セクションの横にあるアクションメニューに移動し、 をクリックします。 条件を追加.

セクションにページ条件アイコンが付いている場合、ドキュメント内で条件が設定されているセクションを確認できます。 が付いている場合、そのスペース内で条件が設定されているページを確認できます。

条件付きページヘッダーリンク

ページヘッダーリンクの条件エディタを開くには、ヘッダーリンクの横にあるアクションメニューに移動し、 をクリックします。 条件を追加.

セクションにページ条件アイコンが付いている場合、ドキュメント内で条件が設定されているリンクを確認できます。 が付いている場合、そのスペース内で条件が設定されているページを確認できます。

インライン式

コンテンツの表示/非表示を制御するだけでなく、 式を使って、ページやスペースの変数と同じようにインラインでクレームを使うこともできます。

式を使ってインラインでクレームを参照するには、エディタで / と入力し、次に 式を選択します。クレームは、 visitor .

Git Sync の使用

GitBook で設定された条件は Git Sync を通じて同期され、同期済みの Markdown ページに表示されます。つまり、表示条件が設定されたブロックやページも、同期されたリポジトリ内では引き続き表示されます。

クレームを通じて渡されたデータは Markdown に表示されることはなく、安全に GitBook に渡されます。