eBayで販売分析をする方法 (NEW API)

ECサイトを運営して売上を向上させていくには、来訪者数、表示回数、コンバージョンレートなどの分析は欠かせません。eBayではセラー様向けに販売分析が行えるAPIを用意しています。

その使用方法を紹介します。

 

Analytics APIのgetTrafficReportコールを使って、各種データを取得します。

APIのコールの方法は以下になります。

 

GET https://api.ebay.com/sell/analytics/v1/traffic_report?
dimension=string&
metric=string&
filter=FilterField&
sort=SortField

 

各パラメータの内容は以下となります。

dimension

  • DAY:日毎の集計
  • LISTING :商品毎の集計

filter

  • date_range:表示期間
  • listing_ids :商品IDのリスト※例:[12323232|12321313] 最大200
  • marketplace_ids :販売する国
     

sort

  • ソートに指定したいmetric values

metric

  • CLICK_THROUGH_RATE :クリック率
  • LISTING_IMPRESSION_SEARCH_RESULTS_PAGE :検索結果からのインプレッション
  • LISTING_IMPRESSION_STORE :ストアからのインプレッション
  • LISTING_IMPRESSION_TOTAL :検索結果からのトータルインプレッション
  • LISTING_VIEWS_SOURCE_DIRECT :直接表示回数
  • LISTING_VIEWS_SOURCE_OFF_EBAY :外部サイトから売り手のリスティングが閲覧された回数
  • LISTING_VIEWS_SOURCE_OTHER_EBAY :eBay内の非検索ページおよび非ストアページからの表示回数
  • LISTING_VIEWS_SOURCE_SEARCH_RESULTS_PAGE :検索回数
  • LISTING_VIEWS_SOURCE_STORE :ストアからの表示回数
  • LISTING_VIEWS_TOTAL :合計表示回数
  • SALES_CONVERSION_RATE :CV率[%]
  • TRANSACTION :注文回数

※出力したい値をmetricに指定してリクエストします。

 

[リクエストURL例]

https://api.ebay.com/sell/analytics/v1/traffic_report?dimension=DAY&filter=marketplace_ids:{EBAY_US},date_range:[20180301..20180331]
&metric=LISTING_IMPRESSION_SEARCH_RESULTS_PAGE,LISTING_IMPRESSION_STORE,SALES_CONVERSION_RATE

 

レスポンスは下記のように取得されます。(※HTMLのTABLEタグでレスポンスが応答されます。)

<table>
	<tr>
		<th></th>
		<th>検索回数</th>
		<th>クリック回数</th>
		<th>CV率[%]</th>
	</tr>
	<tr>
		<th>2018/03/02</th>
		<td>1</td>
		<td>0</td>
		<td></td>
	</tr>
	<tr>
		<th>2018/03/04</th>
		<td>3</td>
		<td>0</td>
		<td></td>
	</tr>
	<tr>
		<th>2018/03/05</th>
		<td>3</td>
		<td>0</td>
		<td></td>
	</tr>
	<tr>
		<th>2018/03/07</th>
		<td>5</td><td>0</td>
		<td></td>
	</tr>
	<tr>
		<th>2018/03/09</th>
		<td>2</td>
		<td>0</td>
		<td></td>
	</tr>
	<tr>
		<th>2018/03/10</th>
		<td>1</td>
		<td>0</td>
		<td></td>
	</tr>
	<tr>
		<th>2018/03/11</th>
		<td>1</td>
		<td>0</td>
		<td></td>
	</tr>
	<tr>
		<th>2018/03/12</th>
		<td>2</td>
		<td>0</td>
		<td></td>
	</tr>
	<tr>
		<th>2018/03/13</th>
		<td>2</td>
		<td>0</td>
		<td></td>
	</tr>
	<tr>
		<th>2018/03/14</th>
		<td>1</td>
		<td>0</td>
		<td></td>
	</tr>
	<tr>
		<th>2018/03/15</th>
		<td>6</td>
		<td>0</td>
		<td></td>
	</tr>
	<tr>
		<th>2018/03/16</th>
		<td>2</td>
		<td>0</td>
		<td></td>
	</tr>
	<tr>
		<th>2018/03/17</th>
		<td>2</td>
		<td>0</td>
		<td>0</td>
	</tr>
	<tr>
		<th>2018/03/18</th>
		<td>1</td>
		<td>0</td>
		<td></td>
	</tr>
	<tr>
		<th>2018/03/19</th>
		<td>2</td>
		<td>0</td>
		<td></td>
	</tr>
	<tr>
		<th>2018/03/20</th>
		<td>1</td>
		<td>0</td>
		<td></td>
	</tr>
	<tr>
		<th>2018/03/22</th>
		<td>2</td>
		<td>0</td>
		<td></td>
	</tr>
	<tr>
		<th>2018/03/23</th>
		<td>1</td>
		<td>0</td>
		<td></td>
	</tr>
	<tr>
		<th>2018/03/24</th>
		<td>1</td>
		<td>0</td>
		<td></td>
	</tr>
	<tr>
		<th>2018/03/26</th>
		<td>2</td>
		<td>0</td>
		<td></td>
	</tr>
	<tr>
		<th>2018/03/27</th>
		<td>1</td>
		<td>0</td>
		<td></td>
	</tr>
	<tr>
		<th>2018/03/28</th>
		<td>2</td>
		<td>0</td>
		<td></td>
	</tr>
	<tr>
		<th>2018/03/29</th>
		<td>5</td>
		<td>0</td>
		<td></td>
	</tr>
	<tr>
		<th>2018/03/30</th>
		<td>4</td>
		<td>0</td>
		<td></td>
	</tr>
	<tr>
		<th>2018/03/31</th>
		<td>3</td>
		<td>0</td>
		<td></td>
	</tr>
</table>

 

詳しくはAPI下記のAPI Referenceを確認してください。

https://developer.ebay.com/api-docs/sell/analytics/overview.html