B2C Commerce でのプロモーションのインポートとエクスポート

B2C Commerce でのランク属性と除外属性のインポート/エクスポート

ランク (Rank) と除外 (Exclusive) の各プロモーション属性は、promotion .xsd でサポートされています。このトピックは、B2C Commerce に該当します。

• システム属性ランク の値リストは、インポート/エクスポート機能で上書きできます。
• システム属性除外 の値リストはカスタマイズできません。

promotion.xsd スキーマは以下のように拡張されています:

<!-- 買い物プロモーション-->
<xsd:complexType name="ShippingPromotionRule" mixed="false">
	<xsd:sequence> 
		<xsd:element
			name="qualifying-products" 
			type="ProductSpecification" 
			minOccurs="0"
			maxOccurs="1" />
		<!-- 新しい要素-->
 		<xsd:element 
 			name="shipping-methods"
 			type="PromotedShippingMethods" 
 			minOccurs="1" 
 			maxOccurs="1"/>
		<xsd:element 
			name="discounts" 
			type="TieredShippingDiscounts" />
		<xsd:element 
			name="max-applications" 
			type="MaxApplications" 
			minOccurs="0" 
			maxOccurs="1" /> 
 	</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="ShippingPromotionConditionType">
	<xsd:restriction base="xsd:string">
		<xsd:enumeration value="shipment-total" />
		<xsd:enumeration value="product-quantity" />
		<!-- 新しい要素-->
 	</xsd:restriction>
</xsd:simpleType>

入力/出力形式の詳細については、Promotion.xsd を参照してください。

メモ PromotionExclusivity (プロモーション除外) の設定は必須ですが、xsd エレメントは技術上の理由で必須として宣言することはできません。つまり、そのエレメントが指定されていない場合、新しいプロモーションにはデフォルト値が設定されます。デフォルト値は no です。

promotion.xsd では無料割引タイプがサポートされています。

コンプレックスタイプ BogoProductDiscount (BOGO 商品割引) には割引タイプが含まれています。

<xsd:complexType name="BogoProductDiscount" mixed="false">
	<xsd:sequence>
		<xsd:element 
			name="threshold"
			type="Threshold" 
			minOccurs="1" 
			maxOccurs="1" />
	 	<xsd:choice minOccurs="1" maxOccurs="1">
			<xsd:element 
				name="fixed-price" 
				type="Amount" />
			<xsd:element 
				name="percentage" 
				type="Percentage" />
			<xsd:element 
				name="amount" 
				type="Amount" />
			<xsd:element 
				name="free" 
				type="EmptyElement"/> 
			<!-- 新しい要素 -->
 		</xsd:choice>
 		<xsd:element 
 			name="eligible-quantity" 
 			type="Quantity" 
 			minOccurs="1" 
 			maxOccurs="1"/>
	</xsd:sequence>
</xsd:complexType>

コンプレックスタイプ TieredShippingDiscount (階層配送割引) には新しい割引タイプが含まれています。

<xsd:complexType name="TieredShippingDiscount" mixed="false">
	<xsd:sequence>
		<xsd:element 
			name="threshold"
			type="Threshold" 
			minOccurs="1" 
			maxOccurs="1" />
 		<xsd:choice minOccurs="1" maxOccurs="1">
 			<xsd:element 
 				name="fixed-price" 
 				type="Amount" />
			<xsd:element 
				name="percentage" 
				type="Percentage" />
			<xsd:element 
				name="amount" 
				type="Amount" />
			<xsd:element 
				name="free" 
				type="EmptyElement"/> 
			<!-- 新しい要素 -->
		</xsd:choice>
	</xsd:sequence>
</xsd:complexType>

要素 free は空の XML 要素です。

以下に例を示します。

 ...

<discounts condition-type="product-quantity"> 
	<discount> 
		<threshold>2.0</threshold> 
		<free/>
	</discount>
</discounts>

B2C Commerce の「X を購入すると合計金額が」商品プロモーション

「X を購入すると合計金額が 」商品プロモーションをキャンペーンに追加できます。このトピックは、B2C Commerce に該当します。

total-discounts 要素は「X を購入すると合計金額が」 プロモーションタイプを表します。total-discounts 要素は、既存のプロモーションのインポートまたはエクスポートファイル内ではタイプ TotalProductDiscount です。

以下に示すのはサンプル XLM です:

