Marketing API

Marketing API 概要 (Marketing API Overview)

Marketing APIは、Promoted Listings（広告）、Discounts Manager（割引マネージャー）、およびStore Email Campaigns（ストアメールキャンペーン）の3つのeBayマーケティング機能をサポートしています。これら3つのマーケティング機能を単独または組み合わせて使用することで、セラーの商品の閲覧数と売上を増やすことができます。

Promoted Listings は、セラーの広告キャンペーンに含まれる商品の露出を増やすeBayの広告サービスです。Promoted Listingsの詳細については、Promoted Listings Playbook を参照してください。

Discounts manager は、セラーが商品に対して価格割引を提供する機能を与える無料のサービスです。Discounts managerの詳細については、Selling Integration Guideの Discounts Manager セクションを参照してください。

Email Store Campaigns を使用すると、eBayストアセラーは、セラーのストアからニュースレターを受信するためにサインアップした登録者、フォロワー、および過去の顧客に対してメールキャンペーンを作成および送信できます。メールキャンペーンの詳細については、Selling Integration Guideの Store Email Campaigns セクションを参照してください。

注: Marketing API は、Trading API で作成された出品だけでなく、Inventory API で管理される出品とも連携します。

Promoted Listings

Promoted Listingsを使用すると、セラーは商品を宣伝するための広告キャンペーンを作成できます。Promoted Listingsキャンペーンには、3つの主要なキャンペーン戦略があります：

ジェネラルストラテジーキャンペーン（General strategy campaigns） は、売上課金（CPS: Cost Per Sale）資金調達モデルを使用します
プライオリティストラテジーキャンペーン（Priority strategy campaigns） は、クリック課金（CPC: Cost Per Click）資金調達モデルを使用します
Promoted Offsiteキャンペーン は、セラーが外部検索チャネルでeBay出品を宣伝できるようにします

Promoted Listingsキャンペーンタイプの詳細については、Promoted Listings Playbook を参照してください。

Promoted Listings 技術概要

ジェネラルおよびプライオリティストラテジーキャンペーンの両方に適用可能なリソースは以下の通りです：

ad – 既存のキャンペーン（CPS）または広告グループ（CPC）に、個別にまたは一括で出品を追加します。また、既存のキャンペーン広告のリストを取得することもできます。CPSモデルの場合、入札率を更新できます。CPCモデルの場合、このリソースを使用して広告を一時停止、再開、またはアーカイブできます。
campaign – このリソースのメソッドを使用してキャンペーンを作成および管理します。
ad_report – getReportメソッドを使用して、完了したPromoted Listingsレポートを取得します。
ad_report_metadata – さまざまなタイプのPromoted Listingsレポートに必要なフィールドとオプションのフィールドに関するメタデータを取得します。このメタデータは、レポートタスクの作成に役立ちます。
ad_report_task – Promoted Listingsレポートの生成を開始するレポートタスクを作成します。レポートタスクを削除するメソッドもあります。

マニュアルターゲティング・プライオリティストラテジーキャンペーンにのみ適用可能なリソースは以下の通りです：

ad_group – 広告グループは、CPC資金調達モデルを使用するキャンペーンに関連付けられています。キャンペーンごとに1つ以上の広告グループを追加できます。また、キャンペーン内の既存の広告グループのリストを取得し、このリソースを使用して広告グループを一時停止、再開、またはアーカイブすることもできます。
keyword – CPC資金調達モデルでは、プライオリティストラテジーキャンペーンの広告グループに使用するキーワードに入札できます。また、入札額とともに既存のキーワードのリストを取得し、このリソースを使用してキーワードを一時停止、再開、またはアーカイブすることもできます。
negative_keyword – CPC資金調達モデルでは、プライオリティストラテジーキャンペーンの広告グループに除外キーワード（negative keywords）を作成できます。除外キーワードは、バイヤーが出品に適用されないキーワード検索を実行したときに、プライオリティストラテジーキャンペーンが不必要に表示されるのを防ぐのに役立ちます。また、既存の除外キーワードのリストを取得したり、このリソースを使用して既存の除外キーワードのステータスを更新したりすることもできます。

Promoted Listings ユースケース

以下のユースケースは、セラーがPromoted Listingsを活用できる高レベルの方法の概要を示しています。

ジェネラルストラテジーキャンペーンの作成

ジェネラルストラテジーキャンペーンは、広告キャンペーンを設定および管理するためのシンプルで簡単な方法をセラーに提供します。ジェネラルキャンペーンは売上課金（Cost-Per-Sale）資金調達モデルを使用します。つまり、バイヤーがPromoted Listings広告をクリックし、30日以内に宣伝された商品を購入した場合にのみ、セラーに料金が請求されます。販売ごとに請求される金額は、キャンペーンの広告料率（商品の販売価格に対する割合）によって決定されます。

