メインコンテンツまでスキップ

キャンペーンを作成

POST 
/v1/campaigns

スポンサー求人キャンペーンを作成します。

前提条件

OAuthスコープアクセストークンタイプ
employer.advertising.campaign

採用企業を表すアクセストークン。採用企業を表すアクセストークンを取得するを参照してください。

Request​

Body

required

リクエスト本文は、作成するキャンペーンを記述するJSONオブジェクトである必要があります。

HTTPリクエストヘッダー

次のHTTPリクエストヘッダーを含めてください。

  • Content-Type: application/json
  • Accept: application/json
  • "idempotency-key": "<key>"：平均日次予算（ADB）キャンペーンの作成に必要です。e8908cde-8ccc-4500-8762-588ced4b4a88のような一意のIDを指定して、キャンペーン作成リクエストをべき等にします。

目標

平均日次予算（ADB）キャンペーン（STANDARDおよびPREMIUM）では、目標を設定または変更できません。目標が設定されていないキャンペーンにはobjectiveを追加し、そのtargetを更新できますが、目標を削除したりobjectiveTypeを変更したりすることはできません。

必ず name、jobsSourceName、およびjobsToIncludeを指定する必要があります。

有料掲載する求人の選択

  • 求人ソースの求人をすべて有料掲載する： jobsToIncludeをALLに設定します。jobsQuery、jobsTitle、jobsCompany、jobsLocation、およびjobsLocationRadiusは指定しないでください。 指定しても無視されます。
  • 求人の一部を有料掲載する： jobsToIncludeをQUERYに設定します。少なくともjobsQuery、jobsTitle、jobsCompany、jobsLocationの1つを設定してください。

キャンペーンの予算と期間の設定

  • 特定の日付に停止するキャンペーンを作成する： budgetOnetimeLimitを指定します。予算が残っていても、終了日を過ぎたらキャンペーンのスポンサー求人を停止する場合は、fixedEndDateを指定します。すべての予算を使い切るまでキャンペーンの有料掲載を継続する場合は、targetEndDateを指定します（月額予算を設定し、各月の予算が均等になるようにする場合は、代わりにbudgetMonthlyLimitを指定できます。ただし、この場合はfixedEndDateのみを使用できます） 。
  • 手動で停止するまで有料掲載が継続されるキャンペーンを作成する： budgetMonthlyLimitを指定します。終了日は指定しないでください。

キャンペーンの開始時期の選択

  • すぐに有料掲載を開始するキャンペーンを作成する： startDateまたは statusを指定しない場合は、これがデフォルトです。
  • 未来の特定の日付に開始するキャンペーンを作成する： startDateを指定します。
  • 手動で有効にしたときに開始するキャンペーンを作成する： statusをPAUSEDに設定します。

オプションの機能

  • このキャンペーンのスポンサークリックを特定する： trackingTokenを指定します。
  • 特定の採用目標を達成できるようにキャンペーンを最適化する： objectiveを指定します。Sponsored Jobs APIは目標設定型キャンペーンをサポートしています。詳しくは、「Creating an Effective Recruitment Funnel With Indeed Ads （新しいウィンドウで開きます）」（Indeed広告で効果的な採用ファネルを作成する）をご覧ください。平均日次予算（ADB）キャンペーンでは、目標を設定または変更できません。それ以外のSponsored Jobs APIキャンペーンには、すべて目標を設定する必要があります。キャンペーン作成時に採用企業が目標を指定しない場合は、Sponsored Jobs APIが適切な目標を自動的に選択します。
  • Trusted Media Network（TMN）のスポンサー求人： channelsを指定します。詳しくは、「What is the Trusted Media Network (TMN)? （新しいウィンドウで開きます）」（Trusted Media Network（TMN）とは）をご覧ください。有効化または無効化するチャネルを設定してキャンペーンを作成した後は、各チャネルのステータスを変更することはできません。

