マーケティングおよびプロモーション

マーケティングおよびプロモーションガイド

概要

Sell Marketing APIを使用すると、セラーはeBay出品のマーケティング活動を管理および最適化し、商品の露出を増やすことができます。セラーはこのAPIメソッドを使用して、Promoted Listings（広告）キャンペーンの作成、割引プロモーションの作成、およびメールキャンペーンの作成と送信を行うことができます。

APIのユースケース

  • Promoted Listings ジェネラルストラテジーキャンペーンの作成と管理
  • Promoted Listings プライオリティストラテジーキャンペーンの作成と管理
  • Promoted Offsite キャンペーンの作成と管理
  • Promoted Listings および Promoted Offsite レポートの作成と取得
  • 割引（Discounts）の作成と管理
  • 割引レポートの作成と取得
  • ストアメールキャンペーンの作成と管理

Promoted Listings ジェネラルストラテジーキャンペーンの作成と管理

ジェネラルストラテジー（General Strategy）キャンペーンは、売上課金（CPS: Cost Per Sale）モデルを使用し、eBayの Recommendation API を活用して、Promoted Listingsキャンペーンの効果が見込まれる出品や、プロモーション対象の出品に対するトレンドの入札率に関する推奨事項（レコメンデーション）を取得します。

ジェネラルストラテジーキャンペーンを作成するには主に2つの方法があり、それぞれキャンペーンに出品を追加する方法が異なります：キーベース（key-based）キャンペーンとルールベース（rules-based）キャンペーンです。キーベースキャンペーンでは、セラーがキャンペーンに出品を手動で追加できますが、ルールベースキャンペーンでは、特定のブランドなど、事前に定義された一連の出品基準に基づいてキャンペーンに追加する出品が選択されます。

Sell Marketing APIを使用してPromoted Listingsジェネラルストラテジーキャンペーンを作成および管理する方法については、以下で説明します。

Promoted Listings General Strategy Flow
  1. createCampaign を使用してPromoted Listingsキャンペーンの構造を作成・設定し、以下の必須フィールドを構成します。
    • marketplaceId
    • campaignName
    • startDate
  2. 以下の fundingStrategy フィールドを構成して、ジェネラルストラテジーキャンペーンの資金設定（Funding Strategy）を行います。
    • [必須] bidPercentage
    • [必須] fundingModel （COST_PER_SALE に設定）
    • [オプション] adRateStrategy
  3. ルールベースまたはキーベースのキャンペーンを作成します。
    • キーベースキャンペーンを作成するには、以下のいずれかの方法を使用して、既存のキャンペーンに1つ以上のアクティブな出品を手動で追加します。これら4つの方法のいずれでも、キャンペーンIDはパスパラメータとして渡されます。
      注意: Recommendation APIの findListingRecommendations メソッドを使用すると、Promoted Listingsキャンペーンで最もパフォーマンスが高い出品の推奨や、それらの出品に対する推奨入札率を取得できます。
      • bulkCreateAdsByListingId または createAdsByListingId を使用し、Trading APIまたはInventory APIによって生成された出品の一意の識別子（Listing ID）を使って、Promoted Listingsキャンペーンに1つ以上の出品を追加します。
      • bulkCreateAdsByInventoryReference または createAdsByInventoryReference を使用し、Inventory APIで生成された単一商品またはマルチバリエーション出品の一意の識別子を使って、Promoted Listingsキャンペーンに1つ以上の出品を追加します。
    • ルールベースキャンペーンを作成するには、以下にリストされている selectionRules 基準の1つ以上を指定します。指定されたすべての基準を満たす出品がキャンペーンに追加されます。
      注意: autoSelectFutureInventory ブール値を含め、true に設定することで、基準に一致する将来の出品も自動的にキャンペーンに追加されるように設定できます。
      • brands: ブランド名の配列をここで指定します。いずれかのブランド名の製品を含む出品がキャンペーンへの追加対象となります。
      • categoryIds: eBayリーフカテゴリIDまたはeBayストアカテゴリIDの配列をここで指定します。これらのeBayまたはeBayストアカテゴリのいずれかに含まれる出品がキャンペーンへの追加対象となります。
      • listingConditionIds: eBayアイテムコンディションIDの配列をここで指定します。これらのアイテムコンディションのいずれかを使用する出品がキャンペーンへの追加対象となります。
      • maxPrice および/または minPrice: minPrice（最低価格）および/または maxPrice（最高価格）のしきい値を基準として追加できます。商品の販売価格がこれらのしきい値の範囲内である場合、キャンペーンへの追加対象となります。

