export declare const PDD_AD_API_PLAN_CREATE = "pdd.ad.api.plan.create"; export declare const PDD_AD_API_PLAN_CREATE_LIMITERS: { limiterLevel: number; timeRange: number; times: number; callSourceType: number; }[]; /** * 接口名称:创建计划 * 接口标识:pdd.ad.api.plan.create * 接口使用场景:创建计划 **/ export interface PddAdApiPlanCreateRequestInterface { /** * @description: 计划创建信息 * @type: PddAdApiPlanCreateAdPlanCreateMessageRequestInterface * @default: * **/ adPlanCreateMessage: PddAdApiPlanCreateAdPlanCreateMessageRequestInterface; /** * @description: 单元创建信息列表 * @type: PddAdApiPlanCreateAdUnitCreateComplexMessageListRequestInterface[] * @default: * **/ adUnitCreateComplexMessageList?: PddAdApiPlanCreateAdUnitCreateComplexMessageListRequestInterface[]; /** * @description: 推广策略。1:自定义推广,3:展示ocpc智能推广。不传时表示自定义推广 * @type: number * @default: **/ planStrategy?: number; /** * @description: 场景类型。0表示搜索,2表示展示。 * @type: number * @default: **/ scenesType: number; } /** * @description 计划创建信息 * @default * @example **/ export interface PddAdApiPlanCreateAdPlanCreateMessageRequestInterface { /** * @description: 单日消耗 * @type: string | number * @default: **/ maxCost: string | number; /** * @description: 分时折扣 * @type: PddAdApiPlanCreateAdPlanCreateMessagePlanDiscountRequestInterface * @default: * **/ planDiscount?: PddAdApiPlanCreateAdPlanCreateMessagePlanDiscountRequestInterface; /** * @description: 计划名称 * @type: string * @default: **/ planName: string; } /** * @description 分时折扣 * @default * @example **/ export interface PddAdApiPlanCreateAdPlanCreateMessagePlanDiscountRequestInterface { /** * @description: 分时折扣配置 * @type: PddAdApiPlanCreateAdPlanCreateMessagePlanDiscountDiscountsRequestInterface[] * @default: * **/ discounts?: PddAdApiPlanCreateAdPlanCreateMessagePlanDiscountDiscountsRequestInterface[]; } /** * @description 分时折扣配置 * @default * @example **/ export interface PddAdApiPlanCreateAdPlanCreateMessagePlanDiscountDiscountsRequestInterface { /** * @description: 小时。0-23分别表示第1个小时到第24个小时。 * @type: number * @default: **/ index: number; /** * @description: 折扣比例。千分比(即rate等于1000表示比例100%)。 * @type: number * @default: **/ rate: number; } /** * @description 单元创建信息列表 * @default * @example **/ export interface PddAdApiPlanCreateAdUnitCreateComplexMessageListRequestInterface { /** * @description: 创意创建信息列表 * @type: PddAdApiPlanCreateAdUnitCreateComplexMessageListAdCreativeCreateMessagesListRequestInterface[] * @default: * **/ adCreativeCreateMessagesList?: PddAdApiPlanCreateAdUnitCreateComplexMessageListAdCreativeCreateMessagesListRequestInterface[]; /** * @description: 关键词创建列表 * @type: PddAdApiPlanCreateAdUnitCreateComplexMessageListAdKeywordCreateMessageListRequestInterface[] * @default: * **/ adKeywordCreateMessageList?: PddAdApiPlanCreateAdUnitCreateComplexMessageListAdKeywordCreateMessageListRequestInterface[]; /** * @description: 智能词包相关信息 * @type: PddAdApiPlanCreateAdUnitCreateComplexMessageListAdKeywordSetMessageRequestInterface * @default: * **/ adKeywordSetMessage?: PddAdApiPlanCreateAdUnitCreateComplexMessageListAdKeywordSetMessageRequestInterface; /** * @description: 商品创建信息 * @type: PddAdApiPlanCreateAdUnitCreateComplexMessageListAdProductCreateMessageRequestInterface * @default: * **/ adProductCreateMessage?: PddAdApiPlanCreateAdUnitCreateComplexMessageListAdProductCreateMessageRequestInterface; /** * @description: 单元创建信息 * @type: PddAdApiPlanCreateAdUnitCreateComplexMessageListAdUnitCreateMessageRequestInterface * @default: * **/ adUnitCreateMessage: PddAdApiPlanCreateAdUnitCreateComplexMessageListAdUnitCreateMessageRequestInterface; /** * @description: 人群定向创建信息列表 * @type: PddAdApiPlanCreateAdUnitCreateComplexMessageListAudienceBidCreateMessageListRequestInterface[] * @default: * **/ audienceBidCreateMessageList?: PddAdApiPlanCreateAdUnitCreateComplexMessageListAudienceBidCreateMessageListRequestInterface[]; /** * @description: 资源位定向创建信息列表。仅支持展示广告。 * @type: PddAdApiPlanCreateAdUnitCreateComplexMessageListLocationBidCreateMessageListRequestInterface[] * @default: * **/ locationBidCreateMessageList?: PddAdApiPlanCreateAdUnitCreateComplexMessageListLocationBidCreateMessageListRequestInterface[]; /** * @description: 智能创意创建信息 * @type: PddAdApiPlanCreateAdUnitCreateComplexMessageListSmartCreativeCreateMessageRequestInterface * @default: * **/ smartCreativeCreateMessage?: PddAdApiPlanCreateAdUnitCreateComplexMessageListSmartCreativeCreateMessageRequestInterface; } /** * @description 创意创建信息列表 * @default * @example **/ export interface PddAdApiPlanCreateAdUnitCreateComplexMessageListAdCreativeCreateMessagesListRequestInterface { /** * @description: 创意图片列表 * @type: PddAdApiPlanCreateAdUnitCreateComplexMessageListAdCreativeCreateMessagesListAdImageVOListRequestInterface[] * @default: * **/ adImageVOList?: PddAdApiPlanCreateAdUnitCreateComplexMessageListAdCreativeCreateMessagesListAdImageVOListRequestInterface[]; /** * @description: 创意标题列表 * @type: PddAdApiPlanCreateAdUnitCreateComplexMessageListAdCreativeCreateMessagesListAdTextVOListRequestInterface[] * @default: * **/ adTextVOList?: PddAdApiPlanCreateAdUnitCreateComplexMessageListAdCreativeCreateMessagesListAdTextVOListRequestInterface[]; /** * @description: 创意规格,6:商品轮播图,7:商品长图,其余规格暂不支持 * @type: string | number * @default: **/ creativeSpecificationId: string | number; } /** * @description 创意图片列表 * @default * @example **/ export interface PddAdApiPlanCreateAdUnitCreateComplexMessageListAdCreativeCreateMessagesListAdImageVOListRequestInterface { /** * @description: 图片链接,可用图片参考以下接口返回:pdd.ad.api.goods.query.gallery.images(轮播图),pdd.ad.api.goods.query.long.images(长图) * @type: string * @default: **/ imageUrl: string; } /** * @description 创意标题列表 * @default * @example **/ export interface PddAdApiPlanCreateAdUnitCreateComplexMessageListAdCreativeCreateMessagesListAdTextVOListRequestInterface { /** * @description: 标题 * @type: string * @default: **/ text: string; } /** * @description 关键词创建列表 * @default * @example **/ export interface PddAdApiPlanCreateAdUnitCreateComplexMessageListAdKeywordCreateMessageListRequestInterface { /** * @description: 关键词出价 * @type: string | number * @default: **/ bid: string | number; /** * @description: 关键词溢价比例。万分比 * @type: string | number * @default: **/ premiumRate?: string | number; /** * @description: 关键词 * @type: string * @default: **/ word: string; } /** * @description 智能词包相关信息 * @default * @example **/ export interface PddAdApiPlanCreateAdUnitCreateComplexMessageListAdKeywordSetMessageRequestInterface { /** * @description: 词包出价。出价需在[0.10, 99.00]之间。 * @type: string | number * @default: **/ keywordSetBid?: string | number; } /** * @description 商品创建信息 * @default * @example **/ export interface PddAdApiPlanCreateAdUnitCreateComplexMessageListAdProductCreateMessageRequestInterface { /** * @description: 商品Id * @type: string | number * @default: **/ goodsId?: string | number; } /** * @description 单元创建信息 * @default * @example **/ export interface PddAdApiPlanCreateAdUnitCreateComplexMessageListAdUnitCreateMessageRequestInterface { /** * @description: 推广单元名称 * @type: string * @default: **/ adName?: string; /** * @description: 基础出价。单位厘。 * @type: string | number * @default: **/ bid?: string | number; /** * @description: 智能优化广告相关。当单元使用自定义推广时,不要使用该字段。 * @type: PddAdApiPlanCreateAdUnitCreateComplexMessageListAdUnitCreateMessageOptimizationMessageRequestInterface * @default: * **/ optimizationMessage?: PddAdApiPlanCreateAdUnitCreateComplexMessageListAdUnitCreateMessageOptimizationMessageRequestInterface; } /** * @description 智能优化广告相关。当单元使用自定义推广时,不要使用该字段。 * @default * @example **/ export interface PddAdApiPlanCreateAdUnitCreateComplexMessageListAdUnitCreateMessageOptimizationMessageRequestInterface { /** * @description: 数据积累期出价。当使用OCPX时对该字段赋值。 * @type: string | number * @default: **/ accumulationBid?: string | number; /** * @description: 智能投放期出价。当使用OCPX时对该字段赋值。 * @type: string | number * @default: **/ optimizationBid?: string | number; /** * @description: 优化目标。0表示不优化。1表示优化ROI,2表示优化转化成本.自定义单元时,该值必传0;当单元使用展示自动调价功能(ECPC)时,该值必须传1;当单元使用展示OCPC功能(plan_strategy=3)时,该值必须传2。 * @type: number * @default: **/ optimizationGoal: number; /** * @description: 优化方式。0表示不优化,1表示ECPC,2表示OCPC。当单元使用ECPC时,该值必须传1;当使用OCPC时,该值必须传2。 * @type: number * @default: **/ optimizationMethod?: number; /** * @description: 可选优化出价列表。当使用OCPX时对该字段赋值。 * @type: PddAdApiPlanCreateAdUnitCreateComplexMessageListAdUnitCreateMessageOptimizationMessageOptionalOptimizationBidMessageListRequestInterface[] * @default: * **/ optionalOptimizationBidMessageList?: PddAdApiPlanCreateAdUnitCreateComplexMessageListAdUnitCreateMessageOptimizationMessageOptionalOptimizationBidMessageListRequestInterface[]; } /** * @description 可选优化出价列表。当使用OCPX时对该字段赋值。 * @default * @example **/ export interface PddAdApiPlanCreateAdUnitCreateComplexMessageListAdUnitCreateMessageOptimizationMessageOptionalOptimizationBidMessageListRequestInterface { /** * @description: 可选优化出价价格 * @type: string | number * @default: **/ optimizationBid: string | number; /** * @description: 可选优化出价目标。3表示优化店铺关注,4表示优化商品收藏,5表示优化询单 * @type: number * @default: **/ optimizationGoal: number; } /** * @description 人群定向创建信息列表 * @default * @example **/ export interface PddAdApiPlanCreateAdUnitCreateComplexMessageListAudienceBidCreateMessageListRequestInterface { /** * @description: 定向创建信息 * @type: PddAdApiPlanCreateAdUnitCreateComplexMessageListAudienceBidCreateMessageListAdTargetingCreateMessageRequestInterface * @default: * **/ adTargetingCreateMessage?: PddAdApiPlanCreateAdUnitCreateComplexMessageListAudienceBidCreateMessageListAdTargetingCreateMessageRequestInterface; /** * @description: 人群定向类型,可用枚举值,参考接口:pdd.ad.api.unit.bid.query.base.target.profile * @type: string | number * @default: **/ bidReferenceId: string | number; /** * @description: 出价,万分比 * @type: string | number * @default: **/ bidValue: string | number; /** * @description: 人群定向二级Id。默认为0。 * @type: string | number * @default: **/ subBidReferenceId: string | number; } /** * @description 定向创建信息 * @default * @example **/ export interface PddAdApiPlanCreateAdUnitCreateComplexMessageListAudienceBidCreateMessageListAdTargetingCreateMessageRequestInterface { /** * @description: 定向集合 * @type: PddAdApiPlanCreateAdUnitCreateComplexMessageListAudienceBidCreateMessageListAdTargetingCreateMessageAdTargetingSetRequestInterface * @default: * **/ adTargetingSet?: PddAdApiPlanCreateAdUnitCreateComplexMessageListAudienceBidCreateMessageListAdTargetingCreateMessageAdTargetingSetRequestInterface; /** * @description: 定向名称 * @type: string * @default: **/ targetingName?: string; } /** * @description 定向集合 * @default * @example **/ export interface PddAdApiPlanCreateAdUnitCreateComplexMessageListAudienceBidCreateMessageListAdTargetingCreateMessageAdTargetingSetRequestInterface { /** * @description: 地域定向 * @type: PddAdApiPlanCreateAdUnitCreateComplexMessageListAudienceBidCreateMessageListAdTargetingCreateMessageAdTargetingSetAreaStructRequestInterface * @default: * **/ areaStruct?: PddAdApiPlanCreateAdUnitCreateComplexMessageListAudienceBidCreateMessageListAdTargetingCreateMessageAdTargetingSetAreaStructRequestInterface; } /** * @description 地域定向 * @default * @example **/ export interface PddAdApiPlanCreateAdUnitCreateComplexMessageListAudienceBidCreateMessageListAdTargetingCreateMessageAdTargetingSetAreaStructRequestInterface { /** * @description: 地域Id列表。具体地域Id编码参见接口返回:pdd.ad.api.unit.bid.query.targeting.tag.list * @type: number[] * @default: **/ areaIds: number[]; } /** * @description 资源位定向创建信息列表。仅支持展示广告。 * @default * @example **/ export interface PddAdApiPlanCreateAdUnitCreateComplexMessageListLocationBidCreateMessageListRequestInterface { /** * @description: 资源位定向类型。可取值参考接口:pdd.ad.api.unit.bid.query.available.location * @type: string | number * @default: **/ bidReferenceId: string | number; /** * @description: 出价,万分比 * @type: string | number * @default: **/ bidValue: string | number; } /** * @description 智能创意创建信息 * @default * @example **/ export interface PddAdApiPlanCreateAdUnitCreateComplexMessageListSmartCreativeCreateMessageRequestInterface { /** * @description: 智能创意流量分配比例 * @type: number * @default: **/ creativeFlowRate?: number; /** * @description: 是否启用智能创意标识 * @type: number * @default: **/ enableSmartCreative?: number; /** * @description: 智能创意标题 * @type: string * @default: **/ smartCreativeTitle?: string; } /** * 接口名称:创建计划 * 接口标识:pdd.ad.api.plan.create * 接口使用场景:创建计划 **/ export interface PddAdApiPlanCreateResponseInterface { /** * @description: * @type: PddAdApiPlanCreateResponseResponseInterface * @default: * **/ response: PddAdApiPlanCreateResponseResponseInterface; } /** * @description * @default * @example **/ export interface PddAdApiPlanCreateResponseResponseInterface { /** * @description: * @type: number * @default: **/ errorCode: number; /** * @description: * @type: string * @default: **/ errorMsg: string; /** * @description: 计划Id * @type: string | number * @default: **/ result: string | number; /** * @description: * @type: boolean * @default: **/ success: boolean; }