4.16.10 Breaking Change: Change in Commitment Data structure and deprecation of old fields in version 2.141

What is changing?

With version 2.141 we’re starting big enhancements to our Commitment feature, which will also change the data structure in that regard.

This will allow you, to use the feature with much more flexibility, but will also mean you as a customer might need to enhance certain parts of your configuration and customization to these changes. There are two major field deprecations connected to our Commitments:

Media Campaign Commitment Fields:

The lookup fields for Commitments on the Media Campaign will not work anymore. If you are trying to change them or trying to use them, while creating a new Media Campaign, you will receive an error message and can not proceed to save.

The following fields are affected by this:

  • Commitment

  • Agency Earning Commitment

  • Third Party Commitment

Instead there will be now a related list on the Media Campaign, which will contain all Commitments used for this specific Campaign.

 

Campaign Item Commitment Condition Fields:

Similar to Media Campaigns, we’re also deprecating the lookup fields on the Campaign Item object. For now editing or setting those fields will not cause any errors, but will also not be used by any ADvendio features.

The following fields are affected by this:

  • Rebate in Kind Condition

  • TPC Condition

  • Agency Earnings Condition

  • Scaled Discount Condition

  • Special Discount Condition

Again, we now provide a related list, which will contain all relevant, applied conditions to a Campaign Item:

 

Why are we doing this?

Goal of our Commitment changes is, to make the feature more flexible and comfortable for you. In the past it was only possible use one Commitment of each type for a Media Campaign and also only one Commitment Condition of each type was used for a Campaign Item.

Now you have much more flexible ways to structure your Commitments and also use multiple Commitments for Media Campaigns. This helps us to cover the more complex business scenarios. Have a look what is possible with version 2.141: https://advendio.atlassian.net/wiki/spaces/SO/pages/2281209902/4.16.2+How+to+Assign+Commitments+to+Media+Campaigns

How do these changes affect me?

The fields listed above are deprecated, this means they will not be used by any features or functions within ADvendio anymore. In case of the Media Campaign fields, we build in an additional validation on the lookup fields on. This prevents you from performing any changes to these fields. Existing Campaign can still be used as before, but when creating for example a new Campaign, you need to leave the fields blank.

 

Remove Deprecated fields from any customization and layouts

The fields which will be deprecated with this change are:

Media Campaign

  • Commitment

  • Agency Earning Commitment

  • Third Party Commitment

Campaign Item:

  • Rebate in Kind Condition

  • TPC Condition

  • Agency Earnings Condition

  • Scaled Discount Condition

  • Special Discount Condition

If you have any custom components which refer to these fields, please remove the reference, to ensure that all features will work properly and all relevant information will be shown.

This contains for example:

  • Custom Reports

  • Page Layouts

  • Validation Rules

  • Workflow Rules

  • Any process automation (like Flows, Process Builder or similar)

Consider also processes or uploads of Media Campaigns, which should not contain any of the deprecated fields anymore.

Migration of existing date

Existing Media Campaigns still work as expected. We enhanced our own ADvendio feature, so that they will help to automatically migrate your existing Media Campaign to the new format (for example the Commitment Selector, the commitment apply button, the Media Configuration). This means you will not have to actively change your existing Media Campaigns!

Add new relations to Layouts

In order to fully utilize the feature make sure to display the new relations and add relevant objects to the permissions of your users.

This covers two new objects:

  • Selected Commitment

  • Applied Commitment Condition

Add these objects and all fields in them to the permission sets or user profiles (if relevant). You can also add them as related list to the Media Campaign and Campaign Item page layouts.