advertiser

Documentation

Overview

Package advertiser 广告主相关API结构体

Index

• type Balance
• type BalanceGetRequest
  • func (r BalanceGetRequest) Encode() []byte
  • func (r BalanceGetRequest) Url() string
• type Budget
• type BudgetGetRequest
  • func (r BudgetGetRequest) Encode() []byte
  • func (r BudgetGetRequest) Url() string
• type FundDailyFlow
• type FundDailyFlowsRequest
  • func (r FundDailyFlowsRequest) Encode() []byte
  • func (r FundDailyFlowsRequest) Url() string
• type FundDailyFlowsResponse
• type FundGetRequest
  • func (r FundGetRequest) Encode() []byte
  • func (r FundGetRequest) Url() string
• type FundGetResponse
• type Info
• type InfoRequest
  • func (r InfoRequest) Encode() []byte
  • func (r InfoRequest) Url() string
• type UpdateBudgetRequest
  • func (r UpdateBudgetRequest) Encode() []byte
  • func (r UpdateBudgetRequest) Url() string
• type WhiteListRequest
  • func (r WhiteListRequest) Encode() string
  • func (r WhiteListRequest) Url() string
• type WhiteListResponse

Types

type Balance

type Balance struct {
	// AccountID 广告主账户ID
	AccountID int64 `json:"accountId"`

	// CompanyName 广告主公司名称
	CompanyName string `json:"companyName"`

	// ProductName 产品名称
	ProductName string `json:"productName"`

	// CreateTime 账户创建时间
	// 注意：可以使用time.Time类型，需要处理时间格式解析
	CreateTime int64 `json:"createTime"`

	// TotalBalance 总余额(与代理商币种保持一致)
	TotalBalance int64 `json:"totalBalance"`

	// CashBalance 现金余额(与代理商币种保持一致)
	CashBalance int64 `json:"cashBalance"`

	// PreBalance 前返余额(与代理商币种保持一致)
	PreBalance int64 `json:"preBalance"`

	// AfterBalance 后返余额(与代理商币种保持一致)
	AfterBalance int64 `json:"afterBalance"`

	// ContractBalance 框返余额(与代理商币种保持一致)
	ContractBalance int64 `json:"contractBalance"`

	// DirectBalance 激励余额(与代理商币种保持一致)
	DirectBalance int64 `json:"directBalance"`

	// CreditBalance 信用余额(与代理商币种保持一致)
	CreditBalance int64 `json:"creditBalance"`
}

Balance 广告主余额信息

type BalanceGetRequest

type BalanceGetRequest struct {
	// AccountId 广告主ID
	AccountId uint64 `json:"accountId,omitempty"`
}

BalanceGetRequest 账户日余额查询APIRequest

func (BalanceGetRequest) Encode

func (r BalanceGetRequest) Encode() []byte

Encode implement PostRequest interface

func (BalanceGetRequest) Url

func (r BalanceGetRequest) Url() string

Url implement PostRequest interface

type Budget

type Budget struct {
	// DayBudget 单日预算 单位：厘
	DayBudget int64 `json:"day_budget,omitempty"`
	// DayBudgetSchedule  分日预算; 单位：厘，单日预算和分日预算同时存在时，以分日预算为准
	DayBudgetSchedule []int64 `json:"day_budget_schedule,omitempty"`
}

Budget 广告主预算

type BudgetGetRequest

type BudgetGetRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
}

BudgetGetRequest 账户日预算查询APIRequest

func (BudgetGetRequest) Encode

func (r BudgetGetRequest) Encode() []byte

Encode implement PostRequest interface

func (BudgetGetRequest) Url

func (r BudgetGetRequest) Url() string

Url implement PostRequest interface

type FundDailyFlow

type FundDailyFlow struct {
	// Date 日期
	Date string `json:"date,omitempty"`
	// DailyCharge 总花费
	DailyCharge float64 `json:"daily_charge,omitempty"`
	// RealCharged 充值花费;广告主的现金消耗和返点消耗，单位：元
	RealCharged float64 `json:"real_charged,omitempty"`
	// ContractRebateRealCharged 框返花费;年框广告主的框架返点的消耗，单位：元
	ContractRebateRealCharged float64 `json:"contract_rebate_real_charged,omitempty"`
	// DirectRebateRealCharged 激励花费;广告主激励账户中余额的消耗，单位：元
	DirectRebateRealCharged float64 `json:"direct_rebate_real_charged,omitempty"`
	// DailyTransferIn 转入
	DailyTransferIn float64 `json:"daily_transfer_in,omitempty"`
	// DailyTransferOut 转出
	DailyTransferOut float64 `json:"daily_transfer_out,omitempty"`
	// Balance 日终结余
	Balance float64 `json:"balance,omitempty"`
	// RealRecharged 充值转入
	RealRecharged float64 `json:"real_recharged,omitempty"`
	// ContractRebateRealRecharged 框返转入
	ContractRebateRealRecharged float64 `json:"contract_rebate_real_recharged,omitempty"`
	// DirectRebateRealRecharged 激励转入
	DirectRebateRealRecharged float64 `json:"direct_rebate_real_recharged,omitempty"`
	// OrderTotalCharged 订单总花费
	OrderTotalCharged float64 `json:"order_total_charged,omitempty"`
	// OrderRealCharged 订单充值花费
	OrderRealCharged float64 `json:"order_real_charged,omitempty"`
	// OrderContractCharged 订单框返花费
	OrderContractCharged float64 `json:"order_contract_charged,omitempty"`
	// OrderDirectCharged 订单激励花费
	OrderDirectCharged float64 `json:"order_direct_charged,omitempty"`
}