ジェネラルストラテジーキャンペーンの管理に適用可能なその他のメソッドは以下の通りです。

  • cloneCampaign を使用して、既存のルールベースキャンペーンで指定されたキャンペーン基準（Criterion）を使用して新しいキャンペーンを作成します。
  • updateAdRateStrategy を使用して、既存のルールベースキャンペーンの広告料率（Ad Rate）戦略を更新します。
  • findCampaignByAdReference を使用して、出品の listingId またはセラー定義の SKU もしくは inventoryItemGroupKey 値を指定し、特定の出品を含むキャンペーンを取得します。
  • updateBid を使用して、ジェネラルストラテジーキャンペーン内の指定された広告の入札率（広告料率）を更新します。
  • deleteAd または deleteAdsByInventoryReference を使用して、指定されたキャンペーンから広告を削除します。
  • getCampaign、getCampaigns、getCampaignByName、または findCampaignByAdReference を使用して、1つ以上のPromoted Listings広告キャンペーンの詳細を取得します。
  • deleteCampaign を使用して、特定のPromoted Listingsキャンペーンを削除します。
  • pauseCampaign を使用してアクティブなキャンペーンを一時停止し、resumeCampaign を使用して一時停止中のキャンペーンを再開します。
  • endCampaign を使用して、実行中のPromoted Listingsキャンペーンを終了します。

Promoted Listings プライオリティストラテジーキャンペーンの作成と管理

プライオリティストラテジー（Priority Strategy）キャンペーンは、クリック課金（CPC: Cost-Per-Click）モデルを使用し、eBay Marketing APIを活用してキャンペーン用の出品、キーワード、入札の提案を取得します。

プライオリティストラテジーキャンペーンを作成するには主に2つの方法があり、それぞれキャンペーンの設定方法が異なります：マニュアルターゲティングキャンペーンとスマートターゲティングキャンペーンです。マニュアルターゲティングキャンペーンでは、セラーがキャンペーンの設定と最適化を完全にコントロールできますが、スマートターゲティングキャンペーンでは、セットアップが簡単で、自動的にキャンペーンが最適化されます。

Sell Marketing APIを使用してPromoted Listingsプライオリティストラテジーキャンペーンを作成および管理する方法については、以下で説明します。

マニュアルターゲティングキャンペーン（手動設定）

手動設定によるマニュアルターゲティングキャンペーンでは、セラーがキャンペーンに関連する出品、キーワード、キーワード入札を完全にコントロールできます。

Manual Setup Flow
  1. createCampaign を使用してマニュアルターゲティングキャンペーンの構造を作成・設定し、以下の必須フィールドを構成します。
    • marketplaceId
    • campaignName
    • Budget
    • fundingStrategy.fundingModel （COST_PER_CLICK に設定）
    • startDate
  2. オプションとして、suggestItems を使用して、CPC Promoted Listingsキャンペーンに対するeBayの推奨出品を取得します。
  3. createAdGroup を使用してキャンペーンの広告グループを作成し、広告グループの defaultBid 値を指定します。
  4. bulkCreateAdsByListingId または createAdsByListingId を使用して、広告グループに出品を追加します。
  5. オプションとして、suggestKeywords を使用して広告グループとその出品に対するキーワードの推奨を取得し、suggestBids を使用して指定されたキーワードに対して推奨される入札額を確認します。
  6. bulkCreateKeyword または createKeyword を使用して広告グループにキーワードを追加し、オプションとして bulkCreateNegativeKeyword または createNegativeKeyword を使用して除外キーワード（Negative Keywords）を広告グループに追加します。
マニュアルターゲティングキャンペーン（クイックセットアップ）

クイックセットアップキャンペーンを使用すると、セラーはキャンペーンの作成を迅速に行うことができます。基本的な情報を提供するだけで、残りはeBayが処理します。