<promotion campaign-id="Demo Campaign" promotion-id="PP_20OFF">
 	<enabled-flag>true</enabled-flag>
	<qualifiers>
		<customer-groups/>
	</qualifiers>
	<rank>10</rank>
	<exclusivity>no</exclusivity>
	<name xml:lang="x-default">ShirtsForTotalPrice</name>
	<callout-msg 
		xml:lang="x-default">Buy 2 shirts for $20 total or 3 shirts for $23 total</callout-msg>
	<product-promotion-rule>
		<!-- only discounted products supported for new promotion type -->
		<discounted-products>
			<included-products>
				<condition-group>
					<category-condition catalog-id="product-catalog">
						<category-id>Shirts</category-id>
 					</category-condition>
				</condition-group>
			</included-products>
		</discounted-products>
		<total-discounts>
			<discount>
				<total-fixed-price>20.00</total-fixed-price>
				<eligible-quantity>3</eligible-quantity>
			</discount>
			<discount>
				<total-fixed-price>30.00</fixed-price>
				<eligible-quantity>5</eligible-quantity>
			</discount>
		</total-discounts>
	</product-promotion-rule>
</promotion>

メモ 「X を購入すると合計金額が 」商品プロモーションをキャンペーンに追加する場合は、対応する要素をインポートまたはエクスポートファイルに追加してください。

B2C Commerce でのプロモーションの顧客グループのインポートとエクスポート

顧客グループはキャンペーンに関連しています。プロモーションでは customergroup.xsd スキーマを使用できます。このトピックは、B2C Commerce に該当します。

以下のサンプル XML には、顧客グループを 2 つもつキャンペーン (実際のプロモーションなし) が含まれています。

<campaign campaign-id="c1">
	<description>サンプルキャンペーン。</description>
	<enabled-flag>true</enabled-flag>
	<start-date>2008-01-17T11:04:24</start-date>
	<end-date>2008-01-17T11:04:31</end-date>
	<customer-groups>
		<customer-group group-id="gold-customers" />
		<customer-group group-id="platinum-customers" />
	</customer-groups>
</campaign>

B2C Commerce でのプロモーションのソースコードのインポートとエクスポート

プロモーションのインポートとエクスポートには sourcecode.xsd スキーマを使用できます。このトピックは、B2C Commerce に該当します。

次の XML サンプルは、2 つのサンプルソースコードグループによって明示的にトリガーされるとマークされている商品プロモーションの概要です:

<product-promotion promotion-id="simple-product-promo" campaign-id="c1">
 ...
 <sourcecodes>
  <sourcecode group-id="sample-group-1" />
  <sourcecode group-id="sample-group-2" />
 </sourcecodes>
 ...
</product-promotion>

B2C Commerce でのプロモーションとキャンペーンのクーポン割り当てのインポート

promotion.xsd スキーマでは、プロモーションやキャンペーンに付随するクーポンの指定方法を定義できます。このトピックは、B2C Commerce に該当します。

特定のクーポンの情報は、coupon.xsd スキーマで定義します。

メモ UTF-8 形式は、Unicode の可変長文字エンコーディングです。Unicode 規格のどのような文字でも表すことができます。このスキーマは機能を例証する目的でのみ示されており、いつでも変更される可能性があります。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xsd:schema 
	xmlns="http://www.demandware.com/xml/impex/promotion/2008-01-31" 
	xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
	xmlns:xml="http://www.w3.org/XML/1998/namespace" 
	targetNamespace="http://www.demandware.com/xml/impex/promotion/2008-01-31"
	elementFormDefault="qualified" 
	attributeFormDefault="unqualified">
	<xsd:import namespace="http://www.w3.org/XML/1998/namespace" schemaLocation="xml.xsd" />
	<!-- トップレベル要素 -->
	<xsd:element name="promotions">
		<xsd:complexType>
			<xsd:sequence>
				<xsd:element name="campaign" type="Campaign" minOccurs="0" maxOccurs="unbounded" />
				<xsd:element name="promotion" type="Promotion" minOccurs="0" maxOccurs="unbounded" />
			</xsd:sequence>
		</xsd:complexType>
	</xsd:element>

この部分で、キャンペーンの一部であるクーポンを指定します。

	<xsd:complexType name="Campaign" mixed="false">
		<xsd:sequence>
			. . .
			<xsd:element name="coupons" type="PromotionCoupons" minOccurs="0" maxOccurs="1" />
			. . .
		</xsd:sequence>
		. . .
	</xsd:complexType>

この部分で、プロモーションの一部であるクーポンを指定します。

	<xsd:complexType name="Promotion" mixed="false">
		<xsd:sequence>
			. . .
			<xsd:element name="coupons" type="PromotionCoupons" minOccurs="0" maxOccurs="1" />
			. . .
		</xsd:sequence>
		. . .
	</xsd:complexType>
	. . .

この部分で、クーポンの名前と ID を定義します。

	<xsd:complexType name="PromotionCoupons" mixed="false">
		<xsd:sequence>
			<xsd:element name="coupon" type="Coupon" minOccurs="0" maxOccurs="unbounded" />
		</xsd:sequence>
	</xsd:complexType>
	<xsd:complexType name="Coupon" mixed="false">
		<xsd:attribute name="coupon-id" type="Generic.NonEmptyString.256" use="required" />
	</xsd:complexType>
	. . .

