{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"In order to use the Optimizer API, your Salesforce Org needs to have API usage activated through having an API usage license as well as having the finance module activated with the finance license.","type":"text"}]}]},{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"numberedheadings","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"00dd658b-3ff6-417b-a00f-63a516eee384"},"schemaVersion":{"value":"1"},"title":"Numbered Headings"}},"localId":"27fc54f2-acfa-4f95-b978-8cc645199c6e"},"content":[{"type":"paragraph","content":[{"text":"The Optimizer API is implemented as Apex class and is exposed as REST web service by using Salesforce standard functionality (see ","type":"text"},{"text":"Apex Developer Guide","type":"text","marks":[{"type":"link","attrs":{"href":"https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_rest.htm"}}]},{"text":" for more information). For general information about the Optimizer feature, see ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://advendio.atlassian.net/wiki/spaces/SO/pages/60325936"}},{"text":" ","type":"text"},{"text":".","type":"text","marks":[{"type":"link","attrs":{"href":"http://advendio.atlassian.net/wiki/spaces/SO/pages/115015707/4.16+Commitments"}}]},{"text":" The Create Optimization functionality compares the given Campaign Items to the existing Campaign Items from the database and creates an Optimizer Version containing all the changes/differences.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Please note that this API does not create the optimizing version record in your instance. To create the necessary records please take a look at the official Salesforce documentation about the creation of records via API: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/dome_composite_sobject_tree_create.htm"}},{"text":" . ","type":"text"},{"type":"hardBreak"},{"text":"At least it will be needed to set the ","type":"text"},{"text":"ADvendio__Source__c","type":"text","marks":[{"type":"code"}]},{"text":" field of the ","type":"text"},{"text":"ADvendio__OptimizingVersion__c","type":"text","marks":[{"type":"code"}]},{"text":" record and the ","type":"text"},{"text":"ADvendio__OptimizingVersion__c","type":"text","marks":[{"type":"code"}]},{"text":" field of the ","type":"text"},{"text":"ADvendio__OptimizingChange__c","type":"text","marks":[{"type":"code"}]},{"text":" records which got returned by the API (as already visible in the example code at the bottom of the page).","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"REST web service","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"URL","type":"text"}]},{"type":"paragraph","content":[{"text":"https://.my.salesforce.com/services/apexrest/ADvendio/ADvendio__Campaign_Item__c/CreateOptimization/","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Method","type":"text"}]},{"type":"paragraph","content":[{"text":"PATCH","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"URL Params","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Data Params","type":"text"}]},{"type":"paragraph","content":[{"text":"A JSON object with the attribute ","type":"text"},{"text":"campaignItems","type":"text","marks":[{"type":"em"}]},{"text":", containing a JSON serialized list of Campaign Items.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example","type":"text","marks":[{"type":"strong"}]},{"text":": { \"campaignItems\":[{}, ...]}","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Success Response","type":"text"}]},{"type":"paragraph","content":[{"text":"Code","type":"text","marks":[{"type":"strong"}]},{"text":": 200","type":"text"}]},{"type":"paragraph","content":[{"text":"Content: ","type":"text","marks":[{"type":"strong"}]},{"text":"A JSON serialised Optimization (ADvendio__OptimizingVersion__c) record including all Optimizer Changes (ADvendio__OptimizingChange__c)","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Error Response","type":"text"}]},{"type":"paragraph","content":[{"text":"See ","type":"text"},{"text":"Salesforce Apex REST Documentation","type":"text","marks":[{"type":"link","attrs":{"href":"https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_rest_methods.htm"}}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Logic","type":"text"}]},{"type":"paragraph","content":[{"text":"When creating an Optimization, the Optimizer will create an Optimizing Change record for every single changed field. Optimizing Change contains a reference to the original Campaign Item, the old value, the new value and the developer name of the field.","type":"text"}]},{"type":"paragraph","content":[{"text":"Special cases:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"related lists: When changing data, that is stored in related lists (Content, Targeting Sets), the old and new values contain a comma separated list of record ids.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"new positions: When adding new Campaign Items during the optimization process, we need to store all (required/set) fields of the Campaign Item. Since there is no existing version of that Campaign Item but we have a master-detail relationship, the Optimizer uses a random Campaign Item Id from the same Media Campaign for the Campaign Item field. In the field ","type":"text"},{"text":"ADvendio__NewCiIdentifier__c","type":"text","marks":[{"type":"em"}]},{"text":" a dummy Id is saved to be able to identify what change belongs to what Campaign Item in case of adding more than one Campaign Item.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Please note that this API does not create the optimizing version record in your instance. To create the necessary records please take a look at the official Salesforce documentation about the creation of records via API: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/dome_composite_sobject_tree_create.htm"}},{"text":" . ","type":"text"},{"type":"hardBreak"},{"text":"At least it will be needed to set the ","type":"text"},{"text":"ADvendio__Source__c","type":"text","marks":[{"type":"code"}]},{"text":" field of the ","type":"text"},{"text":"ADvendio__OptimizingVersion__c","type":"text","marks":[{"type":"code"}]},{"text":" record and the ","type":"text"},{"text":"ADvendio__OptimizingVersion__c","type":"text","marks":[{"type":"code"}]},{"text":" field of the ","type":"text"},{"text":"ADvendio__OptimizingChange__c","type":"text","marks":[{"type":"code"}]},{"text":" records which got returned by the API (as already visible in the example code at the bottom of the page).","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Pseudo code for creating the changes. This should help to collect the data for the insert via salesforce rest api:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"for (campaignItem : optimizedCampaignItems) {\n\tfor (field : creatableCampaignItemFields) {\n\t\tchanges.add(new OptimizingChange__c(\n\t\t\tCampaignItem__c = campaignItem.isNew() ? IdFromAnyCampaignItemFromTheSameMc : originalCampaignItem['Id'],\n\t\t\tNewCiIdentifier__c = campaignItem.isNew() ? campaignItem['Id'] : null,\n\t\t\tFieldName__c = field,\n\t\t\tOptimizedValue__c = campaignItem[field],\n\t\t\tOriginalValue__c = originalCampaignItem[field]\n\t\t));\n\t}\n\tchanges.addAll(createChangesForSpecialTargeting());\n}","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Examples","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Get a Session-ID","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v https://login.salesforce.com/services/oauth2/token -d \"grant_type=password\" -d \"client_id=\" -d \"client_secret=\" -d \"username=\" -d \"password=\" -H 'X-PrettyPrint:1'","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Get CLIENT_ID and CLIENT_SECRET from any connected app or create a new app in your org: App Manager -> New Connected App","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"Simple request","type":"text"}]},{"type":"paragraph","content":[{"text":"A simple request with a Campaign Item to change the Quantity from 1000 to 2000.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Call Optimizer web service","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl https://.my.salesforce.com/services/apexrest/ADvendio/ADvendio__Campaign_Item__c/CreateOptimization/ -H 'Authorization: Bearer ' -H \"Content-Type: application/json\" -H 'X-PrettyPrint:1' -d @requestBody.txt --request PATCH","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"type":"hardBreak"},{"text":"requestBody.txt","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n\t\"campaignItems\":[\n\t\t{\n\t\t\t\"Id\":\"a0HA000000SNYF4MAP\",\n\t\t\t\"ADvendio__Quantity__c\":2000\n\t\t}\n\t]\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"type":"hardBreak"},{"text":"Response","type":"text"}]},{"type":"codeBlock","content":[{"text":"[\n {\n \"attributes\":{\n \"type\":\"ADvendio__OptimizingVersion__c\",\n \"Name\":\"2_30.07.2020\",\n \"ADvendio__MediaCampaign__c\":\"a1E2K00000KEBpOUAX\",\n \"CurrencyIsoCode\":\"EUR\",\n \"ADvendio__OptimizingChanges__r\":{\n \"totalSize\":1,\n \"done\":true,\n \"records\":[\n {\n \"attributes\":{\n \"type\":\"ADvendio__OptimizingChange__c\",\"url\":\"/services/data/v49.0/sobjects/ADvendio__OptimizingChange__c/a1H2K00000iD0q8UAC\"\n },\n \"ADvendio__CampaignItem__c\":\"a0Y2K00000Fe82gUAB\",\n \"ADvendio__FieldName__c\":\"advendio__quantity__c\",\n \"ADvendio__OriginalValue__c\":\"1000.00\",\n \"ADvendio__OptimizedValue__c\":\"2000.00\",\n \"CurrencyIsoCode\":\"EUR\"\n }\n ]\n }\n }\n ]","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"hardBreak"},{"text":"Cancel an existing Campaign Item example","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Call Optimizer web service","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl https://.my.salesforce.com/services/apexrest/ADvendio/ADvendio__Campaign_Item__c/CreateOptimization/ -H 'Authorization: Bearer ' -H \"Content-Type: application/json\" -H 'X-PrettyPrint:1' -d @requestBody.txt --request PATCH","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":4},"content":[{"text":"requestBody.txt","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"campaignItems\":[\n {\n \"ADvendio__Media_Campaign__c\":\"a1E2K00000LnfyCUAR\",\n \"Id\":\"a0Y2K00000EsFaSUAV\",\n \"ADvendio__Quantity__c\":0,\n \"ADvendio__BillingStatus__c\":\"canceled\"\n }\n ]\n}","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Response","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"attributes\": {\n \"type\": \"ADvendio__OptimizingVersion__c\"\n },\n \"ADvendio__MediaCampaign__c\": \"a1E2K00000LnfyCUAR\",\n \"ADvendio__OptimizingChanges__r\": {\n \"totalSize\": 2,\n \"done\": true,\n \"records\": [\n {\n \"attributes\": {\n \"type\": \"ADvendio__OptimizingChange__c\"\n },\n \"ADvendio__CampaignItem__c\": \"a0Y2K00000EsFaSUAV\",\n \"ADvendio__FieldName__c\": \"advendio__quantity__c\",\n \"ADvendio__OptimizedValue__c\": \"0.0\",\n \"ADvendio__OriginalValue__c\": \"1.00\",\n \"CurrencyIsoCode\": \"EUR\"\n },\n {\n \"attributes\": {\n \"type\": \"ADvendio__OptimizingChange__c\"\n },\n \"ADvendio__CampaignItem__c\": \"a0Y2K00000EsFaSUAV\",\n \"ADvendio__FieldName__c\": \"advendio__billingstatus__c\",\n \"ADvendio__OptimizedValue__c\": \"canceled\",\n \"ADvendio__OriginalValue__c\": \"created\",\n \"CurrencyIsoCode\": \"EUR\"\n }\n ]\n },\n \"CurrencyIsoCode\": \"EUR\",\n \"Name\": \"164_13.10.2020\"\n}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Add a new Campaign Item example","type":"text"}]},{"type":"paragraph","content":[{"text":"A simple request to add a new Campaign Item. There has to be an existing Media Campaign with at least one Campaign Item.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Call Optimizer web service","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl https://.my.salesforce.com/services/apexrest/ADvendio/ADvendio__Campaign_Item__c/CreateOptimization/ -H 'Authorization: Bearer ' -H \"Content-Type: application/json\" -H 'X-PrettyPrint:1' -d @requestBody.txt --request PATCH","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"type":"hardBreak"},{"text":"requestBody.txt","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"campaignItems\":[\n {\n \"ADvendio__Media_Campaign__c\":\"a1E2K00000KEBpOUAX\",\n \"ADvendio__Ad_Price__c\":\"a0HA000000Sn0X6MAJ\",\n \"ADvendio__Quantity__c\":1000,\n \"ADvendio__Sales_Price__c\": 30,\n \"ADvendio__from_Date__c\":\"2020-07-30 00:00:00\",\n \"ADvendio__until_Date__c\":\"2020-07-30 00:00:00\",\n \"ADvendio__SelectedContent__r\":{\n \"records\":[\n {\n \"ADvendio__Content__c\":\"a0eA000000GcZkIIAV\"\n },{\n \"ADvendio__Content__c\":\"a0e2K000007NukcQAC\"\n }\n ]\n }\n }\n ]\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"type":"hardBreak"},{"text":"Response","type":"text"}]},{"type":"codeBlock","content":[{"text":"[\n {\n \"attributes\":{\n \"type\":\"ADvendio__OptimizingVersion__c\",\"url\":\"/services/data/v49.0/sobjects/ADvendio__OptimizingVersion__c/a1I2K00000FwP7fUAF\"\n },\n \"Name\":\"2_30.07.2020\",\n \"ADvendio__MediaCampaign__c\":\"a1E2K00000KEBpOUAX\",\n \"CurrencyIsoCode\":\"EUR\",\n \"ADvendio__OptimizingChanges__r\":{\n \"totalSize\":88,\n \"done\":true,\n \"records\":[\n {\n \"attributes\":{\n \"type\":\"ADvendio__OptimizingChange__c\", \n },\n \"ADvendio__CampaignItem__c\":\"a0Y2K00000Fe82gUAB\", \n \"ADvendio__FieldName__c\":\"name\", \n \"ADvendio__OptimizedValue__c\":\"Test Name\", \n \"ADvendio__NewCiIdentifier__c\":\"a0YXX00XX0000012MA\", \n \"CurrencyIsoCode\":\"EUR\"\n },{ \n \"attributes\":{\n \"type\":\"ADvendio__OptimizingChange__c\", \n \"url\":\"/services/data/v49.0/sobjects/ADvendio__OptimizingChange__c/a1H2K00000iD0qNUAS\"\n },\n \"ADvendio__CampaignItem__c\":\"a0Y2K00000Fe82gUAB\", \n \"ADvendio__FieldName__c\":\"advendio__ad_price__c\", \n \"ADvendio__OptimizedValue__c\":\"a0HA000000Sn0X6MAJ\", \n \"ADvendio__NewCiIdentifier__c\":\"a0YXX00XX0000012MA\", \n \"CurrencyIsoCode\":\"EUR\"\n },{ \n \"attributes\":{\n \"type\":\"ADvendio__OptimizingChange__c\", \n \"url\":\"/services/data/v49.0/sobjects/ADvendio__OptimizingChange__c/a1H2K00000iD0qpUAC\"\n },\n \"ADvendio__CampaignItem__c\":\"a0Y2K00000Fe82gUAB\", \n \"ADvendio__FieldName__c\":\"advendio__quantity__c\", \n \"ADvendio__OptimizedValue__c\":\"1000.00\", \n \"ADvendio__NewCiIdentifier__c\":\"a0YXX00XX0000012MA\", \n \"CurrencyIsoCode\":\"EUR\"\n },{ \n \"attributes\":{\n \"type\":\"ADvendio__OptimizingChange__c\", \n \"url\":\"/services/data/v49.0/sobjects/ADvendio__OptimizingChange__c/a1H2K00000iD0r1UAC\"\n },\n \"ADvendio__CampaignItem__c\":\"a0Y2K00000Fe82gUAB\", \n \"ADvendio__FieldName__c\":\"advendio__from_date__c\", \n \"ADvendio__OptimizedValue__c\":\"2020-07-30 00:00:00\", \n \"ADvendio__NewCiIdentifier__c\":\"a0YXX00XX0000012MA\", \n \"CurrencyIsoCode\":\"EUR\"\n },{ \n \"attributes\":{\n \"type\":\"ADvendio__OptimizingChange__c\", \n \"url\":\"/services/data/v49.0/sobjects/ADvendio__OptimizingChange__c/a1H2K00000iD0r2UAC\"\n },\n \"ADvendio__CampaignItem__c\":\"a0Y2K00000Fe82gUAB\", \n \"ADvendio__FieldName__c\":\"advendio__until_date__c\", \n \"ADvendio__OptimizedValue__c\":\"2020-07-30 00:00:00\", \n \"ADvendio__NewCiIdentifier__c\":\"a0YXX00XX0000012MA\", \n \"CurrencyIsoCode\":\"EUR\"\n },{\n \"attributes\":{\n \"type\":\"ADvendio__OptimizingChange__c\",\n \"url\":\"/services/data/v49.0/sobjects/ADvendio__OptimizingChange__c/a1H2K00000iD0yYUAS\"\n },\n \"ADvendio__CampaignItem__c\":\"a0Y2K00000Fe82gUAB\",\n \"ADvendio__FieldName__c\":\"advendio__selectedcontent__r\",\n \"ADvendio__OptimizedValue__c\":\"a0eA000000GcZkIIAV,a0e2K000007NukcQAC\",\n \"CurrencyIsoCode\":\"EUR\"\n }\n ]\n }\n }\n]","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Usage in Apex","type":"text"}]},{"type":"codeBlock","content":[{"text":"List cis = ...\nADvendio__OptimizingVersion__c optimizingVersion = ADvendio.OptimizerService.createOptimization(cis);\noptimizingVersion.ADvendio__Source__c = 'reactive'; // set OptimizerVersion fields as you need them\ninsert optimizingVersion;\n\nList changes = new List();\nfor (ADvendio__OptimizingChange__c change : optimizingVersion.ADvendio__OptimizingChanges__r) {\n change.ADvendio__OptimizingVersion__c = optimizingVersion.Id;\n changes.add(change);\n}\ninsert changes;","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}

Optimizer API - Documentation

Related content