キャンペーン作成に関する補足
自動ソースクレーム機能の利用を承認されたパートナー向けのキャンペーン作成方法。
Indeed の API の使用について Indeed と書面による契約を締結していない場合、この API またはそのドキュメントを使用することにより、Indeed の API の使用には Indeed API Terms および Additional API Terms and Guidelines が適用されることに同意したものとみなされます。
ドキュメントの目的
このドキュメントは、Sponsored Jobs APIリファレンスを補足するものです。Sponsored Jobs APIと連携し、自動ソースクレームを利用できるパートナーを対象としています。自動ソースクレームとは、Indeedが広告主にソースをクレームして割り当てる処理を行わずに、広告主自身がIndeed上でキャンペーンを作成できるようにするしくみです。
このドキュメントは、APIドキュメント全体を網羅するものではなく、キャンペーン作成に関する補足のみを扱います。本ドキュメントおよびSponsored Jobs APIリファレンスでは、employer（雇用主）とadvertiser（広告主）は同義であり、いずれもIndeedで求人をスポンサーするユーザーを指します。
本機能に関する技術的な質問は、marketplacesupport@indeed.com までお送りください。
キャンペーンを作成する
キャンペーンを作成するには、次のエンドポイントを使用します。
| 動詞 | エンドポイント | 参照先 |
|---|---|---|
POST | /v1/campaigns | Sponsored Jobs APIリファレンス |
このエンドポイントは、作成されたキャンペーンのIDを返します。キャンペーンの変更やレポートの取得に使用するため、このキャンペーンIDを保管しておいてください。
- キャンペーンの作成時は、雇用主が選択した予算と期間を設定します。予算は、雇用主のデフォルト通貨と同じ通貨で指定する必要があります。
- 各求人については、XML求人フィード形式で設定された一意の参照番号を使用します。
- すべての日付は
YYYY-MM-DD形式で、米国中部時間で指定します。
キャンペーン作成のパラメーター
| パラメーター | 説明 |
|---|---|
jobsToInclude |
|
jobsQuery | XML求人フィードから特定の求人を含めるには、 |
jobsSourceName | ATS以外のパートナー向けのSponsored Jobs APIリファレンスには、このフィールドの記載はありません。このフィールドは、自動ソースクレームの利用を承認されたパートナーのみが使用できます。XML求人フィード内の求人の |
雇用主が月次の定期キャンペーンを選択した場合
月次の定期キャンペーンは、暦月に従います。
| フィールド | 説明 |
|---|---|
budgetMonthlyLimit | 予算額。 |
budgetFirstMonthBehavior |
|
雇用主が固定期間のキャンペーンを選択した場合
| フィールド | 説明 |
|---|---|
budgetOnetimeLimit | 予算額。 |
startDate | キャンペーンの開始日。デフォルトは当日（本日）。YYYY-MM-DD形式、米国中部時間で指定します。 |
| キャンペーンに、
|
アクセスの委譲と自動ソースクレーム
Sponsored Jobs APIで導入されたOAuthスコープでは、権限はIndeedに登録されたOAuthアプリに紐づきます。自動ソー スクレームの要件は、Sponsored Jobs APIへのアクセス方法によって異なります。
| Sponsored Jobs APIへのアクセス方法 | 必要な対応 |
|---|---|
| 広告代理店であり、自社のクレデンシャルでOAuthアプリを登録している。 | なし。追加の対応は不要です。 |
| 広告代理店であり、Sponsored Jobs API連携の管理にプログラマティックパートナーを利用している。プログラマティックパートナーが自社のクレデンシャルでOAuthアプリを登録している。 | 認可コードグラントタイプ（3-legged OAuth）を使用して、プログラマティックパートナーにアクセスを委譲します。 |
| 広告代理店であり、Sponsored Jobs API連携の管理に複数のプログラマティックパートナーを利用している。プログラマティックパートナーは、自社のクレデンシャルでOAuthアプリを登録している。 | 各サブアカウントについて、そのサブアカウントを管理するプログラマティックパートナーをアカウントの副ユーザーとして追加します。 |