各フィールドの詳細と値の例については、定義モデルをご覧ください。リクエストの例については、「Getting Started Guide」（スタートガイド）をご覧ください。

    name string

    Possible values: non-empty and <= 250 characters

    キャンペーン名。キャンペーンを識別できます。名前は採用企業アカウント内で一意である必要があります。

    status string

    Possible values: [ACTIVE, DELETED, PAUSED]

    Default value: ACTIVE

    キャンペーンのステータス。

    • ACTIVE：キャンペーンを開始します。
    • PAUSED：手動で有効にするまでキャンペーンを非アクティブのままにします。または、有料掲載を一時的に停止します。
    • DELETED：有料掲載を停止し、キャンペーン管理ポータルのデフォルト表示からキャンペーンを非表示にします。
    trackingToken string

    Possible values: <= 255 characters

    スポンサークリック時に求人URLに追加されるクリックトラッキングトークン。クリックがIndeedからのものであることを特定し、クリックをスポンサーしたキャンペーンを識別できます。

    jobsSourceId string

    jobsSourceを上書きする求人ソースID。このキャンペーンが求人をスポンサーする求人ソースを指定します。GET /v1/accountのjobSourceListフィールドで返された求人ソースのidを指定します。採用企業アカウントがまだ求人ソースに関連付けられていない場合は、Indeedカスタマーサポートに連絡してください。

    各キャンペーンは1つのjobsSourceIdのみをサポートします。複数の求人ソースがある場合は、各ソースに対して個別のキャンペーンを作成します。

    jobsToInclude string

    Possible values: [ALL, QUERY]

    • ALL - キャンペーンは求人ソース内のすべての求人をスポンサーします。jobsQuery、jobsTitle、jobsCompany、jobsLocation、jobsLocationRadiusフィールドの値は無視され、既存の値はクリアされます。
    • QUERY - キャンペーンはjobsQuery、jobsTitle、jobsCompany、jobsLocation、jobsLocationRadiusフィールドで定義された条件に一致する求人のサブセットをスポンサーします。複数のフィールドが指定された場合、すべての条件に一致する求人のみがスポンサーされます。

    注意: jobsToIncludeがQUERYでもすべての条件を省略した場合、キャンペーンは求人ソース内のすべての求人をスポンサーします。将来のAPIバージョンでは、この動作はエラーになります。少なくとも1つの条件を指定するか、jobsToIncludeを明示的にALLに設定してすべての求人をスポンサーしてください。

    jobsQuery string

    求人クエリ。

    設定すると、キャンペーンはこの検索条件に一致する求人のみをスポンサー表示します。

    ブール式に対応しています。

    インデックス済み求人のクエリ形式をご覧ください。

    jobsToIncludeがQUERYの場合にのみ適用されます。

    jobsTitle string

    指定した場合、キャンペーンはこの求人タイトルを持つ求人のみをスポンサーします。jobsToIncludeがQUERYの場合のみ適用されます。

    jobsCompany string

    指定した場合、キャンペーンはこの採用企業を持つ求人のみをスポンサーします。jobsToIncludeがQUERYの場合のみ適用されます。

    jobsLocation string

    指定した場合、キャンペーンはこの場所またはその近くの求人のみをスポンサーします。jobsToIncludeがQUERYの場合のみ適用されます。

    jobsLocationRadius int32

    Default value: 25

    求人の場所とjobsLocationで指定された場所の最大距離を指定します。有効な値は5、10、15、25、50、100です。求人が米国または英国にある場合、単位はマイルです。それ以外の場合、単位はキロメートルです。

    budgetOnetimeLimit number

    設定されている場合、キャンペーンはキャンペーンの期間に対して単一の予算を持ちます。常にbudgetOnetimeLimitまたはbudgetMonthlyLimitのいずれかを指定する必要がありますが、両方は指定できません。

    予算は採用企業アカウントの通貨です。Sponsored Jobs APIは値を浮動小数点数ではなく正確な小数として解析、保存、返却します。

    budgetMonthlyLimit number

    設定されている場合、キャンペーンは月次定期予算を持ちます。月次定期予算を持つキャンペーンの終了日はオプションです。budgetOnetimeLimitまたはbudgetMonthlyLimitのどちらか1つを指定します。

    予算は採用企業アカウントの通貨です。Sponsored Jobs APIは値を浮動小数点数ではなく正確な小数として解析、保存、返却します。

    budgetFirstMonthBehavior string

    Possible values: [startNowFullAmount, startNowProratedAmount, startNextMonthFullAmount]

    Default value: startNowFullAmount

    startDateが月の最初の日でない場合に、このフィールドをbudgetMonthlyLimitとともに使用します。最初の月の予算を制御します。値は以下の通りです。

    値最初の月の予算
    startNowFullAmount 月次予算の全額。
    startNowProratedAmount 開始日以降の月の日数に比例。
    startNextMonthFullAmount 予算なし。

    この表は、月次予算が900 USD、開始日が6月11日、budgetFirstMonthBehaviorがこれらの値のいずれかに設定されている場合の最初の月と翌月の予算を示しています:

    値6月11日〜30日7月1日〜31日
    startNowFullAmount 900 USD900 USD
    startNowProratedAmount 600 USD900 USD
    startNextMonthFullAmount 0 USD900 USD
    startDate date

    キャンペーンが求人のスポンサーを開始する日付。ISO 8601のYYYY-MM-DD形式。デフォルトは現在の日付です。

    キャンペーンは指定された日付の米国中部時間（CT、US/Central）の開始時に求人のスポンサーを開始します。開始日はCTの現在日付以降である必要があります。例えば、startDateが2026-01-15の場合、キャンペーンは2021年1月15日の午前0:00 CTにスポンサーを開始します。開始日が指定されていないか現在の日付の場合、キャンペーンはすぐにスポンサーを開始します。

    キャンペーンがアクティブで支出中の場合、startDateを更新できません。キャンペーンを一時的に一時停止する場合は、statusをPAUSEDに設定します。

    fixedEndDate date

    残りの未使用予算があっても、キャンペーンが求人のスポンサーを停止しなければならない日付。ISO 8601のYYYY-MM-DD形式に従います。

    一括予算（budgetOnetimeLimit）を持つキャンペーンには、常にfixedEndDateまたはtargetEndDateのいずれか1つが必要ですが、両方は指定できません。

    月次定期予算（budgetMonthlyLimit）を持つキャンペーンには、オプションでfixedEndDateを設定できます。月次定期キャンペーンは、手動で一時停止または削除するまで求人のスポンサーを続けます。これらは「エバーグリーン」キャンペーンと呼ばれます。指定された日の開始時にキャンペーンを停止するには、fixedEndDateを指定します。

    キャンペーンは指定された日付の米国中部時間（CT、US/Central）の開始時に求人のスポンサーを停止します。fixedEndDateはCTの現在日付から少なくとも1日後、またはキャンペーンがある場合はキャンペーンのstartDateから少なくとも1日後である必要があります。例えば、固定終了日が2026-06-20の場合、キャンペーンは2021年6月20日の午前0:00 CTに停止します。

    targetEndDate date

    キャンペーンが求人のスポンサーを停止すべき日付ですが、予算全体をまだ使い切っていない場合は指定日を過ぎてもスポンサーを続ける場合があります。ISO 8601のYYYY-MM-DD形式に従います。

    一括予算（budgetOnetimeLimit）を持つキャンペーンには、常にfixedEndDateまたはtargetEndDateのいずれか1つが必要ですが、両方は指定できません。月次定期予算（budgetMonthlyLimit）を持つキャンペーンにはtargetEndDateを設定できず、fixedEndDateまたは終了日なしのみ設定できます。

    キャンペーンは指定された日付の米国中部時間（CT、US/Central）の開始を目標とします。目標終了日はCTの現在日付から少なくとも1日後、またはキャンペーンがある場合はキャンペーンのstartDateから少なくとも1日後である必要があります。例えば、目標終了日が2026-06-20の場合、キャンペーンは2021年6月20日の午前0:00 CTを目標とします。

    fundingSource string

    Possible values: [Budget, Bonus Sponsored Job Credits]

    Default value: Budget

    キャンペーンの資金調達ソース。有効な値はBudget（デフォルト）またはBonus Sponsored Job Creditsです。キャンペーンを作成した後に資金調達ソースを変更することはできません。

    Annual Deals クライアントはAnnual Deals の一部としてボーナススポンサー求人クレジットを受け取り、月次または生涯キャンペーンの作成に使用できます。

    objective

    object

    キャンペーンが達成しようとする採用目標で、キャンペーンを目標設定型キャンペーン （新しいウィンドウで開きます）にします。値は、キャンペーンの目標を指定するobjectiveTypeフィールドと、一部の目標タイプの場合は特定の目標指標を識別するtargetフィールドを持つJSONオブジェクトです。

    例えば、キャンペーンの目標が10件の応募を供給することである場合、objectiveを以下のように設定します:

    {
      "objectiveType": "TARGET_APPLICATIONS",
      "target": 10
    }

    目標を持たないキャンペーンに目標を追加したり、目標のtarget値を変更したりできます。ただし、目標を削除したり、objectiveTypeを変更したりすることはできません。

    objectiveType

    string

    Possible values: [BALANCE, MAXIMUM, QUICK, TARGET_APPLICATIONS, TARGET_COST_PER_APPLICATION, SCHEDULED_INTERVIEWS]

    キャンペーンの目標。平均日次予算（ADB）キャンペーン（STANDARDおよびPREMIUM）では、このフィールドを更新できません。

    利用可能な値は:

    • BALANCE: 求人間でバランスを取りながら、予算に対して最も多くの合計応募数を獲得します。
    • MAXIMUM: 求人間でクリックをバランスさせずに、予算に対して最も多くの合計応募数を獲得します。
    • QUICK: より速い結果のための高予算の5日間キャンペーン。Sponsored Jobs APIは現在、この目標でのキャンペーンの作成または変更をサポートしていません。 ただし、Sponsored Jobs APIはこの目標タイプのキャンペーンのキャンペーンレポートの取得は許可しています（これらのキャンペーンはIndeed for Employersを使用して作成されています）。
    • TARGET_APPLICATIONS: targetで指定された応募数への到達を目指します。目標応募数に達すると、これらの求人への支出は大幅に削減され、他の場所に割り当てられます。
    • TARGET_COST_PER_APPLICATION: targetで指定された数値を下回る応募あたりのコストを維持することを目指します。
    • SCHEDULED_INTERVIEWS: スクリーニングされた候補者をすぐに面接に送ります。targetで指定された面接数への到達を目指します。この目標はアクティブなIndeed Hiring Platformサブスクリプションが必要で、顧客が含まれる求人の採用イベントを作成する準備ができている場合のみ使用してください。

    アプリケーション外で作成されたキャンペーンは、アプリケーションでまだサポートされていない新しく追加された目標タイプを使用する場合があります。アプリケーションは予期しないobjectiveType値を処理するためのフォールバックロジックを持つ必要があります。

    any

    channels

    object[]

    チャンネルはデフォルトのチャンネルを含みません。

    例えば、TMNチャンネルを有効にするには、channelsを以下のように設定します:

    [
      {
        "channel": "TMN",
        "status": "CHANNEL_ENABLED"
      }
    ]

  • Array [

    • channel SpendingChannel

    Possible values: [TMN]

    チャンネルID。有効な値は:

    • TMN : Trusted Media Network。
    status ChannelStatus

    Possible values: [CHANNEL_ENABLED, CHANNEL_DISABLED]

    チャンネル支出ステータスID。有効な値は:

    • CHANNEL_ENABLED : チャンネルが支出に対して有効
    • CHANNEL_DISABLED : チャンネルが支出に対して無効

  • ]

    • jobsSourceName string

    求人ソース名。

    ATS連携のみ。

    sponsorshipPlan string

    Possible values: [STANDARD, PREMIUM]

    sponsorshipPlan は平均日次予算（ADB）キャンペーンにのみ設定します。採用企業は ADB キャンペーンを作成する際に指定する必要があります。省略した場合、キャンペーンは既定で STANDARD になります。

    budgetCapType string

    Possible values: [ONETIME, MONTHLY, FLEXIBLE]

    予算上限のタイプ。

    有効な値はONETIME、MONTHLY、FLEXIBLEです。

    ADBキャンペーンでは、タイプがONETIMEの場合はbudgetOnetimeLimitを設定します。

    ADBキャンペーンでは、タイプがMONTHLYの場合はbudgetMonthlyLimitを設定します。

    Indeedは設定された月額予算または一回限りの予算目標に向けて消費を最適化します。

    設定した予算上限が高い場合、消費が推奨日次予算を超えることがあります。

    avgDailyBudgetConfig

    object

    平均日次予算（ADB）キャンペーンの詳細。ADB キャンペーンでは必須です。

    adbBehaviour stringrequired

    Possible values: [AUTO]

    必須。平均日次予算（ADB）の動作。有効な値: AUTO。

    budgetBoostPercentage integer

    Possible values: <= 1500

    求人ごとの基本平均日次予算（ADB）を指定した割合で引き上げます。

    このフィールドは柔軟なADBキャンペーンでのみ使用します。

    月額キャンペーンや一回限りのキャンペーンでは使用しないでください。

    手動またはクエリ解決で新しく追加された求人も、推奨予算に対して同じ割合の引き上げが適用されます。

    有効な値は0から1500です。

