eBay大中华区API开发者平台 开发者专区

搜 索
Marketing API 概述 - Promoted Listing 相关 发布时间:2017-04-19

Marketing API 是给卖家和商家管理Promoted listings生命周期和物品推广的API。 本文的叙述包括以下几个方面。

* 技术概述

* 商业用例

* API 要求和限制

  

技术概述


以下列举了Marketing API涉及到的几个主要对象:     

*活动  (CAMPAIGN)

* 广告     Ads (the promoted listings)   

* 活动Id     Campaign Id                                  

* 站点Id      Marketplace Id (site where campaign is hosted)             

* 活动名称      Campaign Name                          

* 费用策略      Funding strategy (seller fee)         

* 起始及结束日期      Start and end dates                        

* 广告  (AD)  -  有3种方式生成

* 根据一组规则(品牌,品类,物品状况,高售价,低售价)从卖家的库存中选取刊登列表

* 卖家的库存刊登Id列表

* eBay 刊登ID 列表

*刊登ID    (LISTING ID )      

* 一个特定刊登的Id

* 一个多属性刊登的主刊登的ID, 比如说刊登为一件提供多种尺寸和颜色的T恤衫。

 

商业用例


这个部分列举出了Marketing API 支持的一些标准用例


创建基于规则的 Promoted listing 活动

你可以使用Create Campaign call来创建基于规则的Promoted listing 活动, 活动包括一个或多个campaignCriterion容器 (容器定义了一组挑选刊登的规则)。


你也可以使用Clone Campaign call重新创建已有的基于规则的活动。 一个活动如果终结了,就只能被克隆。


创建基于库存的Promoted listing 活动

你可以使用Create Campaign call 来创建基于库存的Promoted listing活动。 然后,使用其中一个广告的calls ( 比如说Create Ads in Bulk By Inventory Reference Id 或 Create Ads in Bulk By Listing Id ),  传入一组卖家的库存Ids或是eBay 刊登Ids来创建活动。


管理Promoted listing 活动的生命周期

Marketing API 有下面这些功能来帮助你管理Promoted listing 活动的完整的生命周期

* 创建,结束,暂停,恢复和删除活动

* 创建,暂停,恢复,删除活动

* 更新活动或促销的某个字段

* 根据名字,活动ID,或是刊登ID 检索特定活动

* 根据ID检索促销

* 根据刊登ID检索广告

* 检索所有的活动或促销


API 要求和限制


下面这个部分讲述创建promoted listing 活动的要求和限制。


Promoted Listings 支持 以下站点:

* eBay US (United States)

* US-Motors (non-fitment listings)

* UK (United Kingdom)

* DE (Germany)

* AU (Australia)


请注意: 沙盒环境暂不提供***的Promoted Listing 服务,因此无法在沙盒环境执行完整的从头到尾的测试。


Promoted Listings 对卖家要求:

* 卖家必须是有效的店铺订阅者

* 卖家必须接受相应站点的条款和条件:





Promoted Listings 对刊登的要求:

* 必须是固价商品

* 必须是多库存商品

* 必须是Promoted Listings支持的类目

* 不可以是地产或汽配类商品

成为eBay开发者

  • 大的电子商务技术平台
  • 丰富的编程接口和工具
  • 支持你所熟悉的开发语言
立即注册