FundDailyFlow 广告主账号流水数据

type FundDailyFlowsRequest

type FundDailyFlowsRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// StartDate 开始日期
	StartDate string `json:"start_date,omitempty"`
	// EndDate 结束日期
	EndDate string `json:"end_date,omitempty"`
	// Page 查询的页码数
	Page int `json:"page,omitempty"`
	// PageSize 单页行数
	PageSize int `json:"page_size,omitempty"`
}

FundDailyFlowsRequest 广告主账号流水信息APIRequest

func (FundDailyFlowsRequest) Encode

func (r FundDailyFlowsRequest) Encode() []byte

Encode implement PostRequest interface

func (FundDailyFlowsRequest) Url

func (r FundDailyFlowsRequest) Url() string

Url implement PostRequest interface

type FundDailyFlowsResponse

type FundDailyFlowsResponse struct {
	TotalCount int             `json:"total_count,omitempty"`
	Details    []FundDailyFlow `json:"details,omitempty"`
}

FundDailyFlowsResponse 广告主账号流水信息APIResponse

type FundGetRequest

type FundGetRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
}

FundGetRequest 获取广告主账户余额APIRequest

func (FundGetRequest) Encode

func (r FundGetRequest) Encode() []byte

Encode implement PostRequest interface

func (FundGetRequest) Url

func (r FundGetRequest) Url() string

Url implement PostRequest interface

type FundGetResponse

type FundGetResponse struct {
	// Balance 账户总余额;单位：元
	Balance float64 `json:"balance,omitempty"`
}

FundGetResponse 获取广告主账户余额APIResponse

type Info

type Info struct {
	// UserID 账户快手ID
	UserID uint64 `json:"user_id,omitempty"`
	// CorporationName 公司名称
	CorporationName string `json:"corporation_name,omitempty"`
	// UserName 快手昵称
	UserName string `json:"user_name,omitempty"`
	// IndustryID 二级行业 id
	IndustryID uint64 `json:"industry_id,omitempty"`
	// IndustryName 二级行业名称
	IndustryName string `json:"industry_name,omitempty"`
	// PrimaryIndustryID 一级行业 id
	PrimaryIndustryID uint64 `json:"primary_industry_id,omitempty"`
	// PrimaryIndustryName 一级行业名称
	PrimaryIndustryName string `json:"primary_industry_name,omitempty"`
	// ProductName 产品名称
	ProductName string `json:"product_name,omitempty"`
}

Info 广告主信息

type InfoRequest

type InfoRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
}

InfoRequest 获取广告主信息APIRequest

func (InfoRequest) Encode

func (r InfoRequest) Encode() []byte

Encode implement PostRequest interface

func (InfoRequest) Url

func (r InfoRequest) Url() string

Url implement PostRequest interface

type UpdateBudgetRequest

type UpdateBudgetRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// DayBudget 单日预算 单位：厘，指定0表示预算不限，默认为0；每天不小于500元，不超过100000000元，仅支持输入数字；修改预算不得低于该账户当日花费的120%，与day_budget不能同时传
	DayBudget int64 `json:"day_budget,omitempty"`
	// DayBudgetSchedule  单日预算金额; 广告组单日预算金额，单位：厘，指定0表示预算不限，默认为0；不小于100元，不超过100000000元，仅支持输入数字；修改预算不得低于该广告组当日花费的120%
	DayBudgetSchedule int64 `json:"day_budget_schedule,omitempty"`
}

UpdateBudgetRequest 修改账户预算APIRequest

func (UpdateBudgetRequest) Encode

func (r UpdateBudgetRequest) Encode() []byte

Encode implement PostRequest interface

func (UpdateBudgetRequest) Url

func (r UpdateBudgetRequest) Url() string

Url implement PostRequest interface

type WhiteListRequest

type WhiteListRequest struct {
	// AdvertiserID 广告主id
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
}

WhiteListRequest 获取可选白名单接口 API Request

func (WhiteListRequest) Encode

func (r WhiteListRequest) Encode() string

Encode implement GetRequest interface

func (WhiteListRequest) Url

func (r WhiteListRequest) Url() string

Url implement GetRequest interface

type WhiteListResponse

type WhiteListResponse struct {
	// CreativeCategorySwitch 账户能否使用创意标签分类
	CreativeCategorySwitch int `json:"creative_category_switch,omitempty"`
	// ActionbarClickUrlSwitch 点击监测白名单，该用户是否在二跳白名单中，是否支持actionbar_click_url
	ActionbarClickUrlSwitch int `json:"actionbar_click_url_switch,omitempty"`
	// AdPhotoPlayedT3sUrlSwitch 曝光三秒白名单，此账户是否支持ad_photo_played_t3s_url
	AdPhotoPlayedT3sUrlSwitch int `json:"ad_photo_played_t3s_url_switch,omitempty"`
	// AlianceAccount 联盟投放白名单 如果广告主id在白名单里面，值为1，如果不在白名单里面，值为0
	AlianceAccount int `json:"aliance_account,omitempty"`
}

WhiteListResponse 获取可选白名单接口 API Response