analyse

Documentation

Overview

Package analyse 商品竞争分析相关API

Index

• type CompareCreative
• type CompareCreativeRequest
  • func (r CompareCreativeRequest) Encode() string
• type CompareCreativeResponse
• type CompareStatsData
• type CompareStatsDataRequest
  • func (r CompareStatsDataRequest) Encode() string
• type CompareStatsDataResponse
• type Creative
• type ListRequest
  • func (r ListRequest) Encode() string
• type ListResponse
• type ListResponseData
• type Metrics
• type Product
• type TitleMaterial
• type VideoMaterial

Types

type CompareCreative

type CompareCreative struct {
	// OwnProductCreative 我的商品创意数据
	OwnProductCreative []Creative `json:"own_product_creative,omitempty"`
	// SimilarProductCreative 相似商品创意数据
	SimilarProductCreative []Creative `json:"similar_product_creative,omitempty"`
}

type CompareCreativeRequest

type CompareCreativeRequest struct {
	// AdvertiserID 广告主id
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// ProductID 商品ID
	ProductID uint64 `json:"product_id,omitempty"`
	// TimeRange 商品数据范围，可选值
	// 30：30天
	// 15：15天
	// 7：7天（默认）
	TimeRange int `json:"time_range,omitempty"`
}

CompareCreativeRequest 商品竞争分析详情-创意比对 API Request

func (CompareCreativeRequest) Encode

func (r CompareCreativeRequest) Encode() string

Encode implement GetRequest interface

type CompareCreativeResponse

type CompareCreativeResponse struct {
	model.BaseResponse
	Data *CompareCreative `json:"data,omitempty"`
}

CompareCreativeResponse 商品竞争分析详情-创意比对 API Response

type CompareStatsData

type CompareStatsData struct {
	// OwnProductData 我的商品数据
	OwnProductData *Metrics `json:"own_product_data,omitempty"`
	// SimilarProductData 相似商品数据
	SimilarProductData *Metrics `json:"similar_product_data,omitempty"`
	// CompeteProductData 全部商品数据
	CompeteProductData *Metrics `json:"compete_product_data,omitempty"`
}

type CompareStatsDataRequest

type CompareStatsDataRequest struct {
	// AdvertiserID 广告主id
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// ProductID 商品ID
	ProductID uint64 `json:"product_id,omitempty"`
	// TimeRange 商品数据范围，可选值
	// 30：30天
	// 15：15天
	// 7：7天（默认）
	TimeRange int `json:"time_range,omitempty"`
}

CompareStatsDataRequest 商品竞争分析详情-效果对比 API Request

func (CompareStatsDataRequest) Encode

func (r CompareStatsDataRequest) Encode() string

Encode implement GetRequest interface

type CompareStatsDataResponse

type CompareStatsDataResponse struct {
	model.BaseResponse
	Data *CompareStatsData `json:"data,omitempty"`
}

CompareStatsDataResponse 商品竞争分析详情-效果对比 API Response

type Creative

type Creative struct {
	// ImageMode 素材类型，可选值:
	// LARGE 大图
	// LARGE_VERTICAL 大图竖图
	// SMALL 小图
	// SQUARE 方图
	// UNION_SPLASH 穿山甲开屏图片
	// VIDEO_LARGE 横版视频
	// VIDEO_VERTICAL 竖版视频
	ImageMode enum.MaterialMode `json:"image_mode,omitempty"`
	// TitleMaterial 标题素材
	TitleMaterial *TitleMaterial `json:"title_material,omitempty"`
	// VideoMaterial 视频素材
	VideoMaterial *VideoMaterial `json:"video_material,omitempty"`
	Metrics
	// ProductInfo 商品信息
	ProductInfo *Product `json:"product_info,omitempty"`
}

Creative 商品创意数据

type ListRequest

type ListRequest struct {
	// AdvertiserID 广告主id
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// Keyword 商品关键词，支持根据商品id/名称搜索
	Keyword string `json:"keyword,omitempty"`
	// TimeRange 商品数据范围，可选值
	// 7：7天（默认）
	// 15：15天
	// 30：30天
	TimeRange int `json:"time_range,omitempty"`
	// OrderType 排序方式，允许值：
	// ASC 升序
	// DESC降序（默认）
	OrderType enum.OrderType `json:"order_type,omitempty"`
	// OrderField 排序字段，允许值参考数据指标，默认不传为stat_cost
	OrderField string `json:"order_field,omitempty"`
	// Page 页码，默认1
	Page int `json:"page,omitempty"`
	// PageSize 页面大小，默认20，不超过100
	PageSize int `json:"page_size,omitempty"`
}

