8.4.4.1 Optimizer Feature Settings
You can configure 4.11 Optimizer by following the navigation to the respective Feature Setting record. Go to the App Launcher and search for Feature Settings.Â
Configure the Optimizer Buttons
By default, there are two buttons in the Optimizer which are set depending on the selection the user made for the optimization reason (proactive or reactive)
Proactive/Order Optimization
Â
Reactive/Order Amendment
Navigate to Feature Settings and create or modify the following record:
Feature Setting Name:Â ButtonNames
Feature Name: Optimizer
Template Name:Â Reactive ORÂ Proactive
Value:Â Edit Items (Optimizer); Add Items (Optimizer) ... depending on your needs.
Note: Please make sure to keep the Feature Setting Name, Feature Name, and Template Name exactly as specified and modify the values as you like. These buttons are used in the Tab Setup to specify the tabs and fields, that should be displayed using this button (Feature Assignments). If you want to rename the buttons Edit Items (Optimizer) or Add Items (Optimizer), please use the Custom Labels "AddItemsOptimizerButton" and "EditItemsOptimizerButton" to create custom translations. You can remove those buttons, if you don't need them or add custom buttons, that also appear at the Feature Assignment for Tab Setup and Tab Rules. Moreover, the "Proactive" record is displayed as "Order Optimization" in the picklist and the "Reactive" record as "Order Amendment".
Configure the Fields Of "Original Item" Listview
You have the option to define which fields the Optimizer shows in the second step. This enables you to display for example the video metrics or other fields which are important for your optimization.Â
This feature setting defines which fields of the original Campaign Items on optimizer page 2 should be displayed. If not defined ADvendio used the following default fields:
ADvendio__from_Date__c
ADvendio__until_Date__c
ADvendio__Billing_Category__c
ADvendio__Quantity__c
ADvendio__Delivered_Impressions__c
ADvendio__Last_Deliverystats_Update__c
Navigate to Feature Settings and create or modify the following record:
Feature Name = Optimizer
Feature Setting Name = ConfigurableDisplayFieldsOfOriginalItem
TemplateName: leave empty
Value: Semicolon separated list of field names (with ADvendio Prefix)
Configure the Fields Of "Optimized Item" Listview
This feature setting defines which fields of the optimized Campaign Items on optimizer page 2 (bottom part) should be displayed. Â Navigate to Feature Settings and create or modify the following record:
Feature Name = Optimizer
Feature Setting Name =Â ConfigurableDisplayFieldsOfOptimizedItem
TemplateName: leave empty
Value: Semicolon separated list of field names (with ADvendio Prefix)
Configure Fixes Fields
Navigate to Feature Settings and create or modify the following record:
Feature Setting Name:Â OverviewFixFields
Feature Name: Optimizer
Template Name:
Value:Â Name;ADvendio__Amount_net3__c;ADvendio__Ad_Price__r.ADvendio__Ad_spec__r.ADvendio__Placement__r.ADvendio__Site__r.Name;ADvendio__Sales_Price__c
Note: Please make sure to keep the Feature Setting Name and Feature Name exactly as specified and modify the values as you like. Please use your field path and enter your fields' semicolon-separated in the field Value as you can see above.
When the feature setting is saved this will update the Optimizing overview table in the Optimizing version activation object.
Change the Required Fields
Navigate to Feature Settings and create records to customize the Optimizer:
Feature Setting Name:Â RequiredOptimizingVersionFields
Feature Name: Optimizer
Template Name: <leave blank>
Value: Semicolon separated list of field names lower-case only; depending on your needs
i.e. "Name; ADvendio__amount_net__c; ADvendio__amount_net_net__c; ADvendio__Amount_net3__c; ADvendio__Ad_Price__r.ADvendio__Ad_spec__r.ADvendio__Placement__r.ADvendio__Site__r.Name; ADvendio__Sales_Price__c"
Disable Items for Optimization
Available with Version 2.111 and higher
If you like, you can further configure which Items are available for optimization and which not. You can define, that if a Campaign Item matches certain criteria, it will not be usable in the Optimizer. Those Items will be shown as disabled. The Checkbox will not be selectable and a little icon is shown, with a short explanation, why this item is disabled.
To configure this, navigate to Feature Settings and create the following records:
Feature Setting Name:Â DoNotAllowOptimizationCriterion
Feature Name: Optimizer
Template Name:Â Reactive ORÂ Proactive
Value: The name of the field you like to compare and the required value. Please use the full API name of the field (ADvendio__fieldname__c), for your own custom fields it would be (fieldname__c) . You can use either equals (=) or not equals (!=) to compare it to the desired value.Â
You can create one feature setting for reactive and one for proactive optimizations.
Additional Hints for the filter criteria
Please keep in mind, that it's currently only possible to use a single field and value as matching criteria. Also it's only possible to match on fields from the Object Campaign Item.
If you want to use a Checkbox for comparison, please use "=true" or "=false" as comparison
If you are using a number field, use "." as decimal point, even if your locale uses different symbols (e.g. 1000.99)
If you want to filter for certain Record Types, you will need to use the ID of the Record Type, not the name. (e.g. RecordTypeId!=012A00000012g4fIAA)
Attention: the matching currently doesn't work with Formula Fields
Change the information displayed to your users:
If you like to change the message displayed to you can do so by going to Setup → Custom Labels. Search for the following labels:
OptimizerProactiveFilterHelpText → For proactive Optimizations
OptimizerReactiveFilterHelpText → For reactive Optimizations
You can add a manual translation and if you do so, this text will be shown to your users instead of the ADvendio default text.
Examples, of how to use this:
Let's say once your sales process hits a certain stage, where your customer already agreed to the offer, and you want to prevent proactive Optimization.
To mark your Campaign Items, you will create a custom Formula Field with a Checkbox and the criteria: If Media Campaign Stage = "Booked", set this Checkbox true. Now we need to teach the optimizer to ignore all items where this Checkbox is true.
We create a new Feature Setting, as described above.
The Template Name for our Feature Setting will be "Proactive"
The Value will be: "YourCustomCheckbox__c=true"
Now, if a Campaign Item has this Checkbox set it will be disabled in the proactive Optimizer. If you do a reactive Optimization, it will, however, still be available.
As this is a very specific criterion, we want to inform our users properly, why their Items are not available in the Optimizer. To do so, we want to create a new translation for a custom Label.
Go to Setup → Custom Labels
Search for a label named:
Click on the new button in the translation section.
Select the language you are using and enter your custom text, like: "Once an Item reached the stage booked, it can't be optimized proactively, please use the reactive optimization mode."
Configure cancellation options
By default, when activating an optimization, there are three cancellation options available: Cancellation Standard (Per Period), Cancellation and merge periods and Cancellation and merge all.Â
To configure which options are available to your ADvendio users, you can use the ModeAvailability Feature Setting. Navigate to Feature Settings and create or modify* the following record:
Feature Name =Â Finance
Feature Setting Name =Â ModeAvailability
TemplateName:Â InvoiceCancelation
Value:Â {"CancelationPerPeriod": true, "CancelationMergePeriod": true, "CancelationMergeAll": true}
Change value to true or false depending on the need
* This Feature Setting can also be created by running the post-install script for Version 2.115.
ADvendio.PostInstall.runMethod('insertFeatureSettingsForInvoiceCancelationModeAvailabilityByVersion2_115', null);