--- schema_version: "1" id: c8802865aa8444c48021d0ea871a7b9a39de1923d5a9efec85d56c0e1c217ca0 title: Promotion and Campaign Object Import and Export in B2C Commerce collection: admin version: current locale: en-us portal_url: https://docs.salesforce.com/admin/current/en-us/cc/264-0-0/b2c_promotion_and_campaign_object_import_export.md canonical_url: https://help.salesforce.com/s/articleView?id=cc.b2c_promotion_and_campaign_object_import_export.htm&release=264.0.0&type=5 source_site: help.salesforce.com content_type: documentation content_hash: 7bc636bee13b253da659573e621adbd7d93a8e6ffc158c1534553cac141dd70d description: Use the promotion.xsd schema file to import campaigns and promotions. Promotions can be assigned to multiple campaigns. products: - Commerce - B2C Commerce release: "264" --- # Promotion and Campaign Object Import and Export in B2C Commerce Use the promotion.xsd schema file to import campaigns and promotions. Promotions can be assigned to multiple campaigns.
Object Information Details
Schema file promotion.xsd
Granularity Selected promotion.
Business Manager import location site | Merchant Tools | Online Marketing | Import & Export and site | Administration | Site Development | Site Import & Export
Pipelets
  • ImportPromotions
  • ExportPromotions
## Globally Excluded Products Import and Export in B2C Commerce The promotion import includes Global Product Exclusions rules. When configuring Global Product Exclusions rules, keep the following in mind: - An empty Global Product Exclusions rule isn't exported. - Global product exclusion rules are replicated with the campaigns and promotions of the site. - Global product exclusion rules are replicated with the campaigns and promotions of the site. - New promotion-level settings are replicated with the promotion. - The `promotion.xsd` top-level element contains the element of complex type PromotionSettings. This element is the container of the rule. - The element is optional and can occur at most one time. The complex types ProductPromotionRule and OrderPromotionRule support the flag . A site always owns a PromotionSettings instance. This instance can never be deleted, but only reset. The following is how the different modes behave: | | Update or Merge | Replace | Delete | | --- | --- | --- | --- | | with | Global excluded product rule is created or updated. | PromotionSettings instance is reset to its initial state (meaning that all of its values are removed), after that global excluded products rule is created. | PromotionSettings instance is reset to its initial state (meaning that all of its values are removed). | | with empty | If it exists, the global excluded product rule is removed. | PromotionSettings instance is reset to its initial state (means all of its values are removed), after that global excluded products rule is NOT new created. | PromotionSettings instance is reset to its initial state (means all of its values are removed). | | empty | PromotionSettings instance isn't touched. | PromotionSettings instance is reset to its initial state (means all of its values are removed). | PromotionSettings instance is reset to its initial state (means all of its values are removed). | | undefined | PromotionSettings instance isn't touched. | PromotionSettings instance isn't touched. | PromotionSettings instance isn't touched. | ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-cc-b2c_merchandiser_administrator-264-0-0-production-enus/ea76f372-6cfa-42a6-8e7c-05c6df7abed8/images/icon_note.png) Note If the import creates promotions with no flag, it sets the default value to FALSE. The import always updates the global-excluded-products rule completely. There’s no partial update of the rule. ## Attribute Operators in B2C Commerce Promotion product and shipping product rules support operators for system and custom attributes. This table lists the system attribute operators.
Attribute Operators
ID

is equal

is not equal

starts with

ends with
Brand

exists

doesn't exist

is equal

is not equal

starts with

ends with
This table lists the operators available for any custom attributes you choose to create. Which operators are available differs by the data type of the attribute.
Data Type Operators
String and Set-of-String

exists

doesn't exist

is equal

is not equal

starts with

ends with
Enum-of-String

is equal

is not equal

starts with

ends with
Integer, Set-of-Integer, and Enum-of-Integer

exists

doesn't exist

is equal

is not equal

is greater than or equals

is less than or equals
Boolean

exists

doesn't exist

is equal

## Promotion\_Campaign\_Assignent Element in B2C Commerce The element is at the top level in the XML for assignment of promotions to campaigns. When using the element, keep the following in mind: - Each element requires a and matching a valid promotion and campaign. If a promotion or campaign isn't found, an error message is logged and the element is skipped. - All contained elements are optional. When optional elements aren’t provided for existing assignments in MERGE or UPDATE modes, the corresponding values aren’t changed. When optional elements aren’t provided for new assignments in MERGE and REPLACE modes, default values are used. - Deletes are supported for the element using mode="delete". - When only or is provided with a delete, it acts as a wildcard delete. The delete can be for assignments of a specified promotion to all campaigns, or the assignments of all promotions to a specified campaign. - When both and are provided, it's a delete of the assignment of the specified promotion to the specified campaign. - A warning message is logged if the wildcard delete can't be performed because no assignments match the criteria. ## Trimmed Whitespace in B2C Commerce Learn how leading and trailing white spaces are managed when editing product rules. When editing promotions and shipping methods product rules, it's possible to accidentally enter leading and trailing whitespace for some IDs. These IDs can include Products, Price Books, Brands, or Catalog Categories. The system trims leading and trailing white spaces in the following ways: - Business Manager trims IDs of whitespace when saving a product rule. - IDs contained in the product rules of existing promotions or shipping methods are also trimmed of whitespace during promotion and shipping method export.