キャンペーンを作成するには、セラーは createCampaign メソッドを使用できます。キャンペーンをジェネラルキャンペーンとして指定するには、fundingModel フィールドを COST_PER_SALE に設定し、広告料率を bidPercentage フィールドで指定する必要があります。

ジェネラルキャンペーン戦略での出品の宣伝に関する詳細については、Promoted listings general strategy campaign creation flow を参照してください。

プライオリティストラテジーキャンペーンの作成

プライオリティストラテジーキャンペーンは、推奨入札額、キーワード、広告グループを通じて、セラーにキャンペーンの制御を強化する機能を提供します。プライオリティキャンペーンはクリック課金（Cost-Per-Click）資金調達モデルを使用します。つまり、バイヤーがPromoted Listings広告をクリックするたびにセラーに料金が請求されます。

キャンペーンを作成するには、セラーは createCampaign メソッドを使用できます。キャンペーンをプライオリティキャンペーンとして指定するには、fundingModel を COST_PER_CLICK に設定し、キャンペーンの日次予算を budget フィールドで設定する必要があります。

プライオリティキャンペーンには、マニュアルターゲティングとスマートターゲティングの2種類があります。それぞれの詳細は以下の通りです。

マニュアルターゲティングキャンペーンの作成

マニュアルターゲティングキャンペーンは、eBay全体に表示される広告のキャンペーン設定をセラーが制御できるようにし、キャンペーンのすべての側面を手動で作成および管理できるようにします。マニュアルターゲティングを使用すると、セラーは出品を広告グループに分類し、集中したキーワードでバイヤーをターゲットにして、出品の可視性を向上させることができます。

マニュアルターゲティングキャンペーンは、マニュアル設定またはクイック設定の2つの異なる方法で作成できます。

マニュアル設定では、createCampaign メソッドを通じて、セラーがキャンペーンの作成を完全に制御できます。セラーは、出品を広告グループに手動で追加し、キーワードを作成し、キーワード入札を設定して、出品が意図したオーディエンスに届くようにすることができます。マニュアルターゲティングキャンペーンを手動で作成するには、createCampaign プロセス中に campaignTargetingType 列挙型を MANUAL に設定します。キャンペーンが作成された後、セラーは createAdGroup や createKeyword などのMarketing APIのさまざまなメソッドを使用してキャンペーンを管理できます。

あるいは、セラーは setupQuickCampaign メソッドを使用して、プライオリティストラテジーキャンペーンの作成を迅速化できます。セラーは、キャンペーン名、期間、マーケットプレイス、日次予算額、関連する出品IDなどの基本的なキャンペーン情報を提供するだけで済みます。提供された出品IDを使用して、eBayはキャンペーン用の広告グループを作成し、出品を適切な広告グループに整理します。次に、eBayは各広告グループにキーワードを追加し、各キーワードに推奨入札額を割り当てます。セラーがキャンペーンの下書きを確認して承認したら、launchCampaign メソッドを使用してキャンペーンを開始（または開始をスケジュール）できます。

マニュアルターゲティングキャンペーンの詳細については、Manual targeting campaigns を参照してください。

スマートターゲティングキャンペーンの作成

スマートターゲティング広告キャンペーンは、キャンペーン設定を最適化するために時間の経過とともに自動的に更新されます。セラーは宣伝したい出品を選択でき、入札とターゲティングはeBayが行います。

セラーは、createCampaignメソッドを使用してスマートターゲティングを設定できます。これを行うには、campaignTargetType を SMART として渡す必要があり、広告のクリックごとに支払う意思のある最大額を bidPreferences コンテナの maxCpc フィールドで指定する必要があります。

注: スマートターゲティングはオンサイトキャンペーンでのみ利用可能です。

詳細については、Smart targeting campaigns を参照してください。

Promoted Offsiteキャンペーンの作成

Promoted Offsiteキャンペーンを使用すると、セラーは独自の広告キャンペーンを作成し、外部の検索チャネルでeBay出品を宣伝して、新しいバイヤーにリーチし、出品へのトラフィックを増やすことができます。

セラーは、createCampaign メソッドを使用してPromoted Offsiteキャンペーンを作成できます。これを行うには、fundingModel フィールドを COST_PER_CLICK として渡し、channels 配列を OFF_SITE として渡す必要があります。セラーは、Offsiteキャンペーンにのみ適用される suggestBudget メソッドを使用して、キャンペーンの推奨予算を取得することもできます。

オフサイトキャンペーンの作成と管理の詳細については、Promoted Offsite を参照してください。

注: Promoted Offsiteキャンペーンは、クリック課金（CPC）資金調達モデルを使用するキャンペーンでのみ利用可能です。Account API v1 の getAdvertisingEligibility メソッドを使用して、eBay広告プログラムへの適格性ステータスを確認してください。

