キャンペーン作成に関する補足

自動ソースクレーム機能の利用を承認されたパートナー向けのキャンペーン作成方法。

 

法的注意

Indeed の API の使用について Indeed と書面による契約を締結していない場合、この API またはそのドキュメントを使用することにより、Indeed の API の使用には Indeed API Terms および Additional API Terms and Guidelines が適用されることに同意したものとみなされます。

ドキュメントの目的

このドキュメントは、Sponsored Jobs API reference を補足するものです。対象は、Sponsored Jobs API と連携し、auto-source claiming を利用できるパートナーです。auto-source claiming は、Indeed が広告主へソースをクレームして割り当てることなく、広告主が Indeed 上でキャンペーンを作成できるようにするプロセスです。

このドキュメントは包括的な API ドキュメントではありません。キャンペーン作成に関する補足のみを扱います。本ドキュメントおよび Sponsored Jobs API reference では、employer と advertiser は同義で、どちらも Indeed で求人をスポンサーするユーザーを指します。

この機能に関する技術的な質問は、marketplacesupport@indeed.com に送信してください。

キャンペーンを作成する

キャンペーン作成には次のエンドポイントを使用します。

Create a campaign

Verb	Endpoint	See
POST	/v1/campaigns	Sponsored Jobs API reference

このエンドポイントは新しいキャンペーンの ID を返します。キャンペーン変更やレポート取得に使用するため、キャンペーン ID を保存してください。

• キャンペーン作成時は、雇用主が選択した予算と期間を設定します。予算は雇用主のデフォルト通貨と同じ通貨で指定してください。
• 各求人には、XML job feed format で設定した一意の参照番号を使用します。
• すべての日付は YYYY-MM-DD 形式で、US Central time zone で指定します。

キャンペーン作成のパラメーター

Parameters for campaign creation

Parameter	Description
jobsToInclude	query に設定します。
jobsQuery	XML job feed から特定の求人を含めるには、refnum:xxxxx を使用します。refnum は XML job feed の referencenumber ノード値と一致させます。 クエリに一致する求人を含めるには、汎用的な query を使用します。
jobsSourceName	ATS 以外のパートナー向け Sponsored Jobs API reference には、このフィールドは記載されていません。このフィールドは auto-source claiming の利用が承認されたパートナーのみ使用できます。XML job feed 内の求人で、sourcename ノードの値をこのフィールドに渡してください。

雇用主が月次の定期キャンペーンを選択した場合

月次の定期キャンペーンは、暦月に従います。

Monthly recurring campaigns

Field	Description
budgetMonthlyLimit	予算額。
budgetFirstMonthBehavior	startNowProratedAmount に設定します。

雇用主が固定期間のキャンペーンを選択した場合

Fixed duration campaigns

Field	Description
budgetOnetimeLimit	予算額。
startDate	キャンペーン開始日。デフォルトは当日です。US Central time zone の YYYY-MM-DD 形式で指定します。
targetEndDateまたはfixedEndDate	キャンペーンには targetEndDate または fixedEndDate のいずれかを設定します。US Central time zone の YYYY-MM-DD 形式で指定します。 targetEndDate – Indeed はこの日までに予算消化を最適化します。キャンペーンに予算が残っている場合は、この日を過ぎても消化を続けます。 fixedEndDate – 完全停止日です。Indeed はこの日までに予算消化を最適化し、指定日を過ぎてキャンペーンが消化しないようにします。

アクセスの委譲と自動ソースクレーム

Sponsored Jobs API で導入された OAuth scopes では、権限は Indeed に登録した OAuth アプリに紐づきます。auto-source claiming の要件は、Sponsored Jobs API へのアクセス方法によって異なります。

Access delegation and auto-source claiming

How you access the Sponsored Jobs API	What to do
代理店であり、自社の認証情報で OAuth アプリを登録している。	対応不要です。
代理店であり、Sponsored Jobs API 連携管理に programmatic パートナーを使用している。programmatic パートナーが自社認証情報で OAuth アプリを登録している。	Authorization code grant type (3-legged OAuth) を使用して、programmatic パートナーへアクセスを委譲します。
代理店であり、Sponsored Jobs API 連携管理に複数の programmatic パートナーを使用している。programmatic パートナーは自社認証情報で OAuth アプリを登録している。	各サブアカウントについて、そのサブアカウントを管理する programmatic パートナーをアカウントのセカンダリユーザーとして追加します。

 

このページは役に立ちましたか？