入ってください
メニュー

API: 入札管理（テクニカル概要）

offers を管理するには、Mintegral token を使用する必要があります。詳細は Token を確認してください。

Request address

https://ss-api.mintegral.com/api/open/v1/offer/bid_rate

Request method

PUT

Request example

json Copy 
PUT /api/open/v1/offer/bid_rate
HTTP/1.1 Host: ss-api.mintegral.com
Content-Type: application/json
// Normal Bidding (regardless of region, regardless of mtgid)
{
  "offer_id": 123, 
  "bid_rate":3.2
}
// Bidding by region:
{
  "offer_id": 123, 
  "bid_rate":3.2, 
  "bid_rate_by_location": [
    {"country_code":"CN,AE","bid_rate":0.5},
    {"country_code":"CN","bid_rate":0.6}
  ]
}
// Bidding by mtgid:
{
  "offer_id": 123, 
  "bid_rate":3.2, 
  "bid_rate_by_mtgid": [
    {"country_code":"CN,AE","bid_rate":0.5,"mtgid":"mtg123456"},
    {"country_code":"CN","bid_rate":0.6,"mtgid":"mtg654321"}
  ]
}

Request Parameter

Fields Type Explanations Default Value Examples
offer_id int offer の一意の id — 123
bid_rate Optional float すべての offer target geos に対する default bidding price value。specific geo または application bid が設定されていない場合にのみ適用されます。0 より大きい小数点以下 3 桁の float が使用できます。CPE/CPI/CPM bid type では 0.01 より大きい必要があり、CPC bid type では 0.001 より大きい必要があります。 — 5.22
bid_rate_by_location Optional array<json> specific geos の bidding price value。Note: bids が必要なすべての geo を提出してください。request に含まれない geos は default bids に設定されます。 — specific geo の bids をキャンセルする場合は、この field を空にします。例: bid_rate_by_location = []
country_code string bid setting の targeted geos。targeting geo は offer geos 内に含まれている必要があります。 — "CN,US"
bid_rate float specific geos の bidding price value。 — 3.21
bid_rate_by_mtgid Optional array<json> specific publishers の bidding price value。Note: 1. advanced feature のため、“permission denied” が返る場合は AM に連絡して access を取得してください。2. specific publisher の bids をキャンセルする場合は、この field を空にします。3. bids が必要なすべての mtgid を提出してください。request に含まれない mtgids は default bids に設定されます。 — specific publishers の bids をキャンセルする場合は、この field を空にします。例: bid_rate_by_mtgid = []
country_code float Targeted geos — "CN"
bid_rate float specific geos 内の specific publisher の bidding price value — 3.21
mtgid float publisher の一意の id — "mtg123456"

Notes：

1 bid_rate の precision は 0.001 です。

2 Bid rate の minimum value は bid_type に関連します。
> A) Offer’s bid type が "CPI"、"CPE"、"CPM" の場合、minimum bid rate は 0.01 です。
> B) Offer’s bid type が "CPC" の場合、minimum bid rate は 0.001 です。

3 bid_rate と bid_rate_by_location を同時に null のままにすることはできません。

4 bid_rate の値を変更して offer の default price を更新できます。

5 bid_rate_by_location の値を変更して specific area の price を更新できます。

6 specific area の price を削除する必要がある場合は、"bid_rate_by_location" を null のままにしてください。例: bid_rate_by_location = [].

7 この api は full update method を使用します。geo または mtgid ごとの bids を提出する場合は、complete settings を提出してください。

Response

Fields Type Explanations
code int 200 code は成功を示します。それ以外は失敗です。
msg string 成功時は "success" を返します。失敗時は詳細なエラー情報を返します。
data json 成功時は offer id を返します。失敗時は詳細なエラー情報を返します。

Response Example

json Copy 
{
  "msg": "success",
  "code": 200,
  "data": {
    "id": 123
  }
}
前の
API: オファー管理（テクニカルガイド）
次
API: 予算更新（テクニカルガイド）
最近変更された: 2026-08-06