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

基本的なキャンペーン情報の更新

PATCH 
/v1/campaigns/:campaignId

既存のスポンサー求人キャンペーンの基本情報を更新します。

OAuth スコープアクセストークンの種類
employer.advertising.campaign

採用企業を表すアクセストークン。

Request​

Path Parameters

    campaignId stringrequired

    更新するキャンペーンのキャンペーンID。

Body

required

リクエスト本文は、キャンペーンに対して行う変更を記述するJSONオブジェクトである必要があります。

HTTPリクエストヘッダー

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

  • Content-Type: application/json
  • Accept: application/json

更新

値がnullのフィールドや、リクエストで指定されていないフィールドは、現在の値を維持します。

jobsToIncludeをALLに変更すると、jobsQuery、jobsTitle、jobsCompany、jobsLocation、およびjobsLocationRadiusの既存の値はクリアされます。

目標

平均日次予算（ADB）キャンペーン（STANDARDおよびPREMIUM）では、目標を設定または変更できません。

目標が設定されていないキャンペーンにはobjectiveを追加し、そのtargetを更新できますが、目標を削除したりobjectiveTypeを変更したりすることはできません。

    name string

    Possible values: non-empty and <= 250 characters

    キャンペーンを後で識別するために役立つキャンペーン名。採用企業アカウント内で固有の名前にする必要があります。

    trackingToken string

    Possible values: <= 255 characters

    スポンサークリック時に求人URLに追加されるクリックトラッキングトークン。クリックが Indeed から行われたこと、また必要に応じてクリックのスポンサーとなったキャンペーンを特定できます。

    status string

    Possible values: [ACTIVE, DELETED, PAUSED]

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

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

    Possible values: [ALL, QUERY]

    • ALL - キャンペーンは求人ソース内のすべての求人をスポンサー掲載します。jobsQuery、jobsTitle、jobsCompany、jobsLocation、jobsLocationRadius の各フィールド値は無視され、既存の値はすべて消去されます。
    • QUERY - キャンペーンは jobsQuery、jobsTitle、jobsCompany、jobsLocation、jobsLocationRadius の各フィールドで定義した条件に一致する求人の一部をスポンサー掲載します。複数のフィールドを指定した場合は、すべての条件に一致する求人だけがスポンサー掲載されます。

    注: jobsToInclude を QUERY に設定し、条件を指定しない場合は、すべての求人がスポンサー掲載されます。今後のバージョンではこれはエラーになります。少なくとも 1 つの条件を指定するか、jobsToInclude を ALL に設定してください。Bonus Credit キャンペーンでは、採用企業が更新できるのは jobsQuery と jobsToInclude のみです。

    jobsQuery string

    これらの検索語に一致する求人のみをスポンサー掲載します。

    ブール式をサポートします。

    詳しくは、Indexed jobs query formatをご覧ください。

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

    Bonus Credit キャンペーンでは、採用企業が更新できるのはjobsQueryとjobsToIncludeのみです。

    平均日次予算（ADB）キャンペーンでは、900件を超える求人に一致する更新リクエストは失敗します。

    求人が動的に解決される場合、スポンサー掲載されるのは900件のみです。

    jobsTitle string

    指定すると、キャンペーンはこの職種名の求人のみを有料掲載します。jobsToIncludeがQUERYの場合にのみ適用されます。

    jobsCompany string

    指定すると、キャンペーンはこの採用企業の求人のみを有料掲載します。jobsToIncludeがQUERYの場合にのみ適用されます。

    jobsLocation string

    指定すると、キャンペーンはこの勤務地かその周辺の求人のみを有料掲載します。jobsToIncludeがQUERYの場合にのみ適用されます。

    jobsLocationRadius int32

    Default value: 25

    求人の勤務地とjobsLocationで指定される場所の最大の距離を指定します。このフィールドに指定できる値は、5、10、15、25、50、100のみです。単位は、求人の勤務地が米国または英国内の場合はマイル、それ以外の場合はkmです。

    objective

    object

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

    たとえば、キャンペーンの目標が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 求人掲載を使用して作成されます）。
    • TARGET_APPLICATIONS：targetによって指定される応募数の達成を目標とします。目標応募数に達した場合、その求人への支出は大幅に削減され、他の求人に割り当てられます。
    • TARGET_COST_PER_APPLICATION：応募単価がtargetによって指定される数値を常に下回るようにすることを目標とします。
    • SCHEDULED_INTERVIEWS：スクリーニングを通過した応募者との面接をただちに設定します。targetによって指定される面接数の達成を目標とします。この目標を使用するには、アクティブな Indeed Hiring Platformのサブスクリプションが必要です。また、対象となる求人の採用イベントを作成する準備がお客様側で整っている場合にのみ使用を推奨しています。

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

    any

    UpdateAvgDailyBudgetConfig

    object

    平均日次予算（ADB）の詳細。

    ADB キャンペーンの予算を更新する場合は必須です。

    adbBehaviour stringrequired

    Possible values: [AUTO]

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

    budgetBoostPercentage integer

    Possible values: <= 1500

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

    このフィールドは柔軟な ADB キャンペーンでのみ使用します。月額キャンペーンや一回限りのキャンペーンでは使用しないでください。

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

    有効な値: 0 から 1500。

Responses​

正常に実行されると、HTTPステータスとして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パラメータでリクエストした最大値より小さい場合があります。エンドポイントが返す結果が1つの場合や、ページ付けが行われない場合は、値はnullになります。

    links

    object[]

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

  • Array [

    • rel string

    リクエストされたリソースと関連リソースの関係。次の値が一般的に使用されます。

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

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

    href string

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

  • ]

    • data

    object

    campaignId string

    リクエストで指定されるcampaignId と常に同じ値です。

Loading...

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

に最終更新