次の方法で共有

クーポン データ オブジェクト - 顧客請求

  • [アーティクル]

クーポンを定義します。

構文

<xs:complexType name="Coupon" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="CouponCode" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ClassName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="CouponType" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Amount" type="xs:double" />
    <xs:element minOccurs="0" name="SpendThreshold" type="xs:double" />
    <xs:element minOccurs="0" name="CurrencyCode" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="PercentOff" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="ActiveDuration" nillable="true" type="xs:int" />
    <xs:element minOccurs="0" name="ExpirationDate" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="StartDate" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="EndDate" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="SendToEmail" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="SendToDate" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="IsRedeemed" type="xs:boolean" />
    <xs:element minOccurs="0" name="RedemptionInfo" nillable="true" type="tns:CouponRedemption" />
    <xs:element minOccurs="0" name="ClaimInfo" nillable="true" type="tns:CouponClaimInfo">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
  </xs:sequence>
</xs:complexType>

要素

Coupon オブジェクトには、ActiveDuration、Amount、ClaimInfo、ClassName、CouponCode、CouponType、CurrencyCode、EndDate、ExpirationDate、IsRedeemed、PercentOff、RedemptionInfo、SendToDate、SendToEmail、SpendThreshold、StartDate という要素があります。

要素 説明 データ型
ActiveDuration クーポンが引き換えられた後のアクティブな日数。

これらの日が過ぎると、クーポンを使用できません。		 int
Amount クーポンの値の量。

CurrencyCode 要素によって通貨が決定されます。		 複
ClaimInfo 要求の AccountId、 AccountNumber、 ClaimDate 。 CouponClaimInfo
ClassName クーポンが作成されたクラス名。 string
CouponCode クーポンの引き換えに使用できるコード。 string
CouponType クーポンの型。

サポートされる型は次のとおりです。
取得：取得クーポンは、新規顧客の獲得に使用されます。 このクーポンを利用できるのは、新規のお客様のみです。
保持： 保持クーポンは、新規顧客と既存の顧客の両方で使用できます。		 string
CurrencyCode クーポン金額と支出のしきい値の通貨。

使用可能な値については、「 通貨」を参照してください。		 string
EndDate クーポンを引き換えることができる最後の日付。 dateTime
ExpirationDate クーポンの有効期限。

この日付以降、クーポンは使用できません。		 dateTime
IsRedeemed クーポンが引き換えられている。

クーポンが引き換えられた場合は値が true になり、それ以外の場合は値が false になります。		 boolean
PercentOff パーセントオフクーポン値。

これは、パーセンテージのクーポンにのみ適用されます。
たとえば、10.0 は 10% の割引を表します。		 複
RedemptionInfo 引き換えと使用の詳細が含まれます。

クーポンが引き換えられたアカウントがクーポンの所有者の顧客に請求された場合にのみ返されます。		 CouponRedemption
SendToDate DispatchCoupons 操作によってクーポンが電子メールで送信された日付。 dateTime
SendToEmail DispatchCoupons 操作によってクーポンが電子メールで送信された電子メール アドレス。 string
SpendThreshold クーポンは、クーポンが引き換えられた時点からアカウントの支出がこのしきい値に達するまで消費できません。

CurrencyCode 要素によって通貨が決定されます。		 複
StartDate クーポンは開始日より前に引き換えることはできません。 dateTime

要件

サービス: CustomerBillingService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13/Entities

使用ページ

SearchCoupons