- 対応機能
- ブラウザサポート
- 開始前の準備
- Indeed アカウントを設定する
- OAuth アプリケーションを設定する
- プラグインスクリプトを読み込む
- data-indeed-allow-employer-creation パラメータを設定する
- 表示を切り替える
- 求人可視性ステータスを表示する
- プラグインで求人可視性を有効にする
- 求人可視性ボタンを表示する
- 求人可視性ボタンのバリエーション
- 求 人可視性ボタンを表示する場所
- 求人可視性のベストプラクティス
- 求人可視性のトラブルシューティング
- スポンサー求人を有効にする
- プラグインでスポンサー求人を有効にする
- スポンサー求人ボタンを表示する
- スポンサー求人ボタンのバリエーション
- スポンサー求人ボタンを表示する場所
- スポンサー求人のベストプラクティス
- トラブルシューティング
- プラグインに「Unable to connect to the server」と表示される
- プラグインボタンに正しいステータスが表示されない
ATS JavaScript Plugin
フロントエンドの変更だけで、ATS サイトに Indeed の機能を連携します。
Indeedプラグイン利用規約をご覧ください。
ATS JavaScript Plugin は、フロントエンドの変更だけで ATS サイトに Indeed の機能を追加します。
対応機能
このプラグインは、次の機能をサポートします。
- 求人可視性: Indeed と Indeed PLUS job boards 全体での可視性ステータス、モデレーション理由、および修正方法を表示します。
- スポンサー求人: ATS から求人をスポンサーできます。
ブラウザサポート
このプラグインを使用するには HTTPS が必要です。すべてのプラグインボタンを HTTPS ページでレンダリングしてください。サポート対象のブラウザは次のとおりです。
| Chrome | Firefox | Safari | Edge (Chromium) | |
|---|---|---|---|---|
| Linux | ✅ | ✅ | N/A | ❌ |
| macOS | ✅ | ✅ | ✅ | ✅ |
| Windows | ✅ | ✅ | N/A | ✅ |
| Android | ❌ | ❌ | ❌ | ❌ |
| iOS | ❌ | ❌ | ❌ | ❌ |
開始 前の準備
プラグイン機能を連携する前に、次の手順を完了してください。
Indeed アカウントを設定する
ATS にリンクされた Indeed アカウントと、Indeed の担当者から提供される次の ATS キーが必要です。
- Sponsor ATS key
- Aggregation ATS key（web interviews のみ）
Indeed パートナーになるをご覧ください。
OAuth アプリケーションを設定する
このプラグインは、クライアントの認証と認可に 3-legged OAuth 2.0 を使用します。
- 3-legged OAuth アプリを作成します。
- そのアプリを public client として登録します。Authorization code grant type (3-legged OAuth)をご覧ください。
プラグインスクリプトを読み込む
ATS サイトに ATS JavaScript Plugin を連携するには、次の <script> タグを追加します。
<script src="https://plugins.indeed.com/ats-plugin/main.js" data-indeed-locale="<LOCALE>" data-indeed-enabled-plugins="<ENABLED-PLUGINS>" data-indeed-oauth-client-id="<CLIENT-ID>" data-indeed-redirect-url="<REDIRECT-URL>" data-indeed-ats-key="<ATS-KEY>" data-indeed-ats-user-id="<ATS-USER-ID>" data-indeed-ats-company-id="<ATS-COMPANY-ID>" data-indeed-plugin-z-index="<Z-INDEX>" data-indeed-allow-employer-creation="<true|false>" crossorigin defer></script>山かっこ（<>）内のパラメータを自社の値に置き換えます。
| 属性 | 説明 |
|---|---|
| 必須。プラグイン UI テキストのロケールです。サポートされる値は次のとおりです。
|
| 必須。有効化する機能 ID のカンマ区切りリストです。 サポートされる値:
例:
|
| 必須。アプリの client ID です。Get your OAuth credentialsをご覧ください。 |
| 必須。プラグインを実行するアプリの redirect URL の 1 つです。これは、プラグインを実行するすべてのページと同じoriginである必要があります。
この例では、 redirect ページ（ 3-legged OAuth アプリでは、Partner Console で最大 5 つの redirect URL を定義できます。 |
| 必須。Indeed アカウントの ATS key です。Indeed アカウントを設定するをご覧ください。 |
| 必須。ATS サイト上の現在のユーザーを識別する一意の文字列です。 ATS がこの文字列を生成します。UTF-8 を使用し、英数字、ハイフン（ |
| 必須。現在のユーザーの企業を識別する一意の文字列です。 ATS がこの文字列を生成します。UTF-8 を使用し、英数字、ハイフン（ |
| 任意。プラグインのサイドパネルの z-index です。デフォルトは 999 です。 例: |
| 任意。初回のユーザー設定時に雇用主アカウントの作成を有効または無効にします。 例: |
data-indeed-allow-employer-creation パラメータを設定する
任意の data-indeed-allow-employer-creation 属性は、セットアップ時にユーザーが Indeed の雇用主アカウントを作成できるかどうかを制御します。
| オプション | 説明 | 使用する場合 |
|---|---|---|
| 未設定のままにする | セットアップ中に追加の画面が表示され、ユーザーは自分のユーザータイプとアカウントステータスを識別できます。 | ユーザータイプが direct employer か agency かを事前に把握していない場合。 |
true に設定する | ユーザーがプラグインを通じて Indeed 上で雇用主アカウントを作成 できるようにします。 | ユーザーがアカウントを作成する必要がある direct employer であることがわかっている場合。 |
false に設定する | プラグインを通じた雇用主アカウントの作成を無効にします。プラグインは、ATS、Indeed、またはその agency に連絡するようユーザーに案内します。 | ユーザーが複数の広告主を管理する agency、または agency を利用する雇用主であり、アカウント作成を制限したい場合。 |
雇用主タイプに応じて data-indeed-allow-employer-creation を設定します。
- Agency employers と employers using an agency: 重複した雇用主アカウントを防ぐため、
falseに設定します。 - Direct employers: 自己識別画面を省略してセットアップを速くするため、
trueに設定します。
ビジュアルガイド
この画像はユーザー設定フローを示しています。data-indeed-allow-employer-creation を設定しない 場合、自己識別画面（How do you manage jobs?）が表示されます。
表示を切り替える
スクリプトの読み込み時に、Indeed ATS JavaScript Plugin は次の関数を持つグローバル変数 IndeedAtsPlugin を公開します。
| 関数 | 説明 |
|---|---|
renderPlugins(): void | ページ上のすべてのプラグイン UI（ボタンとサイドパネル）をレンダリングします。既存の UI がある場合は先にアンマウントします。プラグインはこの関数をスクリプト読み込み時に自動で呼び出します。 |
unmountPlugins(): void | ページ上のすべてのプラグイン UI（ボタンとサイドパネル）をアンマウントします。何も存在しない場合は処理を行いません。 |
renderButton(root: HTMLElement): void | ルート HTML 要素にプラグインボタンをレンダリングします。要素に必要な |
unmountButton(root: HTMLElement): void | ルート HTML 要素からプラグインボタンをアンマウントします。ボタンが存在しない場合は処理を行いません。 |
これらの API を使用して、プラグイン UI の表示を制御します。シングルページアプリケーションでは、スクリプト読み込み時点でマウントポイントが存在しないことがあります。その場合は、表示された時点で renderButton を呼び出します。
求人可視性ステータスを表示する
ATS JavaScript Plugin の求人可視性機能を使用すると、雇用主は ATS サイトから投稿済み求人のステータスを確認できます。
求人可視性ボタンを表示してください。dynamic に設定すると、ボタンに求人の可視性ステータスが表示されます。
雇用主はボタンを選択して詳細を確認します。
プラグインで求人可視性を有効にする
プラグインの <script> タグの data-indeed-enabled-plugins 属性に job-visibility を追加します。プラグインスクリプトを読み込むをご覧ください。
求人可視性ボタンを表示する
求人可視性ボタンは、求人ごとに 1 つ表示します。複数の求人や求人グループのステータスを 1 つのボタンで表示することはできません。
求人可視性ボタンを表示するには、次の <div> 要素を追加します。
<div data-indeed-plugin="job-visibility" data-indeed-employer-job-id="<INDEED-EMPLOYER-JOB-ID>" data-indeed-is-dynamic="false" data-indeed-job-title="<JOB-TITLE>" data-indeed-button-size="<sm|md>"></div>山かっこ（<>）内の値を自社の値に置き換えます。
| 属性 | 説明 |
|---|---|
data-indeed-plugin | 必須。求人可視性ボタンをレンダリングするには |
data-indeed-employer-job-id | 必須。ATS が求人を投稿した際に Job Sync API から返される employer job ID です。この値をデータベースに保存し、自社システムの求人識別子に関連付けてください。 |
data-indeed-is-dynamic | 任意。
|
data-indeed-job-title | 任意。投稿済み求人のタイトルです。プラグイン UI のタイトルとして表示されます。 |
data-indeed-button-size | 任意。求人可視性ボタンのサイズです。 サポ ートされる値:
例: |
求人可視性ボタンのバリエーション
求人可視性ボタンの動作は、data-indeed-is-dynamic が true の場合は dynamic、false の場合は static となり、それによって変わります。
Dynamic ボタンは beta 版です。パフォーマンスが安定しないことがあり、ページの表示が遅くなる可能性があります。
求人可視性ボタンを表示する の HTML を埋め込むと、プラグインは定義済みのスタイルでボタンを生成し、状態を自動でレンダリングします。ボタンは次の状態をサポートします。
| 状態 | 画像 | 説明 |
|---|---|---|
Loading |  | プラグインがボタンの状態を読み込んでいます。 |
| Awaiting |  | プラグインがキュー内の求人を処理しています。 |
| Ineligible |  | 求人に未解決の問題があり、Indeed または Indeed PLUS job boards に表示されません。 |
| Eligible* |  | 求人は Indeed には表示されますが、Indeed PLUS job boards には表示されません。 |
| Eligible |  | 求人は Indeed と Indeed PLUS job boards に表示されます。 |
| Expired |  | 求人の有効期限が切れています。 |
| Fallback |  | ボタンが static であるか、プラグインが状態を読み込めません。 |
求人可視性ボタンを表示する場所
雇用主がステータスを確認したい可能性が高い場所に求人可視性ボタンを配置してください。ページが雑然と見えないよう、他の UI 要素とのバランスも取ってください。
推奨される配置場所は次のとおりです。
求人一覧ページ
求人一覧ページに求人可視性ボタンを表示すると、雇用主はすべての求人のステータスをすばやく確認できます。
求人が多いページでは、より速くレンダリングするため、static ボタン（data-indeed-is-dynamic="false"）を使用してください。
求人詳細ページ
求人詳細ページの関連情報の近くに求人可視性ボタンを表示すると、雇用主は文脈の中で可 視性ステータスをすばやく確認できます。
求人可視性のベストプラクティス
求人可視性ボタンを表示する場合は、次のガイドラインに従ってください。
- ボタンはそのまま使用してください。Indeed のブランドスタイルでレンダリングされるため、変更しないでください。
- 幅が可変であることを考慮してください。ボタンの幅は 164px ですが、表示幅は状態によって変わります。
data-indeed-button-sizeを使用して高さを設定してください。mdは 40px、smは 32px です。- 明るい背景の上に配置してください。
- ボタンの四辺すべてに 8px の余白を確保してください。
求人可視性のトラブルシューティング
求人可視性ボタンにステータスが表示されない
dynamic ボタンを有効にするには、data-indeed-is-dynamic="true" になっていることを確認してください。
スポンサー求人を有効にする
Indeed Plugin Termsをご覧ください。
スポンサー求人機能を使用すると、雇用主は ATS サイトから Indeed の求人をスポンサーできます。Sponsored Jobs APIをご覧ください。
プラグインでスポンサー求人を有効にする
プラグインの <script> タグの data-indeed-enabled-plugins 属性に sponsored-jobs を追加します。プラグインスクリプトを読み込むをご覧ください。
スポンサー求人ボタンを表示する
スポンサー求人を有効にすると、ATS サイトに Sponsor ボタンが表示されます。雇用主はそのボタンを選択 して、求人をスポンサーするか、スポンサーの詳細を確認します。
Sponsor ボタンを表示するには、次の <div> 要素を追加します。
<div data-indeed-plugin="sponsored-jobs" data-indeed-ref-num="<REF-NUM>" data-indeed-source-name="<SOURCE-NAME>" data-indeed-job-title="<JOB-TITLE>"></div>山かっこ（<>）内のパラメータを自社の値に置き換えます。この表は data-indeed-* 属性を説明しています。
| 属性 | 説明 |
|---|---|
data-indeed-plugin | 必須。 |
data-indeed-ref-num | 必須。雇用主が指定する求人の一意識別子です。求人は Indeed で利用可能である必要があります。 求人が Job Sync API を使用して作成された場合は、SourcedJobPostingMetadataInput.jobPostingId を使用します。 求人が XML job feed を使用して作成された場合は、<referencenumber> を使用します。 |
data-indeed-source-name | 必須。この求人を募集している親組織です。 求人が Job Sync API を使用して作成された場合は、SourcedJobPostingJobSourceInput.sourceName を使用します。 求人が XML job feed を使用して作成された場合は、<sourcename> を使用します。 |
data-indeed-job-title | 任意。キャンペーン名の自動入力に使用する求人タイトルです。デフォルトは New Campaign です。 |
スポンサー求人ボタンのバリエーション
Sponsor ボタンの見た目は、スポンサーのステータスに応じて変わります。
| ステータス | 説明 | 画像 |
|---|---|---|
| None | 求人はスポンサーされていないか、雇用主がスポンサーを削除しました。 | |
| Scheduled | スポンサーは開始待ちです。 |  |
| Spending | スポンサーが有効で、雇用主は予算を使用しています。 |  |
| Not spending | キャンペーンは有効ですが、雇用主は予算を使用していません。 この状態では Indeed は求人の可視性を高めないため、結果はスポンサーしていない求人と同じです。 雇用主が予算を使用していない理由については、List employer campaigns and statusesをご覧ください。 |  |
| Paused | 雇用主がスポンサーを一時停止しています。 |  |
| Unavailable | 求人が Indeed で利用できないため、スポンサーできません。 |  |
スポンサー求人ボタンを表示する場所
雇用主が求人をスポンサーしたい可能性が高い場所にスポンサー求人ボタンを配置してください。ページが雑然と見えないよう、他の UI 要素とのバランスも取ってください。
推奨される配置場所は次のとおりです。
求人一覧ページ
求人一覧ページのスポンサー求人ボタンによって、雇用主はステータスを確認し、スポンサーをひと目で管理できます。
求人を投稿した後
雇用主が求人を投稿した直後にスポンサー求人ボタンを表示すると、スポンサーを開始するきっかけになります。
スポンサー求人のベストプラクティス
スポンサー求人ボタンを表示する場合は、次のガイドラインに従ってください。
| ベストプラクティス | 例 |
|---|---|
ボタンの四辺すべてに 8px の余白を確保します。 | ✅ Correct example:  ❌ Incorrect example:  |
幅が可変であることを考慮してください。ボタンの高さは 40px ですが、幅は状態によって変わります。周囲のレイアウトがそれに対応できるようにしてください。 | ✅ Correct example:  ❌ Incorrect example:  |
明るい背景の上にボタンを配置します。 | ✅ Correct example:  ❌ Incorrect example:  |
ボタンはそのまま使用してください。Indeed のブランドスタイルで提供されるため、変更しないでください。 | ✅ Correct example:  ❌ Incorrect example:  |
トラブルシューティング
プラグインに「Unable to connect to the server」と表示される
次の点を確認してください。
data-indeed-oauth-client-idに正しい client ID を設定している。data-indeed-redirect-urlに、Partner Console に登録済みで、プラグインを実行するページと同じ origin の redirect URL を設定している。
問題が解決しない場合は、Indeed にお問い合わせください。
プラグインボタンに正しいステータスが表示されない
求人投稿の変更がプラグインボタンに反映されるまで、数時間かかります。