> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/exoclick-docs/ja/fmatto.md).

# 広告フォーマット

広告主がキャンペーンで使用でき、パブリッシャーが広告ゾーンで確認できる広告フォーマットは多数あります。

## Web

### バナー

![バナー](https://content.gitbook.com/content/FueMjjtWG3dON1cRyiko/blobs/0eQ22SMFUAT6WDrmg9lj/assets/hires/adformats/display-banner.png)

これらはクラシックなディスプレイバナーで、さまざまなサイズがあります。

#### **利用可能な料金モデル**

* CPC
* CPM
* スマートCPM
* スマート入札

#### **クリエイティブ要件**

* 画像: JPEG、PNG、またはGIF。以下のいずれかのサイズ: 300×250、300x500、728×90、160×600、または900×250（最大容量300 KB）
* 動画: MP4動画。以下のいずれかのサイズ: 300×250、300x500、728×90、160×600、または900×250（最大容量1500 KB）
* iframe: 幅と高さ属性が選択したサイズに対応するiframeコード: 300×250、300x500、728×90、160×600、または900×250。
* 複数の画像を1つに結合したクリエイティブは許可されません。

{% hint style="info" %}

* MP4動画バナーを使用するキャンペーンはUC Browserには表示されません。
* ビデオバナーと混同しないでください [動画広告](#video).
  {% endhint %}

### スティッキーバナー

![スティッキーバナー](https://content.gitbook.com/content/FueMjjtWG3dON1cRyiko/blobs/RZQqCdFrYtyI8EG00qpj/assets/hires/adformats/sticky-banner-1.gif)

デスクトップ画面上の特定の位置に「固定」表示できるディスプレイバナーです。スティッキーバナーにはさまざまなサイズがあります。

#### **利用可能な料金モデル**

* CPC
* CPM
* スマートCPM
* スマート入札

#### **クリエイティブ要件**

最大容量300 KB:

* 画像: JPEG、PNG、またはGIF。以下のいずれかのサイズ: 300×250、728×90、160×600、または900×250（最大容量: 300 KB）
* 動画: MP4動画。以下のいずれかのサイズ: 300×250、728×90、160×600、または900×250（最大容量: 1500 KB）
* iframe: 幅と高さ属性が選択したサイズに対応するiframeコード: 300×250、728×90、160×600、または900×250。
* 複数の画像を1つに結合したクリエイティブは許可されません。

### ポップアンダー

![ポップアンダー](https://content.gitbook.com/content/FueMjjtWG3dON1cRyiko/blobs/udV9JtSlIbHmTl1jNruK/assets/hires/adformats/popunders-1.gif)

ユーザーがパブリッシャーのサイトからリンクをクリックすると、広告主のURLが新しいブラウザタブに表示されます。フォーカスはパブリッシャーのサイトに残り、ユーザーが現在のブラウザタブを閉じると広告が表示されます。

パブリッシャーは、サイト内の任意のリンクをクリックしたとき、または特定のクラスを持つリンクをクリックしたときに表示される広告ゾーンをカスタマイズできます。

#### **利用可能な料金モデル**

* CPM
* スマートCPM
* スマート入札

#### **クリエイティブ要件**

* 広告主のランディングページURL

### インスタントメッセージ

![インスタントメッセージ](https://content.gitbook.com/content/FueMjjtWG3dON1cRyiko/blobs/ryny6sd8zr94hk5MkQ9J/assets/hires/adformats/instant-message-1.gif)

これは通常、インスタントメッセンジャーのチャットボックスを模したものです。この広告フォーマットは、ページ下部に300×250の広告を表示してユーザーに見せます。

#### **利用可能な料金モデル**

* CPC
* CPM
* スマートCPM
* スマート入札

#### **クリエイティブ要件**

* 画像: 300×250 JPEG、PNG、またはGIF（最大容量: 300 KB）
* 動画: 300×250 MP4動画（最大容量: 1500 KB）
* iframe: 300×250のiframeコード
* 複数の画像を1つに結合したクリエイティブは許可されません。

### デスクトップフルページインタースティシャル

![デスクトップフルページインタースティシャル](https://content.gitbook.com/content/FueMjjtWG3dON1cRyiko/blobs/GziOeVEffdLe3RHb0XbX/assets/hires/adformats/desktop-full-interstitial-1.gif)

サイトからリンクをクリックした後、画面全体を埋める1600 x 900の大きな横長バナーです。下にあるパブリッシャーのサイトが見えるように少し余白があります。訪問者が別のタブに移動したとき、または **広告を閉じる** ボタンがクリックされたときに通常の閲覧に戻ります。

この広告フォーマットは、デスクトップ、スマートTV、コンソール端末の画面でのみ機能します。

#### **利用可能な料金モデル**

* CPC
* CPM
* スマートCPM
* スマート入札

#### **クリエイティブ要件**

* 画像: 1600x900 JPEG、PNG、GIF（最大容量300Kb）
* 動画: MP4動画（最大容量1.5 Mb）
* iFrame: 1600x900に最適化されたレスポンシブランディングページ

### ダイレクトリンク

![ダイレクトリンク](https://content.gitbook.com/content/FueMjjtWG3dON1cRyiko/blobs/2AoV6TIY6W2Ah8cXmCQE/assets/hires/adformats/direct-link.png)

ダイレクトリンクは、パブリッシャーがユーザーの行動に応じて複数の方法で表示できる柔軟なプレミアムフォーマットです。業種ごとにユーザーをターゲティングするこのCPCベースのフォーマットは、フルページタブ、プッシュ通知、バックボタンオファーの形式で最もよく利用されます。 **申請により、対象のパブリッシャーにのみ利用可能です。**

#### **利用可能な料金モデル**

* CPC
* スマートCPC
* スマート入札

#### **クリエイティブ要件**

* 広告主のランディングページURL

### メールクリック

![メールクリック](https://content.gitbook.com/content/FueMjjtWG3dON1cRyiko/blobs/oUcumu0OoWQMtSwvlrdT/assets/hires/adformats/email-clicks-mobile-right.gif)

CTAを含むメールがエンドユーザーに送信され、クリックするとユーザーは広告主のランディングページまたは登録フォームに移動します。

メールの受信者はパブリッシャーのユーザーベースから選ばれます。各メールはパブリッシャーの設定に基づいて個別化されます。

#### **利用可能な料金モデル**

* CPC
* スマートCPC
* スマート入札

#### **クリエイティブ要件**

* 広告主のランディングページURL

## 動画

### インストリーム動画（VAST）

![インストリーム動画](https://content.gitbook.com/content/FueMjjtWG3dON1cRyiko/blobs/E3lWAnc4ViEzbcX660Qy/assets/hires/adformats/instream-video.gif)

ユーザーがサイトの動画コンテンツをクリックすると自動再生されます。クリック可能なCTAでカスタマイズでき、広告スキップボタンも備えています。HTML5動画プレーヤーは [**VAST対応でなければ**](broken://spaces/aOgTFoXUAl5EUXcOwTMF/pages/6b40633736653a0d68763a344522d356e63c8c4d) インストリーム広告を表示する必要があります。

{% hint style="info" %}
どのHTML5動画プレーヤーを使うべきかわからない場合は、次をおすすめします。 [Fluid Player](https://www.fluidplayer.com/)。これは軽量で統合しやすく、当社のインストリーム広告ゾーンと完全に互換性のある無料のHTML5動画プレーヤーです。
{% endhint %}

#### **インストリーム動画（VAST）の要件**

動画の品質は、サイトのすべての訪問者が容易に視聴できる十分なレベルである必要があります:

* 種類: MPEG-4動画（video/mp4）
* 動画コーデック: H.264
* 音声コーデック: MPEG-4 AAC
* 最大サイズ: 51.2 MB。
* アスペクト比: 一般的な動画プレーヤーは、比率を維持したままプレーヤーのサイズに合わせて動画を自動的にリサイズします。それでも、プレーヤーのアスペクト比に合った比率（分かっている場合）が望ましいです。最も一般的に使用される動画のアスペクト比は **16:9**.
* 解像度: すべてのサイト訪問者が視聴できる解像度である必要があります。
* 再生時間: 最低10秒、最大30秒です。
* 次を使用する場合、 **VASTリンククリエイティブ**、linear要素のskipoffset属性は次のように設定する必要があります。 **00:00:05**。サンプルの [**VASTタグ**](/publishers/ja/vast/vasttagu.md) を参照してください。

#### **利用可能な料金モデル**

* CPM
* スマートCPM
* CPC
* CPV
* スマート入札

### 縦型動画（VAST） <a href="#vertical-video-vast" id="vertical-video-vast"></a>

![縦型動画](https://2557259198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFueMjjtWG3dON1cRyiko%2Fuploads%2FCIqbWujWla8uslrBh80j%2Fvertical-video.gif?alt=media\&token=4624eb93-c5cb-438e-9e34-c58d149c0dcc)

Reels、Shorts、TikTok風フィード内への掲載を想定した短尺の縦型動画フォーマット（9:16）です。このフォーマットは次の形式で配信されます: **VASTタグ**そのため、UI、再生動作、インタラクションロジックはすべてパブリッシャー独自の動画プレーヤー側で管理されます。 **縦型動画の視聴イベントは、動画が3秒再生された時点でカウントされます。**

縦型動画フォーマットは、以下を含む短尺動画フィードに組み込むと最も効果的です: **少なくとも20件のオーガニック動画アイテム** （広告ではなく）、広告を2つのオーガニック動画の間に挿入し、周囲のコンテンツと同じスワイプ/スクロール動作に従わせることです。

このフォーマットは、TikTokやInstagram Reelsのように、1件ずつスクロールまたはスワイプするフルページ動画要素の縦型フィード内で使用することを想定しています。

**推奨ユーザー操作パターン（パブリッシャー管理）**

以下の動作は、縦型動画カルーセルの実装で一般的です。これらは **パブリッシャーのプレーヤーによって実装され** ExoClickによって強制されるものではありません:

* 広告はすぐにスワイプして消せます（0秒から）。
* 動画は通常、表示されるとミュートで自動再生され、画面外に出ると一時停止します。
* 動画は、ユーザーが次の項目にスワイプするまで、表示中にループ再生される場合があります。
* 再生完了後も動画は表示されたままにでき、必要に応じて再生し直しの操作を提供できます。
* インプレッション計測は標準の **VASTインプレッションおよび四分位報告**に従い、他の動画フォーマットと一貫しています。
* 同一セッション内でユーザーが以前配信された広告までスクロールバックした場合、プレーヤーが新しいVAST広告を再リクエストしないことを推奨します。プレーヤーは新しいVAST呼び出しを行う代わりに、キャッシュされたクリエイティブをローカルで再生し直すべきです。

**利用可能な料金モデル**

* CPM
* スマートCPM
* CPC
* CPV

**クリエイティブ要件**

* **種類:** MPEG-4動画（video/mp4）
* **動画コーデック:** H.264
* **音声コーデック:** MPEG-4 AAC
* **最大サイズ:** 51.2 MB.
* **アスペクト比:** 9:16、±10%の許容範囲あり（8.1 – 9.9 : 14.4 – 17.6）。
* **推奨サイズ:** 480×854（最小）。720×1280および1080×1920も使用できます。
* **最小サイズ:** 480 × 854。
* **最大サイズ:** 1080 × 1920。
* **再生時間:** 最低5秒、最大30秒です。
* **必須キャンペーン素材:** 動画ファイル + フレンドリーURL。
* **任意のキャンペーン素材:** CTA（行動喚起）、タイトル、説明、インタラクションボタン。

***

**注:** 9:16のアスペクト比（±10%の許容範囲内）に合わない、または許可された再生時間を外れるクリエイティブは、他の動画アセットと同じ検証エラーによりアップロード時に拒否されます。

***

### ビデオスライダー

![ビデオスライダー](https://content.gitbook.com/content/FueMjjtWG3dON1cRyiko/blobs/ruXGWvWJOObpRjlRcD9b/assets/hires/adformats/video-slider.gif)

サイトの右下からスライドインする動画フォーマットです。広告を閉じるボタンがあります。

#### **利用可能な料金モデル**

* CPM
* スマートCPM
* CPC
* CPV
* スマート入札

#### **クリエイティブ要件**

同じく [**インストリーム**](#requirements-for-in-stream-video-vast).

### アウトストリーム動画

![アウトストリーム動画](https://content.gitbook.com/content/FueMjjtWG3dON1cRyiko/blobs/X4FVNfGnuhRygFEybs7t/assets/hires/outstream-4-editable.gif)

サイト上のどこにでも配置できるレスポンシブな動画フォーマットです。50%以上が表示されると再生されます:

* ミュートで再生され、ユーザーがミュートを解除できます。
* 次の機能があります: **広告を閉じる** 右上のボタン。閉じるとそのまま消えます。
* 1ページで複数のアウトストリーム動画を使用できます。
* 200px未満のコンテナでは表示されません。
* 動画がコンテナサイズに応答するかどうかをパブリッシャーが設定でき、または200〜1080ピクセルのカスタムサイズを指定できます。

#### **利用可能な料金モデル**

* CPM
* スマートCPM
* CPC
* CPV
* スマート入札

#### **クリエイティブ要件**

同じく [**インストリーム**](#requirements-for-in-stream-video-vast).

### 動画内バナー（VAST）

![動画内バナー](https://content.gitbook.com/content/FueMjjtWG3dON1cRyiko/blobs/hhafU5rlJKoNFSuZLlDq/assets/hires/adformats/in-video-banner-1.gif)

動画プレーヤー内に表示されるノンリニアVAST広告です。このフォーマットは静止画像とアニメーション画像のみを指します。

#### **利用可能な料金モデル**

* CPC
* CPM
* スマートCPM
* スマート入札

#### **クリエイティブ要件**

* 画像: 300×250 JPEG、PNG、またはGIF（最大容量: 300 KB）
* 複数の画像を1つに結合したクリエイティブは許可されません。

## ネイティブ

{% hint style="info" %}
次をご確認ください [**ガイドライン**](https://www.exoclick.com/guidelines/advertisers) ネイティブの追加クリエイティブ要件について確認できます。
{% endhint %}

### おすすめウィジェット

![おすすめウィジェット](https://content.gitbook.com/content/FueMjjtWG3dON1cRyiko/blobs/C9x4JLTzoYL0NeJCheer/assets/hires/adformats/native-recommendation-mobile-2.png)

当社のネイティブ広告では、画像と短いテキスト、タイトル、説明を備えた完全カスタマイズ可能なおすすめウィジェットを提供しています。広告ゾーンは、さまざまな画面サイズに応じて完全にレスポンシブになるよう設定できます。

#### **利用可能な料金モデル**

* CPC
* CPM
* スマートCPM
* スマート入札

#### **クリエイティブ要件**

* 画像比率は16:9、4:3、1:1にできます。画像サイズは、前述のアスペクト比内であれば300x300pxから900x900pxまで対応可能です。画像は広告ゾーン設定に合わせて自動的にリサイズされます。画像ファイルはPNGまたはJPEGでなければなりません。
* タイトルテキスト: 最大90文字。
* 説明テキスト: 最大90文字。
* ブランドテキスト: 最大30文字。

#### **任意の動画サムネイル（タッチ/ホバー時のプレビュー）**

以下の要件を満たす動画サムネイルを任意で追加できます:

* **ファイルサイズ**: 1.5 MB未満
* **再生時間**: 10秒未満
* **アスペクト比**: 16:9
* シームレスなホバー効果のため、動画の最初のフレームを画像として使用し、アスペクト比を合わせることを推奨します。

## プッシュ通知

![プッシュ通知](https://content.gitbook.com/content/FueMjjtWG3dON1cRyiko/blobs/SJ8AKP1NaB1RjoWahgUS/assets/hires/adformats/push-notifications.gif)

プッシュ通知は、720x480（アイコン＋画像）または192x192（アイコンのみ）とテキストを、パブリッシャーのサイトでオプトインしたユーザーに送信します。ユーザーは、インターネットを閲覧していないときでも、デスクトップ、タブレット、モバイル端末で受信できます。ユーザーがオプトインしているため、100%高品質なトラフィックと高いCTRを提供します。ユーザーはブラウザ設定からオプトアウトできます。

{% hint style="info" %}
プッシュ通知は次の **ブラウザ/デバイス**:

* デスクトップ: PC / OS X: Chrome、Firefox、Opera
* モバイル端末: Chrome、Firefox、Opera、Edge、Samsung Internet
* Safari（OS X、iOS）ではWebプッシュ通知は利用できません
* プッシュ通知はHTTPサイトでは動作せず、HTTPSサイトでのみ利用できます。
  {% endhint %}

{% tabs %}
{% tab title="720x480（アイコン＋画像）" %}
このフォーマットでは、1枚の720x480画像をアップロードして、プッシュ通知広告のアイコンとメイン画像の両方に使用できます。

**利用可能な料金モデル**

* CPC
* CPM
* スマートCPM
* スマート入札

**クリエイティブ要件**

* 720×480 JPEG、PNG、またはGIF（最大サイズ300 KB）。
* タイトルテキスト: 最大50文字。
* 説明テキスト: 最大90文字（ブラウザによっては文字数制限がある点にご注意ください）。
  {% endtab %}

{% tab title="192x192（アイコン）" %}
このフォーマットでは、192 x 192形式の画像を1枚アップロードでき、端末が対応している場合はアイコンのみに使用されます。

**利用可能な料金モデル**

* CPC
* CPM
* スマートCPM
* スマート入札

**クリエイティブ要件**

* 192×192 JPEG、PNG、またはGIF（最大サイズ300 KB）。
* タイトルテキスト: 最大50文字。
* 説明テキスト: 最大90文字（ブラウザによっては文字数制限がある点にご注意ください）。
  {% endtab %}
  {% endtabs %}

### インページプッシュ通知

![インページプッシュ通知](https://content.gitbook.com/content/FueMjjtWG3dON1cRyiko/blobs/jiuiFZMmpX6psOxVSIRQ/assets/hires/adformats/In-Pagepushdisplay.png)

他のプッシュ通知フォーマットとは異なり、インページプッシュ広告はパブリッシャーのサイト内に表示され、表示にユーザーのオプトインは必要ありません。パブリッシャーは、同じページ内に最大2件の通知を表示するよう広告ゾーンを設定できます。通知は広告内に表示される閉じるボタンで簡単に閉じられます。

{% hint style="info" %}
インページプッシュと [デスクトップインタースティシャル](#desktop-fullpage-interstitial) または [モバイルインタースティシャル](#mobile-fullpage-interstitial) が同時にページ上で表示されている場合、デスクトップまたはモバイルのインタースティシャル広告がインページプッシュの上に表示されます。
{% endhint %}

#### **利用可能な料金モデル**

* CPC
* CPM
* スマートCPM
* スマート入札

#### **クリエイティブ要件**

* 192×192または720x480 JPEG、PNG、またはGIF（最大サイズ300 KB）。
* タイトルテキスト: 最大50文字。
* 説明テキスト: 最大90文字（ブラウザによっては文字数制限がある点にご注意ください）。

## モバイル

### モバイルバナー

![モバイルバナー](https://content.gitbook.com/content/FueMjjtWG3dON1cRyiko/blobs/0eQ22SMFUAT6WDrmg9lj/assets/hires/adformats/display-banner.png)

モバイルバナーフォーマットは、モバイル向けに最適化されたサイズのクラシックバナーを表示します: 300x250と300x100

#### **利用可能な料金モデル**

* CPC
* CPM
* スマートCPM
* スマート入札

#### **クリエイティブ要件**

* 画像: 300×250、300x100、300x50のJPEG、PNG、またはGIF（最大容量300 KB）
* 動画: 300×250、300x100、300x50のMP4動画（最大容量1500 KB）
* Iframe: 幅と高さ属性が選択したサイズに対応するiframeコード: 300×250、300x100、または300x50。
* 複数の画像を1つに結合したクリエイティブは許可されません。

### モバイルポップアンダー

![モバイルポップアンダー](https://content.gitbook.com/content/FueMjjtWG3dON1cRyiko/blobs/udV9JtSlIbHmTl1jNruK/assets/hires/adformats/popunders-1.gif)

ユーザーがパブリッシャーのサイトからリンクをクリックすると、広告主のURLが新しいブラウザタブに表示されます。フォーカスはパブリッシャーのサイトに残り、ユーザーが現在のブラウザタブを閉じると広告が表示されます。

パブリッシャーは、サイト内の任意のリンクをクリックしたとき、または特定のクラスを持つリンクをクリックしたときに表示される広告ゾーンをカスタマイズできます。

#### **利用可能な料金モデル**

* CPM
* スマートCPM
* スマート入札

### モバイルインスタントメッセージ

![モバイルインスタントメッセージ](https://content.gitbook.com/content/FueMjjtWG3dON1cRyiko/blobs/ryny6sd8zr94hk5MkQ9J/assets/hires/adformats/instant-message-1.gif)

モバイルインスタントメッセージフォーマットは、インスタントメッセンジャーのチャットボックスに似ています。この広告フォーマットは、モバイルページの右下に広告を表示してユーザーに見せます。出会い系やライブカム製品に非常に効果的です。

#### **利用可能な料金モデル**

* CPC
* CPM
* スマートCPM
* スマート入札

#### **クリエイティブ要件**

* 画像: 300×100 JPEG、PNG、またはGIF（最大容量: 300 KB）
* 動画: 300×100 MP4動画（最大容量: 1500 KB）
* Iframe: 300×100のiframeコード
* 複数の画像を1つに結合したクリエイティブは許可されません。

### モバイルフルページインタースティシャル

![モバイルフルページインタースティシャル](https://content.gitbook.com/content/FueMjjtWG3dON1cRyiko/blobs/SpnsCKNK6VFLDOVskgwb/assets/hires/adformats/mobile-fullpage-interstitial.gif)

サイトからリンクをクリックした後、画面全体を埋める900x1600の大きな縦長バナーです。下にあるパブリッシャーのサイトが見えるように少し余白があります。訪問者が別のタブに移動したとき、または **広告を閉じる** ボタンがクリックされたときに通常の閲覧に戻ります。

この広告フォーマットは、モバイル端末およびタブレット端末の画面でのみ機能します。

{% hint style="info" %}
この広告フォーマットは、モバイル端末が横向きの場合は表示されません。この広告フォーマットが表示中に端末が横向きに変更されると、自動的に閉じます。
{% endhint %}

**利用可能な料金モデル**

* CPC
* CPM
* スマートCPM
* スマート入札

**クリエイティブ要件**

* 画像: 900x1600 JPEG、PNG、GIF（最大容量300Kb）
* 動画: MP4動画（最大容量1.5 Mb）
* iFrame: 900x1600に最適化されたレスポンシブランディングページ

{% hint style="info" %}
iFrameを使用する場合、この広告は横向きでも表示できます。
{% endhint %}

## マルチフォーマット

![複数広告フォーマット](https://content.gitbook.com/content/FueMjjtWG3dON1cRyiko/blobs/NGmLi0L28F1oMQ33RhBt/assets/hires/adformats/multi-format-example.gif)

**マルチフォーマット** 広告ゾーンを使用すると、パブリッシャーは既存の最大10件の **バナー** と **ネイティブ** 広告ゾーンを1つのゾーンに統合できます。これにより、次のことが可能になります:

* 複数の既存広告ゾーンを選び、互いに競合させることで、eCPMが最も高いものを横方向または縦方向に複数回表示できます。
* 複数の既存広告ゾーンを選び、互いに競合させることで、eCPMが最も高いものを1回だけ表示できます。

### メリット

* パブリッシャーとして、 **マルチフォーマット** 広告ゾーンを使用すると、1つのゾーンで複数の広告フォーマットを表示できるため、広告ゾーンのパフォーマンスを向上できます。
* 広告主として、 **マルチフォーマット** 広告ゾーンを使用すると、1つのゾーンで複数の広告フォーマットを配信できます。これにより、各掲載枠ごとに専用のクリエイティブを作成しなくても、より多くのユーザーにリーチできます。

### 要件

* マルチフォーマット広告ゾーンには、最大10件のバナー広告またはネイティブ広告（おすすめウィジェット）を追加できます。
* バナーを使用するマルチフォーマット広告ゾーンの最大サイズは、縦または横で1200 pxです。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.exoclick.com/exoclick-docs/ja/fmatto.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