ListRequest 获取商品竞争分析列表 API Request

func (ListRequest) Encode

func (r ListRequest) Encode() string

Encode implement GetRequest interface

type ListResponse

type ListResponse struct {
	model.BaseResponse
	Data *ListResponseData `json:"data,omitempty"`
}

ListResponse 获取商品竞争分析列表 API Response

type ListResponseData

type ListResponseData struct {
	// PageInfo 分页信息
	PageInfo *model.PageInfo `json:"page_info,omitempty"`
	// ProductList 商品列表
	ProductList []Product `json:"product_list,omitempty"`
}

type Metrics

type Metrics struct {
	// StatCost 消耗
	StatCost float64 `json:"stat_cost,omitempty"`
	// DirectOrderPayGmv 直接成交金额
	DirectOrderPayGmv float64 `json:"direct_order_pay_gmv,omitempty"`
	// DirectOrderPrepayAndPayRoi 广告支付ROI
	DirectOrderPrepayAndPayRoi float64 `json:"direct_order_prepay_and_pay_roi,omitempty"`
	// Ctr 点击率
	Ctr float64 `json:"ctr,omitempty"`
	// DirectOrderPayRate 成交转化率
	DirectOrderPayRate float64 `json:"direct_order_rate,omitempty"`
	// DirectOrderPayCost 订单转化成本
	DirectOrderPayCost float64 `json:"direct_order_pay_cost,omitempty"`
	// DirectOrderPayCount 直接成交订单数
	DirectOrderPayCount int64 `json:"direct_order_pay_count,omitempty"`
	// DirectOrderPayCostPerOrder 广告成交客单价
	DirectOrderPayCostPerOrder float64 `json:"direct_order_pay_cost_per_order,omitempty"`
	// PayOrderCouponAmount 成交智能优惠券金额
	PayOrderCouponAmount float64 `json:"pay_order_coupon_amount,omitempty"`
	// TotalPlay 播放量
	TotalPlay int64 `json:"total_play,omitempty"`
	// DyShare 分享数
	DyShare int64 `json:"dy_share,omitempty"`
	// DyLike 点赞数
	DyLike int64 `json:"dy_like,omitempty"`
	// DyComment 评论数
	DyComment int64 `json:"dy_comment,omitempty"`
	// DyFollow 新增粉丝数
	DyFollow int64 `json:"dy_follow,omitempty"`
}

Metrics 指标数据

type Product

type Product struct {
	// ProductID 商品id
	ProductID uint64 `json:"product_id,omitempty"`
	// SaleTime 上架时间，时间戳
	SaleTime int64 `json:"sale_time,omitempty"`
	// ProductRate 好评率
	ProductRate float64 `json:"product_rate,omitempty"`
	// ProductName 商品名称
	ProductName string `json:"product_name,omitempty"`
	// ProductImg 商品图片url列表
	ProductImg []string `json:"product_img,omitempty"`
	// DiscountPrice 售卖价格
	DiscountPrice float64 `json:"discount_price,omitempty"`
	// MarketPrice 原价
	MarketPrice float64 `json:"market_price,omitempty"`
	// Recommendation 推荐语
	Recommendation string `json:"recommendation,omitempty"`
	// CategoryName 一级类目
	CategoryName string `json:"category_name,omitempty"`
	Metrics
}

Product 商品

type TitleMaterial

type TitleMaterial struct {
	// Title 标题
	Title string `json:"title,omitempty"`
}

TitleMaterial 标题素材

type VideoMaterial

type VideoMaterial struct {
	// VideoID 视频id
	VideoID string `json:"video_id,omitempty"`
	// VideoDuration 视频时长
	VideoDuration float64 `json:"video_duration,omitempty"`
	// AwemeItemID 抖音主页视频id
	AwemeItemID uint64 `json:"aweme_item_id,omitempty"`
	// CoverImageHeight 视频封面高
	CoverImageHeight float64 `json:"cover_image_height,omitempty"`
	// CoverImageWidth 视频封面宽
	CoverImageWidth float64 `json:"cover_image_width,omitempty"`
	// CoverImageWebURL 视频封面url
	CoverImageWebURL string `json:"cover_image_web_url,omitempty"`
	// VideoURL 视频播放地址
	VideoURL []string `json:"video_url,omitempty"`
	// Source  视频来源，可选值:
	// AD 广告后台
	// AWEME_VIDEO 抖音原生视频
	Source string `json:"source,omitempty"`
}

VideoMaterial 视频素材