Promoted Listingsキャンペーンのパフォーマンスに関するレポートを作成する

Promoted Listingsには、セラーにプロモーションのパフォーマンスに関するさまざまなビューを提供する5種類のレポートを作成できるレポートサービスが含まれています。詳細については、Promoted Listings reporting を参照してください。

Promoted Listingsの要件と制限

このセクションでは、Promoted Listingsキャンペーンに関連する要件と制限について詳しく説明します。

サポートされているマーケットプレイスとセラー要件

セラーがPromoted Listingsキャンペーンを作成する前に、eBayによって承認され、Promoted Listingsキャンペーンを作成したいマーケットプレイスの利用規約に同意する必要があります。

以下の表は、各Promoted Listingsキャンペーンタイプでサポートされているマーケットプレイスと、各マーケットプレイスの利用規約へのリンクを示しています：

Marketplace	Funding Model	Promoted Listings Terms and Conditions URL
Australia	CPS and CPC	Link
Canada (English)	CPS and CPC	Link
Canada (French)	CPS and CPC	Link
France	CPS and CPC	Link
Germany	CPS and CPC	Link
Italy	CPS and CPC	Link
Spain	CPS and CPC	Link
United Kingdom	CPS and CPC	Link
United States	CPS and CPC	Link

Promoted Listingsの出品要件

アイテムをPromoted Listingsキャンペーンに追加する前に、以下の出品要件を満たす必要があります：

ジェネラルストラテジーキャンペーンの場合、以下の出品形式がサポートされています：
- 固定価格 (Fixed price)
- オークション (Auction)
- 即決価格付きオークション (Auction Buy It Now)
プライオリティストラテジーキャンペーンの場合、固定価格出品のみがサポートされています。
アイテムはPromoted Listingsでサポートされているカテゴリに含まれている必要があります。以下のカテゴリはPromoted Listingsでサポートされていません：
- Wholesale & Job Lots
- Cars, Motorcycles & Vehicles
- Event Tickets
- Property
- E-Cigarettes, Vapes & Accs
- Everything Else

注: Sandboxには、Promoted Listingsサービスのエンドツーエンドテストを行うために必要なすべての機能が備わっているわけではありません。具体的には、SandboxでPromoted Listingsレポートを実行することはできません。

Discounts Manager (割引マネージャー)

Discounts Managerを使用すると、セラーは在庫内の商品に対してさまざまな種類の割引を設定できます。割引は指定された期間実行でき、特定の商品や、指定された商品基準によって選択された商品を含めることができます。割引には2種類あります：セラーが選択した一連の商品の価格を一時的に値下げするマークダウン（値下げ）割引（markdown discounts）と、バイヤーが特定のしきい値を満たしたときに割引がトリガーされるしきい値割引（threshold discounts）です。

注: 2024年7月8日現在、セラーハブおよびeBayヘルプページでは、プロモーション（promotions）は割引（discounts）と呼ばれるようになりました。Sell Marketing APIドキュメントはこの製品名の変更を反映して更新されましたが、APIインターフェースの変更は行われていないことに注意してください。

割引の詳細については、Selling Integration Guideの Discounts Manager セクションを参照してください。

Discounts Manager 技術概要

Discounts Managerには以下のリソースセットがあります：

item_price_markdown – このリソースのメソッドを使用して、直接価格割引およびパーセンテージ割引を作成および管理します。
item_promotion – このリソースのメソッドを使用して、しきい値によってトリガーされる割引を作成および管理します。また、このリソースを使用してボリュームプライシング割引を設定することもできます（バイヤーが複数の商品を購入すると、より高い割引が適用されます）。
promotion – Discounts Managerを通じて提供されたセラーの割引を取得します。このリソースを使用して割引を一時停止および再開することもできます。
promotion_report – 指定されたマーケットプレイスでのセラーの割引を詳述するレポートを取得します。
promotion_summary_report – 指定されたマーケットプレイスでのセラーの割引を要約するレポートを取得します。

Discounts Manager ユースケース

Discounts Managerの高レベルのユースケースは以下の通りです。

マークダウン割引の作成と管理

Marketing APIは、マークダウン割引の基本的な作成 (Create)、読み取り (Read)、更新 (Update)、削除 (Delete)、つまり CRUD 操作を提供します：

getItemPriceMarkdownPromotion で既存のマークダウン割引の詳細を取得します。
updateItemPriceMarkdownPromotion でアイテム割引の詳細を更新します。
deleteItemPriceMarkdownPromotion でアイテム割引を削除します。
getListingSet で特定のマークダウン割引に関連付けられた出品を取得します。

しきい値割引の作成と管理

