Partager via


Objet de données de coupon - Facturation client

Définit un coupon.

Syntaxe

<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>

Éléments

L’objet Coupon contient les éléments suivants : ActiveDuration, Amount, ClaimInfo, ClassName, CouponCode, CouponType, CurrencyCode, EndDate, ExpirationDate, IsRedeemed, PercentOff, RedemptionInfo, SendToDate, SendToEmail, SpendThreshold, StartDate.

Élément Description Type de données
ActiveDuration Jours actifs depuis coupon a été utilisé.

Après ces jours, le coupon ne peut plus être consommé.
int
Montant Valeur de la coupon.

L’élément CurrencyCode détermine la devise.
Double
ClaimInfo AccountId, AccountNumber et ClaimDate de la revendication. CouponClaimInfo
Classname Nom de classe à partir duquel le coupon a été frappé. chaîne
CouponCode Code qui peut être utilisé pour échanger les coupon. chaîne
CouponType Type du coupon.

Les types pris en charge sont les suivants :
Achat: L’acquisition coupon est utilisée pour acquérir de nouveaux clients. Seuls les nouveaux clients peuvent utiliser cette coupon.
Rétention: Les coupons de rétention peuvent être utilisés par les clients nouveaux et existants.
chaîne
CurrencyCode Devise du montant coupon et du seuil de dépense.

Pour connaître les valeurs possibles, consultez Devises.
chaîne
EndDate Dernière date à laquelle le coupon peut être utilisé. dateTime
ExpirationDate Date d’expiration coupon.

Après cette date, le coupon ne peut plus être consommé.
dateTime
IsRedeemed Le coupon a-t-il été utilisé.

La valeur est true si le coupon a été utilisé, et sinon la valeur est false.
boolean
PercentOff Pourcentage de remise coupon valeur.

Cela s’applique uniquement à un pourcentage coupon.
Par exemple, 10.0 représente une remise de 10 %.
Double
RedemptionInfo Contient les détails de l’échange et de la consommation.

Retourné uniquement lorsque le compte dans lequel le coupon a été utilisé facture au client propriétaire de l’coupon.
CouponRedemption
SendToDate Date à laquelle le coupon a été envoyé par e-mail par l’opération DispatchCoupons. dateTime
SendToEmail Adresse e-mail que le coupon a été envoyée par e-mail par l’opération DispatchCoupons. chaîne
SpendThreshold Les coupon ne peuvent pas être consommées tant que les dépenses du compte n’ont pas atteint ce seuil à partir du moment où coupon a été utilisée.

L’élément CurrencyCode détermine la devise.
Double
Startdate Le coupon ne peut pas être utilisé avant la date de début. dateTime

Configuration requise

Service : CustomerBillingService.svc v13
Noms: https://bingads.microsoft.com/Customer/v13/Entities

Utilisé par

SearchCoupons