Recommendation API

Recommendation API 概要 (Recommendation API Overview)

Recommendation API は、セラーがPromoted Listings広告キャンペーンを設定するために使用できる情報を返します。

注: Recommendation APIは、売上課金（CPS）資金調達モデルを使用するジェネラルストラテジーキャンペーンにのみ適用されます。クリック課金（CPC）資金調達モデルを使用するプライオリティストラテジーキャンペーンには適用されません。

Recommendation APIには現在、単一の推奨タイプ AD があり、Promoted Listings 広告キャンペーンに関連する情報を返します。セラーは、返された推奨事項をキャンペーン設定のガイドラインとして使用できます。

eBayマーケットプレイスでは、可視性の向上がバイヤーのコンバージョン率と直接相関するため、AD 推奨タイプで返される情報は、どの出品を宣伝すべきか、および広告キャンペーンをどのように構成すべきかを知るのに役立ちます。

広告キャンペーンの作成と実行の詳細については、Selling Integration Guideの Promoted Listings を参照してください。

技術概要 (Technical overview)

Recommendation APIには現在、以下のリソースが含まれています：

  • listing_recommendation

このリソースには単一のメソッド findListingRecommendations があり、セラーが出品構成を最適化するのに役立つ情報を返します。

現在、findListingRecommendations は AD 推奨タイプをサポートしており、セラーがPromoted Listings広告キャンペーンを設定するために使用できる情報を返します。以下は、返される AD タイプの構造です： 

  "ad": {
    "promoteWithAd": "[RECOMMENDED, UNDETERMINED]",
    "bidPercentage": [
      {
        "value": "string",
        "basis": "Basis : TRENDING"
      }
    ]
  }

上記の返された情報を使用して、セラーは出品を広告キャンペーンに配置するかどうかを判断できます。さらに、bidPercentage 値は、キャンペーンに設定すべき入札率（広告料率とも呼ばれます）に関するガイダンスを提供します。

ビジネスユースケース (Business use cases)

Recommendation APIは、セラーのアクティブなアイテムに関連する情報を返します。以下のユースケースをサポートしています：

  • Promoted Listingsで改善できる可能性のあるセラーのすべての出品を取得する
  • 提供された出品IDセットのPromoted Listings情報を取得する
  • 現在のトレンド入札率を取得する

Promoted Listings広告キャンペーンで可視性を高めることができるアイテムを見つける

どのアイテムをPromoted Listings広告キャンペーンに含めることで最も利益が得られるかを知りたいセラーは、Recommendation APIを使用して、広告キャンペーンに配置することでeBayマーケットプレイスでの可視性が最も向上するセラーの出品のサブセットを返すことができます。

アイテムを宣伝することは可視性の向上に役立ちますが、広告キャンペーンに最適なアイテムもあります。Promoted Listingsに「推奨」される出品は、宣伝による潜在的な利益が最も高いものです。推奨事項は、バイヤーの需要やアイテムカテゴリ内の競争などのマーケットプレイスのトレンドに基づいています。

提供された出品IDセットの広告推奨事項を取得する

必要に応じて、Promoted Listings情報が必要な特定の出品IDセットを指定して findListingRecommendation を呼び出すことができます。リクエストごとに最大500個の個別の出品IDの情報をリクエストできます。IDは、セラーが現在 Active 状態で持っている出品を識別します。

特定の出品IDに関する情報をリクエストする場合、レスポンスには、eBayがPromoted Listingsキャンペーンに配置することを推奨するかどうかに関わらず、提供されたすべての出品IDに関する情報が含まれます。

トレンドレートに基づいて入札率を設定する

各出品IDの AD レスポンスには、トレンド入札率に関する情報が含まれています。これは、サブカテゴリレベルでの類似した宣伝アイテムの平均広告料率を示す値です。

いくつかの例外を除き、リクエストの構成方法に関わらず、レスポンスで返されるすべての出品IDに対して bidPercentage 値が返されます。

Recommendations APIの要件と制限 (Recommendations API requirements and restrictions)

Recommendation APIは現在、オーストラリア (EBAY_AU)、ドイツ (EBAY_DE)、イギリス (EBAY_GB)、および米国 (EBAY_US) のeBayマーケットプレイスでサポートされています。

トップに戻る