Quick Setup Flow
  1. setupQuickCampaign を使用して、Promoted Listingsプライオリティキャンペーンの作成を迅速化します。このキャンペーンはドラフト（下書き）ステータスで保存されます。
  2. setupQuickCampaign のLocationヘッダーで返された campaignId 値を参照し、launchCampaign を使用してキャンペーンを開始します。
スマートターゲティングキャンペーン
Smart Targeting Flow
  1. オプションとして、suggestMaxCpc を使用して、指定された出品とマーケットプレイスに基づいて、スマートターゲティングキャンペーンの推奨最大クリック単価（maxCpc）値を取得します。
  2. createCampaign を使用してスマートターゲティングキャンペーンの構造を作成・設定し、以下の必須フィールドを構成します。
    • marketplaceId
    • campaignName
    • fundingStrategy.fundingModel （COST_PER_CLICK に設定）
    • fundingStrategy.bidPreferences.maxCpc
    • campaignTargetingType （SMART に設定）
    • startDate
  3. createAdByListingId または bulkCreateAdsByListingId を使用して、キャンペーンに出品を追加します。

プライオリティストラテジーキャンペーンの管理に適用可能なその他のメソッドは以下の通りです。

  • updateBiddingStrategy を使用して、マニュアルターゲティングCPCキャンペーンの入札戦略を Fixed（固定）から Dynamic（動的）、またはその逆に変更します。さらに、このメソッドを使用してスマートターゲティングキャンペーンの maxCPC 値を更新することもできます。
  • updateCampaignBudget を使用して、プライオリティストラテジーキャンペーンの日次予算を変更します。
  • getCampaign、getCampaigns、getCampaignByName、または findCampaignByAdReference を使用して、1つ以上のPromoted Listings広告キャンペーンの詳細を取得します。
  • deleteCampaign を使用して、特定のPromoted Listingsキャンペーンを削除します。
  • pauseCampaign を使用してアクティブなキャンペーンを一時停止し、resumeCampaign を使用して一時停止中のキャンペーンを再開します。
  • endCampaign を使用して、実行中のPromoted Listingsキャンペーンを終了します。
  • bulkUpdateAdsStatus を使用して、広告のステータスを一括更新します。
  • updateKeyword および bulkUpdateKeyword を使用して、キーワードの入札とステータスを更新します。
  • updateNegativeKeyword および bulkUpdateNegativeKeywords を使用して、除外キーワードの入札とステータスを更新します。

Promoted Offsite キャンペーンの作成と管理

Promoted Offsiteキャンペーンを利用すると、セラーは外部チャネルで出品を宣伝し、関心のあるバイヤーへの露出を増やすことで、より幅広い潜在的なバイヤー層にリーチできるようになります。

Sell Marketing API を使用してPromoted Offsiteキャンペーンを作成および管理する方法については、以下で説明します。

Offsite Campaign Flow
  1. オプションとして、suggestBudget を使用して、Promoted Offsiteキャンペーンの推奨予算を取得します。
  2. createCampaign を使用してPromoted Offsiteキャンペーンの構造を作成・設定し、以下の必須フィールドを構成します。
    • marketplaceId
    • campaignName
    • fundingModel （COST_PER_CLICK に設定）
    • channels （OFF_SITE に設定）
    • startDate

Promoted Offsiteキャンペーンの管理に適用可能なその他のメソッドは以下の通りです。

  • getCampaign、getCampaigns、getCampaignByName、または findCampaignByAdReference を使用して、1つ以上のPromoted Listings広告キャンペーンの詳細を取得します。
  • deleteCampaign を使用して、特定のPromoted Listingsキャンペーンを削除します。
  • pauseCampaign を使用してアクティブなキャンペーンを一時停止し、resumeCampaign を使用して一時停止中のキャンペーンを再開します。
  • endCampaign を使用して、実行中のPromoted Listingsキャンペーンを終了します。

Promoted Listings および Promoted Offsite レポートの作成と取得

Marketing APIは、セラーがPromoted ListingsキャンペーンおよびPromoted Offsiteキャンペーンのパフォーマンスに関するレポートを作成および取得する機能を提供します。キャンペーン内の各出品のパフォーマンスを日次で確認できる出品レポート（listing reports）や、特定のキャンペーンのキーワードパフォーマンスデータを提供するキーワードレポート（keyword reports）など、さまざまなレポートタイプが利用可能です。サポートされているPromoted Listingsレポートタイプの完全なリストについては、ReportTypeEnum を参照してください。