Responses​

新しいキャンペーンのキャンペーンIDをdata.campaignIdフィールドとして返します。HTTPステータスは201で、200ではないことに注意してください。

Schema

    meta

    object

    レスポンス関連のメタデータ。

    status int32

    レスポンスのHTTPステータスコード。

    errors

    object[]

    リクエストの正常な処理を妨げたエラー。エラーがなかった場合、値はnullです。

  • Array [

    • type string

    エラーの名前。

    description string

    問題の人間が読める説明。

  • ]

    • rootLocation string

    Sponsored Jobs API のベース URL。

    perPage int32

    ページネーションされた結果を返すエンドポイントの場合、1ページに返されるエントリの実際の最大数。perPageパラメータでリクエストした最大値より小さい場合があります。エンドポイントが単一の結果を返すかページネーションしない場合、値はnullです。

    links

    object[]

    リクエストされたリソースに関連するリソース。

  • Array [

    • rel string

    リクエストされたリソースと関連リソースの関係。一般的に使用される値:

    • up: 関連リソースは、リクエストされたリソースを含むコレクション、またはリクエストされたリソースが関連付けられているエンティティです。
    • next: ページネーションされた結果の次のページ。
    • prev: ページネーションされた結果の前のページ。

    ただし、値はCampaign Infoなどの関係を説明する任意の文字列の場合もあります。

    href string

    関連リソースのエンドポイントURL。クエリ文字列パラメータを含む場合があります。完全なURLを取得するには、hrefをrootLocationに追加します。

  • ]

    • data

    object

    campaignId string
Loading...

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

に最終更新