Merge branch 'release/v1.7.1'

README.md

@@ -146,6 +146,10 @@
     - 查询定向模板接口 [ target.TemplateList(clt *core.SDKClient, accessToken string, req *target.TemplateListRequest) (*target.TemplateListResponse, error) ]
     - 修改定向模板 [ target.TemplateUpdate(clt *core.SDKClient, accessToken string, req *target.TemplateUpdateRequest) (*target.Template, error) ]
     - 删除定向模板 [ target.TemplateDelete(clt *core.SDKClient, accessToken string, req *target.TemplateDeleteRequest) error ]
+  - 直播推广 (api/dsp/jingbell)
+    - 小铃铛推送 [ jingbel.Share(clt *core.SDKClient, accessToken string, req *jingbell.ShareRequest) error ]
+  - 原生广告投放工具 (api/dsp/native)
+    - 开启原生扩量开关接口 [ OpenAccountNative(clt *core.SDKClient, accessToken string, req *native.OpenAccountNativeRequest) error ]
 - DMP人群管理(api/dmp)
   - 人群包上传接口 [ PopulationUpload(clt *core.SDKClient, accessToken string, req *dmp.PopulationUploadRequest) (*dmp.Population, error) ]
   - 人群包更新接口 [ PopulationUpdate(clt *core.SDKClient, accessToken string, req *dmp.PopulationUpdateRequest) (*dmp.Population, error) ]

api/dsp/jingbell/doc.go

@@ -0,0 +1,2 @@
+// Package jingbell 直播推广相关
+package jingbell

api/dsp/jingbell/share.go

@@ -0,0 +1,19 @@
+package jingbell
+
+import (
+	"github.com/bububa/kwai-marketing-api/core"
+	"github.com/bububa/kwai-marketing-api/model"
+	"github.com/bububa/kwai-marketing-api/model/dsp/jingbell"
+)
+
+// Share 小铃铛推送
+func Share(clt *core.SDKClient, accessToken string, req *jingbell.ShareRequest) error {
+	var resp jingbell.ShareResponse
+	if err := clt.Post(accessToken, req, &resp); err != nil {
+		return err
+	}
+	if resp.Result != 1 {
+		return model.BaseResponse{Code: resp.Result, Message: resp.Data}
+	}
+	return nil
+}

api/dsp/native/doc.go

@@ -0,0 +1,2 @@
+// Package native 原生广告投放工具
+package native

api/dsp/native/open_account_native.go

@@ -0,0 +1,12 @@
+package native
+
+import (
+	"github.com/bububa/kwai-marketing-api/core"
+	"github.com/bububa/kwai-marketing-api/model/dsp/native"
+)
+
+// OpenAccountNative 开启原生扩量开关接口
+func OpenAccountNative(clt *core.SDKClient, accessToken string, req *native.OpenAccountNativeRequest) error {
+	var resp native.OpenAccountNativeResponse
+	return clt.Post(accessToken, req, &resp)
+}

api/track/click.go

