分析およびレポート

分析およびレポートガイド

概要

eBay Sell Analytics APIおよびReporting APIは、セラーにビジネスパフォーマンスに関する洞察（インサイト）を提供し、売上、トラフィック、サービスパフォーマンスに関連する指標（メトリクス）を追跡できるようにします。これらのAPIは、主要なメトリクスを分析し、詳細なレポートをダウンロードできるようにすることで、セラーがデータに基づいた意思決定を行えるよう支援します。

APIのユースケース

  • セラー基準メトリクスのモニタリング
  • カスタマーサービスパフォーマンスの評価
  • バイヤーエンゲージメントに関する洞察の取得

セラー基準メトリクスのモニタリング

このユースケースは、eBayのセラー基準（Seller Standards）ポリシーに関連して、セラーのパフォーマンスデータを取得することに焦点を当てています。現在の売上実績や予測される売上実績のメトリクスにアクセスすることで、セラーはeBayの要件への準拠状況を評価し、改善すべき領域を特定できます。

Sell Analytics APIの seller_standards_profile リソースでは、以下のメソッドが利用可能です：

  • findSellerStandardsProfiles を使用すると、複数の販売メトリクスにわたるセラーの評価と統計を表示できます。3つの評価ランクは、Top Rated（トップレイテッド）、Above Standard（標準を上回る）、Below Standard（標準を下回る）です。セラー基準の評価とメトリクスは、eBay米国、eBay英国、eBayドイツのマーケットプレイスについて表示されます。セラーがこれらのマーケットプレイスの複数で販売している場合、それらのマーケットプレイスの累積メトリクスも表示されます。
  • getSellerStandardsProfile を使用すると、特定のeBayマーケットプレイスの評価とメトリクスを取得したり、グローバルな評価とメトリクスにアクセスしたりできます。ユーザーは、前回の評価期間における現在の評価とメトリクスを表示するか、現在の評価期間における予測される評価とメトリクスを表示するかを選択できます。

以下は、eBayがセラーのパフォーマンスを評価するために使用する標準メトリクスと評価プロセスの概要です：

  • 毎月評価される標準メトリクス:
    • Late shipment rate（発送遅延率）: 設定されたハンドリングタイム（発送までの日数）を過ぎて発送された取引の割合を測定します。
    • Cases closed without seller resolution（セラーによる解決なしに終了したケース）: セラーが解決策を提示せずに終了したケースの数を追跡します。
    • Transaction defect rate（取引不具合率）: キャンセルや返品など、不具合（ディフェクト）のある取引の割合を示します。
  • 毎年評価される標準メトリクス:
    • Transactions (12-month)（取引数 - 12ヶ月）: 過去12ヶ月間に完了した取引の総数。
    • Total sales (12-month)（総売上 - 12ヶ月）: 過去12ヶ月間の総売上高。
  • eBayでのセラー活動期間:
    • Number of days active on eBay（eBayでの活動日数）: セラーがこれまでにeBayで活動した合計日数を測定します。

セラーがTop RatedまたはAbove Standardの評価を受けるために必要なメトリクスの詳細については、eBayアカウントのeBayセラー基準プログラムページをご覧ください。

カスタマーサービスパフォーマンスの評価

このユースケースは、Item Not as Described（商品説明との相違）やItem Not Received（商品未着）のレポートやケースなど、カスタマーサービスメトリクスに関する詳細なレポートを取得・分析することに焦点を当てています。これらのメトリクスを理解することで、セラーは自身のパフォーマンスをベンチマークと比較し、改善すべき領域を特定できます。

getCustomerServiceMetric メソッドは、特定のカスタマーサービスメトリクスに関するセラーのパフォーマンスと評価を取得します。これは、指定された評価期間におけるItem Not as DescribedまたはItem Not Receivedのレポートやケースの総数に関する詳細な洞察を提供します。

レスポンスは追加のパラメータを使用して構成できます：

  • customer_service_metric_type: このパラメータは、セラーに対して返されるカスタマーサービスメトリクスとベンチマークデータのタイプを指定します。サポートされているタイプには、ITEM_NOT_AS_DESCRIBED および ITEM_NOT_RECEIVED があります。
  • evaluation_type: このパラメータは、パフォーマンスメトリクスの評価期間を決定します。サポートされている値の詳細については、EvaluationTypeEnum を参照してください。
  • evaluation_marketplace_id: このパラメータは、カスタマーサービスメトリクスとベンチマークデータを評価するマーケットプレイスIDを指定します。サポートされているマーケットプレイスのリストについては、Analytics APIの要件と制限を参照してください。