Sell Marketing API メソッドを使用してPromoted ListingsおよびPromoted Offsiteレポートを取得する方法については、以下で説明します。

Reports Flow
  1. getReportMetadata を使用して各Promoted Listingsレポートタイプに必要なフィールドを取得するか、getReportMetadataForReportType を使用して特定のレポートタイプに必要なフィールドを取得します。
  2. createReportTask を使用して、1つ以上のキャンペーンのPromoted Listingsレポートを作成します。reportType フィールドで作成するレポートのタイプを指定し、指定されたタイプに基づいて他の必須フィールドも指定します。
  3. getReportTasks または getReportTask を使用して、Promoted Listingsレポートのステータスを確認します。レポートの生成には時間がかかる場合があり、ステータスが SUCCESS になるまでダウンロードできません。
  4. getReport を使用して、Promoted Listingsレポートをダウンロードします。

割引（Discounts）の作成と管理

割引マネージャー（Discounts Manager）を使用すると、セラーは商品の通常販売価格に対して価格割引を提供できます。

主な割引タイプには、マークダウン（値下げ）割引（markdown discounts）としきい値割引（threshold discounts）の2種類があります。マークダウン割引は、出品価格から金額またはパーセンテージで直接値引きするもので、しきい値割引は、バイヤーが設定されたしきい値（例：x額以上購入するなど）を満たした場合に割引が適用されるものです。

Sell Marketing API メソッドを使用して割引を作成および管理する方法については、以下で説明します。

アイテムのマークダウン割引
Item Markdown Flow
  1. createItemPriceMarkdownPromotion を使用してマークダウン割引を作成し、以下の必須フィールドを構成します。
    • marketplaceId: 割引が実施されるサイトの一意の識別子。
    • discountBenefit: 販売価格に適用される割引額または割引率。
    • startDate および endDate: 割引の開始日と終了日。
  2. ルールベースまたはキーベースのいずれかの割引を使用して、割引に含めるアイテムを指定します。
    • キーベースの割引を作成するには、inventoryCriterionType を INVENTORY_BY_VALUE に設定し、以下のいずれかの配列を使用して割引に含めるアイテムを指定します。
      • listingIds: Trading APIまたはInventory APIによって生成された出品の一意の識別子を使用して、割引したい出品を指定します。
      • inventoryItems: Inventory APIで生成された単一商品またはマルチバリエーション出品の一意の識別子を使用して、割引したいアイテムを指定します。
    • ルールベースの割引を作成するには、inventoryCriterionType を INVENTORY_BY_RULE に設定し、以下にリストされている selectionRules 基準の1つ以上を指定します。指定されたすべての基準を満たす出品がキャンペーンに追加されます。
      • brand
      • categoryIds
      • categoryScope
      • listingConditionIds
      • maxPrice
      • minPrice