@@ -15,6 +15,7 @@ var DEFAULT_CLICK_FIELDS = []string{
 	"idfa",
 	"android_id",
 	"oaid",
+	"caid",
 	"os",
 	"ip",
 	"ua",
@@ -54,6 +55,8 @@ func Click(baseUrl string, fields []string) string {
 			values.Set("android_id", "__ANDROIDID2__")
 		case "oaid":
 			values.Set("oaid", "__OAID2__")
+		case "caid":
+			values.Set("caid", "__KENYID_CAA__")
 		case "os":
 			values.Set("os", "OS")
 		case "ip":

model/dsp/creative/advanced_creative.go

@@ -83,4 +83,7 @@ type AdvancedCreative struct {
 	// Recommendation plc自定义文案
 	// 开启原生时可用
 	Recommendation string `json:"recommendation,omitempty"`
+	// OpenAccountNative 是否为原生扩量
+	// 0：否 1：是
+	OpenAccountNative int `json:"open_account_native,omitempty"`
 }

model/dsp/creative/creative.go

@@ -121,6 +121,9 @@ type Creative struct {
 	// CreativeMode 创意生成模式
 	// 0：默认-普通模式 1：AIGC生成
 	CreativeMode int `json:"creative_mode,omitempty"`
+	// OpenAccountNative 是否为原生扩量
+	// 0：否 1：是
+	OpenAccountNative int `json:"open_account_native,omitempty"`
 }
 
 // DisplayInfo 广告展示信息

model/dsp/jingbell/doc.go

@@ -0,0 +1,2 @@
+// Package jingbell 直播推广相关
+package jingbell

model/dsp/jingbell/share.go

@@ -0,0 +1,33 @@
+package jingbell
+
+import "github.com/bububa/kwai-marketing-api/model"
+
+// ShareRequest 小铃铛推送 API Request
+type ShareRequest struct {
+	// AdvertiserID 广告主userId
+	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
+	// LiveUserID 主播ID
+	LiveUserID string `json:"live_user_id,omitempty"`
+	// JingBellUserID 小铃铛ID
+	JingBellUserID string `json:"jing_bell_user_id,omitempty"`
+	// TargetAccountIDs 推送目标 accountIds
+	TargetAccountIDs []string `json:"target_account_ids,omitempty"`
+}
+
+// Url implement PostRequest interface
+func (r ShareRequest) Url() string {
+	return "gw/dsp/jingBell/share"
+}
+
+// Encode implement PostRequest interface
+func (r ShareRequest) Encode() []byte {
+	return model.JSONMarshal(r)
+}
+
+// ShareResponse 小铃铛推送 API Response
+type ShareResponse struct {
+	// Result 1成功 非1失败
+	Result int `json:"result,omitempty"`
+	// Data 如果失败，则是失败信息
+	Data string `json:"data,omitempty"`
+}

model/dsp/native/doc.go

@@ -0,0 +1,2 @@
+// Package native 原生广告投放工具
+package native

model/dsp/native/open_account_native.go

@@ -0,0 +1,28 @@
+package native
+
+import "github.com/bububa/kwai-marketing-api/model"
+
+// OpenAccountNativeRequest 开启原生扩量开关 API Request
+type OpenAccountNativeRequest struct {
+	// AdvertiserID 广告主 ID
+	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
+	// OpenAccountNative 开启/关闭原生扩量开关
+	// 1开启 0关闭
+	OpenAccountNative int `json:"open_account_native"`
+}
+
+// Url implement PostRequest interface
+func (r OpenAccountNativeRequest) Url() string {
+	return "gw/dsp/native/openAccountNative"
+}
+
+// Encode implement PostRequest interface
+func (r OpenAccountNativeRequest) Encode() []byte {
+	return model.JSONMarshal(r)
+}
+
+// OpenAccountNativeResponse 开启原生扩量开关 API Response
+type OpenAccountNativeResponse struct {
+	// OpenAccountNative 操作结果 true:成功 false：失败
+	OpenAccountNative bool `json:"open_account_native,omitempty"`
+}

model/dsp/unit/unit.go

@@ -237,6 +237,9 @@ type Unit struct {
 	// ULink Universal Link 链接
 	// 仅在计划 campaignType=7 提升应用活跃时使用，输入后IOS将优先调起该链接，不超过2000字符
 	ULink string `json:"u_link,omitempty"`
+	// UnitMaterialType 广告标的物类型
+	// campaignType = 19（快手小程序/小游戏推广）时（释义同mini_app_type字段）表示：1：快手小程序；2：快手小游戏；campaignType = 32（微信小程序/小游戏推广）时表示：3：微信小程序；4：微信小游戏
+	UnitMaterialType int `json:"unit_material_type,omitempty"`
 }
 
 // DpaUnitParam DPA 相关商品信息