getTrafficReport

• If you specify dimension=DAY and metric=CLICK_THROUGH_RATE, the traffic report contains the number of times an item displayed on a search results page and the buyer clicked through to the View Item page for each day in the date range, as in:
  12-06-17: 32, 12-07-17: 54, ...
• If you specify dimension=LISTING and metric=LISTING_IMPRESSION_STORE, the traffic report contains the number of times that listing appeared on the seller's store during the specified date range.
  
  For example, LISTING_IMPRESSION_STORE: 157 means the item appeared 157 times in the store during the date range.

Occurrence: Required

• CLICK_THROUGH_RATE
  The number of times an item displays on the search results page divided by the number of times buyers clicked through to its View Item page.
  Localized name: Click through rate
• LISTING_IMPRESSION_SEARCH_RESULTS_PAGE
  The number of times the seller's listings displayed on the search results page. Note, the listing might not have been visible to the buyer due to its position on the page.
  Localized name: Listing impressions from the search results page
• LISTING_IMPRESSION_STORE
  The number of times the seller's listings displayed on the seller's store. Note, the listing might not have been visible to the buyer due to its position on the page.
  Localized name: Listing impressions from your Store
• LISTING_IMPRESSION_TOTAL
  The total number of times the seller's listings displayed on the search results page OR in the seller's store. The item is counted each time it displays on either page. However, the listing might not have been visible to the buyer due to its position on the page.
  This is a combination of: LISTING_IMPRESSION_SEARCH_RESULTS_PAGE + LISTING_IMPRESSION_STORE.
  Localized name: Total listing impressions
• LISTING_VIEWS_SOURCE_DIRECT
  The number of times a View Item page was directly accessed, such as when a buyer navigates to the page using a bookmark.
  Localized name: Direct views
• LISTING_VIEWS_SOURCE_OFF_EBAY
  The number of times a View Item page was accessed via a site other than eBay, such as when a buyer clicks on a link to the listing from a search engine page.
  Localized name: Off eBay views
• LISTING_VIEWS_SOURCE_OTHER_EBAY
  The number of times a View Item page was accessed from an eBay page that is not either the search results page or the seller's store.
  Localized name: Views from non-search and non-store pages within eBay
• LISTING_VIEWS_SOURCE_SEARCH_RESULTS_PAGE
  The number of times the item displayed on the search results page.
  Localized name: Views on the search results page
• LISTING_VIEWS_SOURCE_STORE
  The number of times a View Item page was accessed via the seller's store.
  Localized name: Views from your Store
• LISTING_VIEWS_TOTAL
  Total number of listings viewed.
  This number sums:
  LISTING_VIEWS_SOURCE_DIRECT
  LISTING_VIEWS_SOURCE_OFF_EBAY
  LISTING_VIEWS_SOURCE_OTHER_EBAY
  LISTING_VIEWS_SOURCE_SEARCH_RESULTS_PAGE
  LISTING_VIEWS_SOURCE_STORE.
  Localized name: Total views
• SALES_CONVERSION_RATE
  The number of completed transactions divided by the number of View Item page views. Equals:
  TRANSACTION / LISTING_VIEWS_TOTAL
  Localized name: Sales conversion rate
• TRANSACTION
  The total number of completed transactions.
  Localized name: Transaction count

Occurrence: Required

• date_range
  Limits the report to the specified range of dates.
  
  Format the date range by enclosing the earliest date and end date for the report in brackets ("[ ]"), as follows:
  [YYYYMMDD..YYYYMMDD]
  
  The maximum range between the start and end dates is 90 days, and the earliest start date you can specify is two years prior to the current date, which is defined as 730 days (365 * 2), not accounting for Leap Year.
  
  The last date for which traffic data exists is a value called lastUpdatedDate. eBay returns an error if you specify a date range greater than 90 days, or the start date is after the lastUpdatedDate. If the specified end date is beyond the lastUpdatedDate, eBay returns data up to the lastUpdatedDate.
  
  Required: Always
• listing_ids
  This filter limits the results to only the supplied list of listingId values.
  
  You can specify to 200 different listingId values. Enclose the list of IDs with curly braces ("{ }"), and separate multiple values with a pipe character ("|").
  
  This filter only returns data for listings that have been either active or sold in last 90 days, and any unsold listings in the last 30 days. All listings must be the seller's and they must be listed on the marketplace specified by the marketplace_ids filter argument.
• marketplace_ids
  This filter limits the report to seller data related to only the specified marketplace ID (currently the filter allows only a single marketplace ID). Enclose the marketplace ID in curly braces ("{ }").
  
  Valid values:
  • EBAY_AU
  • EBAY_DE
  • EBAY_GB
  • EBAY_US
  • EBAY_MOTORS
  
  Required if you set the dimension parameter to DAY.

filter=marketplace_ids:{EBAY_US},date_range:[20170601..20170828]

Note: You must URL encode all the values you supply in the filter parameter, as described in URL parameters.

Occurrence: Required

Occurrence: Optional