この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
プロモーションでは、買い物客が特定の購入要件を満たした場合に割引が提供されます。
Shopper Products API と Shopper Search API では、プロモーション情報には価格設定とコールアウトメッセージの両方の情報が含まれます。ただし、取得される特定の価格設定とコールアウトの情報は、以下によって決定されます。
プロモーションは次のいずれかのタイプに分類されます。
商品は商品プロモーションにのみ適用され、次のいずれかに分類されます。
対象商品
割引のトリガーに使用された商品。以下に例を示します。
「商品 X を 3 点購入すると、商品 Y を最大 4 点まで 10 % 割引」というプロモーションでは、対象商品は商品 X になります。
重要: 対象商品には、サイズや色など、異なる購入オプションであるバリアントがあります。プロモーションに指定されている特定の商品購入オプションは、マスター商品または主要商品と呼ばれます。バリアント商品は、プロモーションに含まれる場合と含まれない場合があります。
1"type": {
2"master": true
3}1"type": {
2"variant": true
3}割引商品
ボーナス商品
プロモーションには、特定の数量や特定のアイテムの購入など、特定の商品購入要件を設定できますが、必須ではありません。
プロモーションタイプ、商品タイプ、および商品購入要件に基づいて、レスポンスの内容には次の情報が含まれます。
価格情報は、商品レベルのプロモーションで条件なしの購入要件がある対象商品についてのみ返されます (たとえば、「商品 X を購入すると $10 割引」、「商品 X を購入すると $10 % 割引」など)。その他のプロモーションタイプ、商品タイプ、および商品の購入要件については、価格設定は買い物客が取るアクションによって影響を受けるため、買い物客が追加の購入決定を行うまで計算できません。
さらに:
コールアウトメッセージには、対象商品、割引商品、ボーナス商品 (該当する場合) の詳細と、プロモーションの対象となるために買い物客が行う必要のある操作が記載されています。
コールアウトメッセージは、レスポンスボディの productPromotions[].calloutMsg 属性で返されます。
たとえば、次のコードには、レディースシャツを購入した場合に $10 割引になるという無条件の購入コールアウトメッセージが含まれています。
1"productPromotions": [
2{
3"calloutMsg": "$10 Fixed on Women's Shirt",
4"promotionalPrice": 89.99,
5"promotionId": "$10FixedProductsOnWomensShirt"
6}
7]次の例は、$400 以上の男性用スーツを購入した場合に $50 の割引を行うという条件付き購入コールアウトメッセージです。
1"productPromotions": [
2{
3"calloutMsg": "$50 off Mens Suits Over 400",
4"promotionId": "$50offSuitsOver400"
5}]