メニュー

API: クリエイティブ更新（テクニカルガイド）

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

Mintegral API を使用して offers の creatives を更新する方法は以下のとおりです。creatives のサイズ、形式、アスペクト比の要件については appendix を参照してください。
[Appendix - Creative Dimension].

Request address

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

この interface は廃止予定です。API—Create Creative Set を使用してください。

Request method

PUT

Request example

json Copy

PUT /api/open/v1/offer/apply_creative
HTTP/1.1 Host: ss-api.mintegral.com
Content-Type: application/json
{
  "offer_id": 123,
  "ad_type": "REWARDED_VIDEO",
  "creative": [
    {
      "creative_md5":"0a6335cd9151ac5dc79ad996f4e12674",
      "creative_name":"creative_test.png" ,
      "apply_in_area": "CN,EN",
      "option": "ENABLE"
    }
  ]
}

Request Parameter

Fields	Type	Explanations	Default Value	Examples
offer_id	int	Offer ID	—	`123`
ad_type	string	Target ad types。複数の ad types はカンマで区切ります。Enum value： [ENUM-ad type(static)] [ENUM-ad type(video)]	—	`"REWARDED_VIDEO"`
creative	array<json>	creative 情報
creative_md5	string	アップロード後に生成される Creative MD5。デフォルトでは file name です。creative name は letters、digits、underscore のみ使用できる点に注意してください。	—	`"0a6335cd9151ac5dc79ad996f4e12674"`
creative_name	string	アップロード後に生成される Creative name。	—	`"creative_test"`
apply_in_area	string	specific creatives の targeted geos。targeted geos は offer の target_geo 内に含まれている必要があります。 PS: 1. offer 内のすべての geos をターゲットにする場合は "ALL" を設定します。2. 複数の targeted geos はカンマで区切ります。	—	`"CN,EN"`
creative_set_name `Optional`	string	Creative set name	—	`"default"`
option	string	offers 配下の creative status。 Enum value: `"ENABLE"`, `"DISABLE"`. `ENABLE`: creative を offer で配信可能にします。`DISABLE`: specific offer から creative を一時停止・削除します。Note: new offers を設定する場合は "ENABLE" を設定してください。	—	`"DISABLE"`

Response

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

Response Example

json Copy

{
  "msg": "success",
  "code": 200,
  "data": ["success"]
}

API: トラッキングURL更新（テクニカルガイド）

次

API: オーディエンスターゲット更新（テクニカルガイド）

最近変更された: 2026-08-06

概要