この部分で、PromotionQualifiers (プロモーション限定子) を一般的なタイプとして定義します。

	<xsd:complexType name="PromotionQualifiers" mixed="false">
		<xsd:sequence>
			. . .
			 <xsd:element name="coupons" type="EmptyElement" minOccurs="0" maxOccurs="1" />
		</xsd:sequence>
	</xsd:complexType>
	. . .
</xsd:schema>

B2C Commerce での商品プロモーションのインポートとエクスポート

商品プロモーションルールでは、商品限定の割引ルールによって特定の商品をターゲットとするために必要な情報をすべてとりまとめます。このトピックは、B2C Commerce に該当します。

B2C Commerce でのプロモーションのランクと除外のインポートとエクスポート

インポートとエクスポートの機能には、rank (ランク) と exclusivity (除外) の属性も含まれています。このトピックは、B2C Commerce に該当します。

以下の rank と exclusivity の例では、PromotionExclusivity (プロモーション除外) の設定は必須ですが、xsd エレメントは技術上の理由で必須として宣言することはできません。要素が指定されていない場合、新しいプロモーションでは no. のデフォルト値が設定されます。

<xsd:complexType name="Promotion" mixed="false">
  <xsd:sequence>
    <xsd:element name="enabled-flag" type="xsd:boolean" minOccurs="0" maxOccurs="1" />
    <xsd:element name="qualifiers" type="PromotionQualifiers" minOccurs="0" maxOccurs="1" />
    <!-- NEW --> 
    <xsd:element name="rank" type="xsd:int" minOccurs="0" maxOccurs="1" />
    <xsd:element name="exclusive" type="PromotionExclusivity" minOccurs="0" maxOccurs="1" />
  <xsd:restriction base="xsd:string">
    <xsd:enumeration value="no" />
    <xsd:enumeration value="class" />
    <xsd:enumeration value="global" />
  </xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="PromotionExclusivity">
    <xsd:element name="name" type="LocalizedString" minOccurs="0" maxOccurs="unbounded" />
    ...
  </xsd:sequence>
  ...    
</xsd:complexType>

メモ プロモーションインポートの形式では、1 以上のランク値のみがサポートされます。

複雑なタイプである BogoProductDiscount (BOGO 商品割引) および TieredShippingDiscount (階層配送割引) には割引タイプが含まれています。

  <xsd:element name="fixed-price" type="Amount" />
  <xsd:element name="percentage" type="Percentage" />
  <xsd:element name="amount" type="Amount" />
  <xsd:element name="free" type="EmptyElement" />

メモ free-discount (無料割引) 要素は空白の要素です。

B2C Commerce での注文プロモーションのインポート/エクスポート

注文プロモーションは商品プロモーションより単純で、その XML スキーマは、記述済みの商品プロモーションスキーマのサブセットです。このトピックは、B2C Commerce に該当します。

次のサンプルは、商品合計金額がそれぞれ $100、$200 を超える場合に、注文が $10、$25 割引になる階層化された注文プロモーションを示しています。

<promotion promotion-id="simple-order-promo" campaign-id="c1">
  <enabled-flag>true</enabled-flag>
  <name xml:lang="x-default">Simple OrderPromotion</name>
  <order-promotion-rule>
    <discounts>
      <discount>
        <threshold>100</threshold>
        <amount>10</amount>
      </discount>
      <discount>
         <threshold>200</threshold>
         <amount>25</amount>
      </discount>
    </discounts>
  </order-promotion-rule>
</promotion>

次の例は、顧客が何かを購入した (注文合計金額のしきい値が 0 より大きい) 場合に、無料の商品 (SKU1) を注文に追加するボーナスプロモーションを示しています。

<promotion promotion-id="bonus-order-promo" campaign-id="c1">
  <enabled-flag>true</enabled-flag>
  <name xml:lang="x-default">Bonus OrderPromotion</name>
  <order-promotion-rule>
    <discounts>
     <discount>
       <threshold>0</threshold>
       <bonus>
         <bonus-products>
          <product-id>SKU1</product-id>
         </bonus-products>
       </bonus>
     </discount>
    </discounts>
  </order-promotion-rule>
</promotion>

要素 <payment-methods> および複雑なタイプの PromotedPaymentMethods を使用すると、支払方法に基づく注文の割引を作成できます。次の例は、支払方法に PayPal を使用すると注文がすべて 10% 割引になるプロモーションです。

    <promotion promotion-id="paymentpromo">
        <enabled-flag>false</enabled-flag>
        <searchable-flag>false</searchable-flag>
        <exclusivity>no</exclusivity>
        <callout-msg xml:lang="x-default">Use Paypal to receive 10% off your order!</callout-msg>
        <details xml:lang="x-default">10% for paypal</details>
        <order-promotion-rule>
            <payment-methods>
                <method-id>PayPal</method-id>
            </payment-methods>
            <discount-only-qualifying-products>true</discount-only-qualifying-products>
            <discounts condition-type="order-total">
                <discount>
                    <threshold>0.0</threshold>
                    <percentage>10.0</percentage>
                </discount>
            </discounts>
        </order-promotion-rule>
    </promotion>