データはさまざまなディメンションとメトリクスにわたって整理されています：

  • Dimensions（ディメンション）:
    • Item Not as Described: レポートは出品カテゴリごとに分類され、セラーが製品関連の潜在的な問題を特定するのに役立ちます。
    • Item Not Received: レポートは国内および海外を含む配送地域ごとに分類され、セラーが物流上の課題に対処できるようにします。
  • 評価されるMetrics（メトリクス）:
    • Total reports/cases（総レポート/ケース数）: これは、特定の月における「Item Not as Described」や「Item Not Received」などの報告された問題の総数です。評価では、出品カテゴリや配送地域などの要素が考慮されます。
    • Peer benchmarking data（ピアベンチマークデータ）: これは、セラーのパフォーマンスを類似のカテゴリまたは地域のピアグループ（同等のセラー群）と比較するものです。「PEER_BENCHMARK」を使用して平均評価を提供し、セラーがマーケットプレイス内での立ち位置を理解するのに役立ちます。
    • Transaction count（取引数）: 「TRANSACTION_COUNT」とラベル付けされたこのメトリクスは、ピアグループまたはセラーによって完了された取引の数を示します。これは、カスタマーサービスメトリクスのために評価された取引の規模を把握するのに役立ちます。
    • Rate（率）: このメトリクスは、不具合ケースの数を総取引数（TRANSACTION_COUNT）で割ることによって不具合ケースの割合を計算します。セラーのパフォーマンスは、その率をベンチマーク平均と比較することで評価され、「LOW（低い）」から「VERY HIGH（非常に高い）」までの評価が付けられます。乖離が小さいほど、パフォーマンスが良いことを示します。

現在、メトリクスデータは主にピアベンチマークに使用されており、セラーは自分のパフォーマンスを同等のセラーと比較できます。ピアベンチマークの仕組みの詳細については、サービスメトリクスポリシーを参照してください。

このメソッドからのレスポンスを効果的に使用および解釈するには、カスタマーサービスメトリクス評価の解釈を参照してください。

バイヤーエンゲージメントに関する洞察の取得

このユースケースは、トラフィックデータを分析することで、出品に対するバイヤーのインタラクション（相互作用）を理解することに関するものです。セラーはこの情報を使用して、出品の可視性と販売パフォーマンスを最適化できます。

Sell Analytics APIの traffic_report リソースでは、以下のメソッドが利用可能です：

getTrafficReport を使用して、出品インプレッション、クリックスルー率（CTR）、販売転換率（コンバージョン率）など、eBay出品に関連するさまざまな統計を取得します。ユーザーは表示したい統計をカスタマイズできます。利用可能な統計の完全なリストについては、トラフィックレポートの詳細ページを参照してください。セラーは、すべての出品にわたる統計を取得するか、特定の出品に関する統計を取得するかを選択できます。

コードサンプル

米国セラーのセラー基準メトリクスの取得 

curl -X GET "https://api.ebay.com/sell/analytics/v1/seller_standards_profile/PROGRAM_US/CURRENT"
-H "Authorization:Bearer OAUTH_TOKEN"

米国マーケットプレイスのSNAD（商品説明との著しい相違）メトリクスの取得 

curl -X GET "https://api.ebay.com/sell/analytics/v1/customer_service_metric/ITEM_NOT_AS_DESCRIBED/CURRENT?evaluation_marketplace_id=EBAY_US"
-H "Authorization:Bearer OAUTH_TOKEN"

エラーハンドリング

  • findSellerStandardsProfiles でデータが返されない場合は、セラーが有効なアカウントを持っており、評価に十分な取引履歴があることを確認してください。
  • getSellerStandardsProfile 呼び出しでエラーが返された場合は、提供したセラープロファイルIDが有効であり、システム内に存在することを確認してください。さらに、ProgramEnum および CycleTypeEnum で定義されているサポートされた値を使用していることを確認してください。
  • getCustomerServiceMetric が失敗した場合は、指定された evaluation type および metric type が有効であること、およびマーケットプレイスがサポートされていることを確認してください。カスタマーサービスメトリクスをサポートしているeBayマーケットプレイスについては、要件と制限のリストを参照してください。
  • getTrafficReport が無効な日付範囲エラーを返す場合は、指定された日付範囲が90日以内であること、および開始日が過去2年以上遡っていないことを確認してください。
  • getTrafficReport を使用する場合は、サポートされているディメンション値のいずれか、および定義されている1つ以上のメトリクスを使用していることを確認してください。また、1つ以上のフィルタ値を使用する場合は、必要な構文に従っていることを確認してください。

ベストプラクティス

  • フィルタパラメータで日付範囲を指定する場合、America/Los_Angelesタイムゾーンでは YYYYMMDD..YYYYMMDD 形式を使用してください。その他のすべてのタイムゾーンについては、異なる地域間での明確さと一貫性を確保するために、UTCオフセット付きのISO 8601形式の日付を使用してください。
  • OAuthトークンが有効で、適切にフォーマットされており、無効なトークンやトークン欠落などの認証エラーを回避するために必要なスコープが含まれていることを確認してください。
  • メンテナンスやアプリケーションの問題などの内部サーバーエラーの場合は、少し待ってからリクエストを再試行してください。問題が解決しない場合は、eBay Developer Supportに報告してください。
  • 未解決のリソースや不正な形式のリクエストエラーを回避するために、すべてのリソースURIとリクエスト形式が正しいことを再確認してください。
トップに戻る