しきい値割引
Threshold Discount Flow
  1. createItemPromotion を使用してしきい値割引を作成し、以下の必須フィールドを構成します。
    • marketplaceId: 割引が実施されるサイトの一意の識別子。
    • discountBenefit: 販売価格に適用される割引額または割引率。
    • startDate および endDate: 割引の開始日と終了日。
  2. promotionType フィールドを通じてしきい値割引のタイプを指定します。このメソッドを使用して作成できる割引の種類は以下の通りです。
    • Coded Coupon（クーポンコード）: セラーは、バイヤーがチェックアウト時に使用して割引を受けることができる独自のクーポンコードを提供します。
    • Order Discount（注文割引）: セラーは、注文サイズまたはバイヤーが支払った金額に基づいて注文割引を提供します。
    • Volume Discount（ボリュームディスカウント）: セラーは、単一の商品を複数個購入するバイヤーに対して段階的な割引を提供します。
    • Markdown Discount（マークダウン割引）: 対象商品に割引額が直接適用されます。
  3. 指定されたプロモーションタイプに必要なフィールドを入力します。例えば、Coded Couponプロモーションには couponConfiguration コンテナが必要です。各プロモーションタイプに必要なフィールドについては、リファレンスドキュメントを参照してください。
  4. discountSpecifications フィールドを構成して、しきい値割引のルールを指定します。このフィールドは、割引が適用される条件を決定する一連のルールを定義します。以下のルールを設定できます。
    • minAmount: 割引の対象となるために、対象商品に対して支払う必要がある最低金額。
    • minQuantity: 割引の対象となるために、購入する必要がある対象商品の最低数量。
    • forEachQuantity: バイヤーが対象商品に指定された金額を支払うたびに割引が発生します。
    • forEachAmount: バイヤーが対象商品を指定された数量購入するたびに割引が発生します。
  5. ルールベースまたはキーベースのいずれかの割引を使用して、割引に含めるアイテムを指定します。
    1. キーベースの割引を作成するには、InventoryCriterionType を INVENTORY_BY_VALUE に設定し、以下のいずれかの配列を使用して割引に含めるアイテムを指定します。
      • listingIds: Trading APIまたはInventory APIによって生成された出品の一意の識別子を使用して、割引したい出品を指定します。
      • inventoryItems: Inventory APIで生成された単一商品またはマルチバリエーション出品の一意の識別子を使用して、割引したいアイテムを指定します。
    2. ルールベースの割引を作成するには、InventoryCriterionType を INVENTORY_BY_RULE に設定し、以下にリストされている selectionRules 基準の1つ以上を指定します。指定されたすべての基準を満たす出品がキャンペーンに追加されます。
      • brand
      • categoryIds
      • categoryScope
      • listingConditionIds
      • maxPrice
      • minPrice

アイテム割引の管理に適用可能なその他のメソッドは以下の通りです。

  • pausePromotion および resumePromotion を使用して、割引を一時停止または再開します。
  • getListingSet を使用して、割引に関連付けられた出品セットを取得します。
  • getPromotions を使用して、セラーが提供している割引のリストを取得します。
  • deleteItemPriceMarkdownPromotion または deleteItemPromotion を使用して、アクティブではなくなった割引を削除します。
  • getItemPriceMarkdownPromotion または getItemPromotion を使用して、特定の割引の完全な詳細を取得します。
  • updateItemPriceMarkdownPromotion または updateItemPromotion を使用して、新しい設定で割引を更新します。これらのメソッドで更新可能なパラメータは、更新対象の割引のステータスによって異なります。

割引レポートの作成と取得

セラーは、プロモーションサマリーレポート（Promotion Summary reports）とプロモーションレポート（Promotion reports）の2種類の割引レポートを使用して、割引のパフォーマンスを追跡できます。

  • getPromotionSummaryReport を使用して、セラーの割引を要約したレポートを生成します。
  • getPromotionReports を使用して、実行中、一時停止中、または終了したすべての割引のリストを取得します。

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

ストアメールキャンペーン（Store email campaigns）を使用すると、eBayストアのオーナーは、登録者、フォロワー、およびセラー定義のバイヤーグループに対してメールキャンペーンを作成し、送信できます。セラーはキャンペーンを使用して、顧客を歓迎したり、新しいプロモーション、セール、割引について知らせたりすることができます。

Sell Marketing APIを使用してメールキャンペーンを作成するための基本的なフローは以下の通りです。

Store Email Campaign Flow
  1. getAudiences を使用して、特定のメールキャンペーンタイプで利用可能なすべてのオーディエンスを取得します。サポートされているすべてのキャンペーンタイプのリストについては、CampaignTypeEnum を参照してください。
  2. createEmailCampaign を使用してメールキャンペーンを作成します。その際、audienceCodes 配列でキャンペーンのオーディエンスを指定し、emailCampaignType フィールドでメールキャンペーンのタイプを指定します。メールキャンペーンでサポートされているタイプは以下の通りです。
    • Welcome（ウェルカム）: 新しい登録者に自動的に送信されます。
    • Item Showcase（商品ショーケース）: すべての登録者、フォロワー、またはバイヤーグループに送信可能で、セラーが強調したい新商品やコレクションを含めることができます。
    • Coupon（クーポン）: すべての登録者、フォロワー、最近の購入者、またはバイヤーグループに送信され、クーポンコードと、そのクーポンを適用可能な商品を最大4つまで含めることができます。
    • Order Discount（注文割引）: すべての登録者、フォロワー、最近の購入者、またはバイヤーグループに送信され、注文割引と、その割引を適用可能な商品を最大10個まで含めることができます。
    • Sale Event（セールイベント）: すべての登録者、フォロワー、最近の購入者、またはバイヤーグループに送信され、セールイベントに関する通知と、そのセールが適用可能な商品を最大10個まで含めることができます。
    • Volume Pricing（ボリュームプライシング）: すべての登録者、フォロワー、最近の購入者、またはバイヤーグループに送信され、ボリュームプライシングの対象となる商品が含まれます。
  3. オプションとして、scheduleDate フィールドを使用して、メールキャンペーンを送信する将来の日時を設定できます。セラーは、キャンペーンを開始する前に getEmailPreview を使用してメールキャンペーンのプレビューを取得できます。
  4. getEmailReport を使用して、すべてのアクティブなメールキャンペーンのパフォーマンスデータを取得します。

