github.com/bububa/oceanengine/marketing-api@v0.0.0-20210315120513-0b953137f7a6/model/campaign/create.go (about)

     1  package campaign
     2  
     3  import (
     4  	"encoding/json"
     5  
     6  	"github.com/bububa/oceanengine/marketing-api/enum"
     7  	"github.com/bububa/oceanengine/marketing-api/model"
     8  )
     9  
    10  type CreateRequest struct {
    11  	AdvertiserID       uint64           `json:"advertiser_id,omitempty"`        // 广告主ID
    12  	CampaignName       string           `json:"campaign_name,omitempty"`        // 广告组名称，长度为1-100个字符，其中1个中文字符算2位
    13  	Operation          string           `json:"operation,omitempty"`            // 广告组状态, 允许值: "enable","disable"默认值：enable开启状态
    14  	BudgetMode         enum.BudgetMode  `json:"budget_mode,omitempty"`          // 广告组预算类型
    15  	Budget             float64          `json:"budget,omitempty"`               // 广告组预算，取值范围: ≥ 0; 当budget_mode为"BUDGET_MODE_DAY"时,必填,且日预算不少于300	元
    16  	LandingType        enum.LandingType `json:"landing_type,omitempty"`         // 广告组推广目的
    17  	UniqueFk           string           `json:"unique_fk,omitempty"`            // 第三方唯一键，传该值时保证接口重试的幂等性，请注意，带有相同unique_fk的请求服务端会视为同一个广告处理。仅在创建接口传入且无法修改，如果创建时传入了已存在的唯一键值，那么会返回该唯一键值所对应的广告组ID。该值可用于内部系统会生成的唯一ID与头条ID做关联的场景，避免超时重试实际上一次创建请求又成功导致的重复创建问题，通过unique_fk可与内部系统ID实现关联并避免重复创建，可结合实际场景选择使用，广告组中的unique_fk要求不重复，与计划中的unique_fk无相关。
    18  	DeliveryRelatedNum enum.CampaignDPA `json:"delivery_related_num,omitempty"` // 广告组商品类型
    19  }
    20  
    21  func (r CreateRequest) Encode() []byte {
    22  	ret, _ := json.Marshal(r)
    23  	return ret
    24  }
    25  
    26  type CreateResponse struct {
    27  	model.BaseResponse
    28  	Data *CreateResponseData `json:"data,omitempty"`
    29  }
    30  
    31  type CreateResponseData struct {
    32  	CampaignID uint64 `json:"campaign_id,omitempty"` // 广告组id
    33  }