メモ 「ボーナス商品」と「ボーナス商品の選択」の注文プロモーションクラスには、支払方法の割引を作成することはできません。これは、注文が確定した時点で、ボーナス商品が選択される前に計算される割引です。

B2C Commerce での配送プロモーションのインポート/エクスポート

配送プロモーションのインポート/エクスポート形式は注文プロモーションと似ています。大きな違いは、配送プロモーションでは割引配送方法を定義できることです。このトピックは、B2C Commerce に該当します。

次のサンプル XML は、対象商品の合計金額がそれぞれ $50、$100 を超える場合に、選択した配送方法が 50%、100% 割引になる階層化された配送プロモーションを示しています。

<promotion promotion-id="tiered-shipping-promo" campaign-id="c1">
  <enabled-flag>true</enabled-flag>
  <name xml:lang="x-default">Tiered ShippingPromotion</name>
  <shipping-promotion-rule>
    <shipping-methods>
      <method-id>ups-ground</method-id>
      <method-id>ups-air</method-id>
    </shipping-methods>
    <discounts condition-type="shipment-total">
      <discount>
       <threshold>50</threshold>
       <percentage>50</percentage>
      </discount>
      <discount>
       <threshold>100</threshold>
       <fixed-price>0</fixed-price>
      </discount>
    </discounts>
  </shipping-promotion-rule>
</promotion>

上記のプロモーションの例では、condition-type (条件タイプ) に "shipment-total" (配送合計) が指定されています。配送プロモーションでは、condition-type に "product-quantity" (商品数量) を代わりに指定することも可能です。このようなプロモーションでは、特定数の対象商品が配送に含まれることが、割引適用の条件になります。このタイプのプロモーションの XML には、<discounted-methods> セクションの前に <qualifying-products> セクションがあります。

一般的に、condition-type が "product-quantity" に指定されている配送プロモーションでは、配送に特定数の対象商品が含まれていて、除外商品が含まれていないことが条件になります。ただし、除外商品を配送プロモーションで許可するか禁止するかは、構成可能です。この動作を管理するために、true または false の値を使用するオプションの要素 <prohibit-excluded-products> をプロモーション XML に含めることができます。新規にインポートされたプロモーションでこの要素が省略されている場合は、除外商品が禁止されます。

詳細については、スキーマ promotion.xsd を参照してください。

B2C Commerce でのプロモーションスケジュールのインポート/エクスポート

すべてのプロモーションクラスで、プロモーションがいつアクティブになるかを管理するオプションのプロモーションスケジュールがサポートされています。このトピックは、B2C Commerce に該当します。

以下に示すのは、promotion.xsd のプロモーションスケジュールセクションのスニペットです。

<xsd:complexType name="PromotionSchedule" mixed="false">
  <xsd:sequence>
    <xsd:element name="start-date" type="xsd:dateTime" minOccurs="0" maxOccurs="1" />
    <xsd:element name="end-date" type="xsd:dateTime" minOccurs="0" maxOccurs="1" />
    <xsd:element name="recurrence" type="PromotionSchedule.Recurrence" minOccurs="0" maxOccurs="1" />
  </xsd:sequence>
</xsd:complexType>
<xsd:complexType name="PromotionSchedule.Recurrence" mixed="false">
  <xsd:sequence>
    <xsd:element name="day-of-week" type="PromotionSchedule.DayOfWeek" minOccurs="0" maxOccurs="1" />
    <xsd:element name="time-of-day" type="PromotionSchedule.TimeOfDay" minOccurs="0" maxOccurs="1" />
  </xsd:sequence>
</xsd:complexType>

このサンプル XML には 1 月のスケジュールが含まれており (開始日と終了日を参照)、プロモーションは、月曜日、金曜日、土曜日、日曜日の午前 9 時 から午後 7 時までに限定されています。

<schedule>
 <start-date>2008-01-01T13:32:01</start-date>
 <end-date>2008-01-31T13:33:30</end-date>
 <recurrence>
   <day-of-week>
    <weekday>Monday</weekday>
    <weekday>Friday</weekday>
    <weekday>Saturday</weekday>
    <weekday>Sunday</weekday>
   </day-of-week>
   <time-of-day>
    <time-from>09:00:00</time-from>
    <time-to>19:00:00</time-to>
   </time-of-day>
 </recurrence>
</schedule>