ストアメールキャンペーンの管理に使用できる追加のメソッドは以下の通りです。

  • getEmailCampaign を使用して特定のキャンペーンの完全な詳細を取得するか、getEmailCampaigns を使用して特定のタイプの複数のキャンペーンの詳細を取得します。
  • updateEmailCampaign を使用して、既存のメールキャンペーンを更新します。
  • deleteEmailCampaign を使用して、特定のメールキャンペーンを削除します。

コードサンプル

アクティブなPromoted Listingsプライオリティキャンペーンを取得する 

curl -X GET "https://api.ebay.com/sell/marketing/v1/ad_campaign?campaign_status=RUNNING&funding_strategy=COST_PER_CLICK"
-H "Authorization:Bearer OAUTH_token"

米国（US）マーケットプレイスのアクティブな注文割引を取得する 

curl -X GET "https://api.ebay.com/sell/marketing/v1/promotion?marketplace_id=EBAY_US&promotion_status=RUNNING&promotion_type=ORDER_DISCOUNT"
-H "Authorization:Bearer OAUTH_token"

エラーハンドリング

  • 無効な marketplaceId が原因でPromoted Listings API呼び出しが失敗している場合は、Promoted Listingsの要件と制限でサポートされているマーケットプレイスを確認し、適切な marketplaceId 値をAPIリクエストで渡していることを確認してください。
  • 無効な marketplaceId が原因で割引マネージャー（Discounts Manager）API呼び出しが失敗している場合は、割引マネージャーの要件と制限でサポートされているマーケットプレイスを確認し、適切な marketplaceId 値をAPIリクエストで渡していることを確認してください。
  • Promoted Listingsキャンペーンを作成しようとした際に無効なカテゴリ（Invalid Category）エラーを受け取った場合は、カテゴリIDの値を確認してください。各マーケットプレイスには、Promoted Listingsをサポートする特定のカテゴリセットがあります。マーケットプレイスごとのPromoted Listings対応カテゴリのリストについては、Category support by marketplace を参照してください。
  • 割引マネージャーでの割引やストアメールキャンペーンを作成する際に、プロモーションの対象外であるというエラーを受け取った場合は、有効なeBayストア契約（Subscription）があることを確認してください。
  • Promoted Listingsキャンペーンを作成する資格がないというエラーを受け取った場合は、マーケットプレイスの利用規約に同意していることを確認してください。各マーケットプレイスの利用規約へのリンクについては、Supported marketplaces and seller requirements を参照してください。
  • マークダウン（Markdown）割引を作成しようとした際にエラーを受け取った場合は、そのアイテムが現在の価格でどのくらいの期間出品されているかを確認してください。特定のマーケットプレイスでは、マークダウン割引に含める前に、セールの一部ではなく同じ価格で一定の日数出品されている必要があります。アイテム価格のマークダウン割引の対象となるために出品が必要な日数の一覧については、markdown discount listing requirements を参照してください。

ベストプラクティス

  • Account API v1 の getAdvertisingEligibility メソッドを使用して、各eBay広告プログラムに対するセラーの資格ステータスを確認してください。
  • Promoted Listingsプライオリティ広告プログラムへのアクセス権を取得するには、セラーは Application Growth Check を完了し、提出する必要があります。
  • Promoted Listingsを使用しているセラーは、Notification API を活用し、PLA_CAMPAIGN_BUDGET_STATUS アラートタイプをサブスクライブすることで、プライオリティキャンペーンの更新に関するアカウント通知を受け取ることができます。
トップに戻る