Loading
Aprenda mais sobre o Gerenciamento de oferta em tempo real
Projetar promoções programaticamente

Você está aqui:

  1. Ajuda do Salesforce
  2. Documentação
  3. Gerenciamento de oferta em tempo real

Projetar promoções programaticamente

Use a API de criação de promoção para criar, configurar e gerenciar promoções. Os integradores de sistemas podem integrar perfeitamente a API a sistemas externos em que usuários, como gerentes de loja, podem criar promoções.

Edições obrigatórias

Disponível em: Lightning Experience
Disponível em: Edições Enterprise, Unlimited e Developer com Gerenciamento de ofertas em tempo real

Para criar uma promoção, especifique os detalhes principais, as regras da promoção e as recompensas. Ao especificar os detalhes das regras e recompensas, mapeie os detalhes especificados com o tipo de modelo de promoção que você deseja usar na promoção. Você também pode especificar critérios e limites de elegibilidade para a promoção.

Importante
Importante Não é possível usar a API de criação de promoção para criar promoções que usam o modelo de promoção da Trilha de engajamento.

Você também pode usar a API para atualizar e excluir promoções e recuperar detalhes da promoção. Para entender como criar uma promoção, consulte as etapas do Assistente de promoção rápida.

Exemplo
Exemplo A equipe de marketing na Cloud Kicks está planejando sua campanha de marketing de verão para o programa de fidelidade "Cloud Kicks Loyalty". Para impulsionar as vendas e recompensar os clientes fiéis, eles querem criar uma promoção chamada Summer Sale. Essa promoção será executada durante o mês de junho e oferecerá um desconto de 10% em compras acima de US$ 50. A promoção é específica para a categoria de produto Summer Sneakers no aplicativo e é direcionada ao segmento Clientes fiéis. Para garantir que a promoção seja eficaz, eles querem limitar seu uso a 1000 vezes no geral e 5 vezes por cliente.

Esta é a aparência da solicitação da API de criação de promoção quando a API é executada:

{
  "promotionDetails": {
    "name": "Summer Sale",
    "displayName": "Summer Sale Promotion",
    "priorityNumber": 1,
    "description": "Summer Sale promotion offering a 10% discount on purchases over $50",
    "promotionCode": "SUMMER2025",
    "startDateTime": "2025-06-01T00:00:00.000Z",
    "endDateTime": "2025-06-30T23:45:00.000Z",
    "loyaltyProgram": {
      "name": "CloudKicksLoyalty"
    },
    "promotionEligibility": {
      "productCatalog": {
        "id": "0ZSxx000000001dGAA"
      },
      "eligibleProductCategories": [
        {
          "id": "Summer Sneakers"
        }
       ],
      "eligibleChannels": [
        {
          "channelType": "Online",
          "channel": {
            "name": "App"
          }
        }
      ],
      "eligibleSegments": [
        {
          "name": "Loyal Customers"
        }
      ],
      "areAllLoyaltyMembersEligible": false     
    },
    "promotionLimits": {
      "usePerCustomerLimit": 5,
      "totalUseLimit": 1000
    }
  },
  "rules": [
    {
      "templateName": "BuyXToGetRewards",
      "ruleName": "SummerSaleRule",
      "priority": 1,
      "eventConfiguration": [
        {
          "allOf": [
            {
              "anyOf": {
                "purchaseType": "ProductCategory",
                "applicablePurchaseList": [
                  {
                    "name": "Summer Sneakers"
                  }
                ],
                "purchaseCriteria": {
                  "type": "Amount",
                  "value": 50
                }
              }
            }
          ]
        }
      ],
      "rewardConfiguration": [
        {
          "type": "ProvideDiscount",
          "rewardDetails": {
            "discountValue": "10",
            "discountType": "PercentageOff"
          },
          "targetAudience": {
            "audienceType": "AllLoyaltyMembers"
          }
        }
      ]
    }
  ]
}
 
Carregando
Salesforce Help | Article