コンテンツを適応させる

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

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

ドキュメントの多くの部分を調整・パーソナライズできます。たとえば:

• 非表示にする、または表示する ページ

• サイトを非表示にする、または表示する バリアント

• サイトを非表示にする、または表示する セクション

• 非表示にする、または表示する ヘッダーリンク

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

条件エディタの使用

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

例

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

ベータプログラムの一部であるユーザーにのみページを表示する条件文を書きたい場合の例を見てみましょう。 ベータプログラムの一部であるユーザーにのみページを表示する と定義することができます。

visitor.claims.isBetaUser == true

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

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

オートコンプリートを使うと、 変数 も利用できることがわかります。定義した変数と、ユーザーデータから取得したクレームを組み合わせて、条件式を記述できます。たとえば、次のようにできます。

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

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

3. 最後に、ユーザーがドキュメントの最新バージョンを使っている場合にのみ特定のページを表示する式を書く

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

こちら

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

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

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

条件付きページ

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

からも起動できます。ページの横にページ条件アイコンがあれば、スペース内のどのページに条件が設定されているかを確認できます。 。

条件付きバリアント

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

します。バリアントにページ条件アイコンがあれば、ドキュメント内のどのバリアントに条件が設定されているかを確認できます。 。

条件付きセクション

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

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

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

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

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

インライン式

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

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

のプロパティとしてアクセスできます。

Git Sync での作業

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