Common workflows

7 min

The following sections are some of the ways you can use Optimizely Opal to create and edit promotions in Optimizely Commerce Connect.

Create a campaign with promotions

List available campaign types.

Tool: campaign_types_list

Create the campaign.

Tool: campaign_create
{
  "Name": "Holiday Sale 2024",
  "ValidFrom": "2024-12-01T00:00:00Z",
  "ValidUntil": "2024-12-31T23:59:59Z"
}

List available promotion types.

Tool: promotion_types_list

Create promotions within the campaign.

Tool: promotion_create
{
  "Name": "25% Off All Items",
  "Campaign": "Holiday Sale 2024",
  "PromotionType": "EPiServer.Commerce.Marketing.Promotions.SpendAmountGetOrderDiscount"
}

Configure promotion properties.

Tool: promotion_dynamic_update
{
  "Id": "456",
  "Properties": {
    "Condition_SpendAmount": 50.00,
    "Discount_Percentage": 25.0
  }
}

Clone and modify a promotion

Find the source promotion.

Tool: promotion_filter
{ "Name": "Summer Discount" }

Get promotion details.

Tool: promotion_detail
{ "Identifier": "456", "IncludeAdditionalDetails": true }

Clone the promotion.

Tool: promotion_clone
{ "PromotionId": "456", "CampaignId": "789" }

Update the cloned promotion.

Tool: promotion_update
{ "Id": "new-id", "Name": "Winter Discount" }

Analyze promotion performance

List promotions by sales.

Tool: promotion_list_by_sales
{ "MarketId": "US" }

Get details of top-performing promotion.

Tool: promotion_detail
{ "Identifier": "top-promotion-id", "IncludeAdditionalDetails": true }