Documentation

Ucommerce includes full API reference documentation and lots of helpful articles to help you build your e-commerce site as effortlessly as possible.

Topics Payment Providers
v7.18

Marketing Library

The Marketing library in Ucommerce, enables you to easily integrate your marketing campaigns in your web-applications.

Most of the things that goes on in Marketing foundation happens automatically in the basket pipeline. However adding a voucher is an action performed by the user, and needs to be called by the API.

Advertising is also done using MarketingLibrary, and are great for presenting users with what discounts are available. This article will sum up the different methods available.

Ucommerce.Api.IMarketingLibrary

Methods


AddVoucher

  • Arguments
    • string voucherCode
  • Return type Boolean

GetTargetedCampaignItems

  • Arguments
    • This method is called without any arguments
  • Return type IList<Ucommerce.EntitiesV2.CampaignItem>

GetTargetedCampaignItems

  • Description
    Gets all campaign items, which targets are satisfied, for the given Product.
  • Arguments
    • Ucommerce.EntitiesV2.Product product
  • Return type IList<Ucommerce.EntitiesV2.CampaignItem>

GetTargetedCampaignItemsForIndividualProducts

  • Description
    Gets lists of all campaign items, which have targets satisfied for each of the products given.
  • Arguments
    • IEnumerable<Ucommerce.EntitiesV2.Product> products
  • Return type IList<IList<Ucommerce.EntitiesV2.CampaignItem>>

GetSingleProductCampaignItems

  • Arguments
    • This method is called without any arguments
  • Return type ICollection<Ucommerce.EntitiesV2.CampaignItem>

Adding a Voucher

Vouchers are typed into the UI by the customer, so Ucommerce needs to pick up when this happens. This is done using MarketingLibrary.AddVoucher.

Ucommerce.Api.IMarketingLibrary.AddVoucher

  • Return type Boolean
  • Arguments
    • System.String voucherCode

Calling the API

    
    var marketingLibrary = Ucommerce.Infrastructure.ObjectFactory.Instance.Resolve<Ucommerce.Api.IMarketingLibrary>();
    marketingLibrary.AddVoucher(voucherCode);
    

Get Targeted Campaign Items

The GetTargetedCampaignItems() method gives you a list of the targeted campaign items for the current user context. For example all discounts that are relevant to the category or product the user is visiting. For example you can use GetTargetedCampaignItems.

Ucommerce.Api.IMarketingLibrary.GetTargetedCampaignItems

Additional overloads to this method exists

  • Return type IList<Ucommerce.EntitiesV2.CampaignItem>

Calling the API

    
    var marketingLibrary = Ucommerce.Infrastructure.ObjectFactory.Instance.Resolve<Ucommerce.Api.IMarketingLibrary>();
    marketingLibrary.GetTargetedCampaignItems();