Update Creatives

PS: You need to use Token to change the status, for more details, please check Token

Through this interface, you could update creatives for offer. See the appendix for details on creative dimension requirements [Appendix - Creative Dimension] .

Request address

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

This interface is about to be obsolete, please use [Api - Create Creative Set](/en/guide/creative_set/createCreativeSet#Request Params)

Request method

PUT

Request example

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. Separate with commas for multiple ad types. Enum value in ：[EUNM - Ad Type(Static)] [EUNM - Ad Type(Video)]	—	"REWARDED_VIDEO"
creative	array<json>
creative_md5	string	Creative MD5 generated after being uploaded. And is file name by default, please note, creative name must be letters, digits, or the underscore	—	"0a6335cd9151ac5dc79ad996f4e12674"
creative_name	string	Creative name generated after being uploaded.	—	"creative_test"
apply_in_area	string	Targeted geos for specific creatives. Targeted geos must be in offer's target_geo. PS: 1. Set "ALL" for targeting all geos in offer. 2. Separate with commas for multiple targeted geos.	—	"CN,EN"
creative_set_name Optional	string	Creative set name	—	"default"
option	string	Status for creative under offers. Enum value: "ENABLE", "DISABLE". ENABLE: Allow creative to run in offer. DISABLE: Pause and romove creative from specific offer. Note: Set "ENABLE" for setting up new offers.	—	"DISABLE"

Response

Fields	Type	Explanations
code	int	200 code, is success. Others, are fail.
msg	string	If success, return to "success". If fail, return to detailed wrong info.
data	json	If success, return ["success"]. If fail, return to detailed wrong info.

Response Example

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