item_promotion および promotion リソースのメソッドは、しきい値割引の基本的なCRUD操作を提供します：

createItemPromotion でアイテム割引を作成します。
getItemPromotion で既存のアイテム割引の詳細を取得します。
updateItemPromotion でアイテム割引の詳細を更新します。
deleteItemPromotion でアイテム割引を削除します。
getPromotions でセラーの現在の割引リストを取得します。
getListingSet で特定のアイテム割引に関連付けられた出品を取得します。

Discounts Managerレポートの作成

アイテム割引サービスは、セラーのアイテム割引について2種類のレポートを生成します：

Item Promotions Report（アイテムプロモーションレポート） – getPromotionReports を呼び出して、セラーの実行中、一時停止中、および終了した割引のリストを取得します。このレポートによって返されたレポートIDを使用して、完全なサマリーレポートを取得します。返されるレポートは、マーケットプレイスおよび割引の状態によってフィルタリングできます。
Summary Report（サマリーレポート） – getPromotionSummaryReport を呼び出して、マーケットプレイスごとのセラーの割引を要約したレポートを取得します。

サマリーレポートの解釈方法については、Reading Discounts Manager Summary Reports を参照してください。

Discounts Managerの要件と制限

Discounts Managerは、以下のeBayマーケットプレイスでサポートされています：

オーストラリア
フランス
ドイツ
イタリア
スペイン
イギリス
米国

Discounts Managerの出品要件

Discounts Managerの割引に追加する前に、アイテムは以下の出品要件を満たす必要があります：

出品は固定価格アイテム、または即決価格（Buy It Now）オプション付きのオークションである必要があります。オークションから即決価格オプションを削除すると、そのアイテムは割引できなくなります。
出品は、割引が実行されるのと同じマーケットプレイスのアクティブな出品である必要があります。たとえば、米国マーケットプレイス（EBAY_US）にアクティブに出品されている在庫に対して割引を作成した場合、eBayマーケットプレイスを持つ他の国への国際配送を提供していたとしても、その割引は他のマーケットプレイスには表示されません。明確にするために、米国マーケットプレイスに出品されているアイテムに対して割引を実行し、オーストラリアにも発送するとします。オーストラリア国内のバイヤー向けにアイテムを割引したい場合は、オーストラリアのサイト（ebay.com.au）に出品を作成し、その出品で割引を実行する必要があります。
出品は電子決済方法を提供する必要があります。

マークダウン割引の出品要件

さらに、マークダウン割引の場合、アイテムはセールの一部ではなく、同じ価格（アイテム価格と送料の合計）で一定日数出品されている必要があります。

以下の表は、アイテム価格のマークダウン割引の対象となるために、安定した価格で出品されている必要がある日数をリストしています：

Marketplace	Days Listed
Australia	10
France	30
Germany	30
Italy	30
Spain	30
United Kingdom	14

米国マーケットプレイスの場合、アイテムを出品するとすぐにマークダウン割引に追加できることに注意してください。

セラー要件

Discounts Managerを使用するには、セラーはアクティブなeBayストアサブスクリプションを持っている必要があります。

Store Email Campaigns (ストアメールキャンペーン)

メールマーケティングは、顧客にリーチし、リピートバイヤーのコミュニティを構築するための最も強力な方法の1つです。メールキャンペーンメソッドを使用すると、eBayストアセラーは、ストアからのニュースレターを受信するためにサインアップした登録者、フォロワー、および過去の顧客に対して、メールニュースレターキャンペーンを簡単に作成および送信できます。セラーはメールキャンペーンを使用して、顧客を歓迎したり、新しい出品、プロモーション、セール、割引について知らせたりすることができます。

メールキャンペーンの詳細については、Selling Integration Guideの Store Email Campaigns セクションを参照してください。

Store Email Campaigns 技術概要

Store Email Campaignsには以下のリソースがあります：

email_campaign

このリソースのメソッドにより、eBayストアセラーは、メールキャンペーンの作成、更新、削除、およびキャンペーンに関する情報の取得を行うことができます。

Store Email Campaigns ユースケース

Store Email Campaignsの高レベルのユースケースは以下の通りです。

ストアメールキャンペーンの作成と管理

セラーは、createEmailCampaign メソッドを使用して、6つの利用可能なメールキャンペーンタイプのいずれかを作成できます：新製品＆コレクション、クーポン、セールイベント+マークダウン、注文割引、およびボリュームプライシング。セラーはその後、getEmailPreview メソッドを使用してキャンペーンのプレビューを確認できます。

詳細については、Creating, updating, and deleting email campaigns を参照してください。

ストアメールキャンペーンのレポートを取得する

getEmailReport メソッドは、指定された期間のすべてのアクティブなメールキャンペーンのパフォーマンスデータを取得します。

詳細については、Email Campaign reports を参照してください。