コンテンツを適応させる

異なるユーザー向けにコンテンツを調整します

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

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

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

ユーザーを通じて GitBook に渡したデータは、 visitor.claims.

というオブジェクトに添付されます。次のような条件文を書きたい場合の例を見てみましょう。 ベータプログラムの一員であるユーザーにのみページを表示する と定義できます。

visitor.claims.isBetaUser == true

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

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

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

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

組み込みの visitor.type プロパティを使って、人間と AI エージェントに異なるコンテンツを表示します。このプロパティには次の 2 つの値のいずれかが入ります。

たとえば、この条件を使うと AI エージェントにのみコンテンツを表示できます。

visitor.type === "agent"

次の条件を使うと、人間の訪問者にのみコンテンツを表示できます。

visitor.type === "human"

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

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

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

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

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

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

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

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

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

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

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

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

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

クレームを通じて渡されるデータは Markdown には決して表示されず、安全に GitBook に渡されます。

最終更新 15 日前

役に立ちましたか？