{"type":"doc","content":[{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"expand","attrs":{"title":"Content"},"content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Table of Contents","type":"text"}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"maxLevel":{"value":"2"}},"macroMetadata":{"macroId":{"value":"ab3f188b-a9ee-41bb-bb8b-561f55746cd7"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}}}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"In order to use the Forecast API, your Salesforce Org needs to have API usage activated through having an API usage License. ","type":"text"}]},{"type":"paragraph","content":[{"text":"We also recommend you to automate the OAuth access to avoid authorization issues: ","type":"text"},{"text":"1.6 How to authenticate / authorize ADvendio Gateway for the use of our Third Party System integrations? - Authorize ADvendio message / OAuth#Setup:","type":"text","marks":[{"type":"link","attrs":{"href":"https://advendio.atlassian.net/wiki/spaces/SO/pages/2861105153#id-1.6Howtoauthenticate/authorizeADvendioGatewayfortheuseofourThirdPartySystemintegrations?AuthorizeADvendiomessage/OAuth-Setup%3A"}}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"bodiedExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"numberedheadings","parameters":{"macroParams":{"start-numbering-with":{"value":"1"}},"macroMetadata":{"macroId":{"value":"d08939d6-a6b4-4c6e-a850-e5b954dc421e"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"icon","data":{"url":"https://numberedheadings.bobswift.appfire.app/logo-black-72.png"}}],"title":"Numbered Headings"}}},"content":[{"type":"paragraph","content":[{"text":"The Forecast API function 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 Forecast API feature, see ","type":"text"},{"text":"4.4 Availability Forecast.","type":"text","marks":[{"type":"link","attrs":{"href":"https://advendio.atlassian.net/wiki/spaces/SO/pages/622704"}}]}]},{"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://.","type":"text"},{"text":"my.salesforce.com/services/apexrest/ADvendio/ADvendio__Campaign_Item__c/CheckAvailability/","type":"text"}]},{"type":"paragraph","content":[{"text":"https://.","type":"text"},{"text":"my.salesforce.com/services/apexrest/ADvendio/ADvendio__Campaign_Item__c/JobUpdates/","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"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":"paragraph","content":[{"text":"-","type":"text","marks":[{"type":"code"}]}]},{"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":"paragraph","content":[{"text":"See ","type":"text"},{"text":"Campaign Item - Data Format","type":"text","marks":[{"type":"link","attrs":{"href":"https://advendio.atlassian.net/wiki/spaces/AD/pages/852000769"}}]},{"text":" for detailed information about the internal data structure of the Campaign Item.","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 serialized list of the Campaign Items from the request body, but now with updated availability and status fields.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example","type":"text","marks":[{"type":"strong"}]},{"text":": [{}, ...]","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":"The ","type":"text"},{"text":"CheckAvailability","type":"text"},{"text":" web service function returns the availabilities for all Campaign Items not connected to an Ad Server and starts the availability check for the Campaign Items that are connected to an Ad Server. If an availability check job was started the job information will be saved to the field ","type":"text"},{"text":"ADvendio__MostRecentGatewayJobInformation__c","type":"text","marks":[{"type":"em"}]},{"text":". The returned Campaign Item can now be used to get the job results by using the ","type":"text"},{"text":"JobUpdates","type":"text"},{"text":" function.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"The following fields are updated by the ","type":"text"},{"text":"CheckAvailability or ","type":"text"},{"text":"JobUpdates","type":"text"},{"text":" function.","type":"text"}]},{"type":"table","content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Campaign Item Field","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Data format","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Note","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"ADvendio__AvailabilityRunning__c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Number","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":3},"content":[{"type":"paragraph","content":[{"text":"Campaign Item start time < NOW()","type":"text"}]},{"type":"paragraph","content":[{"text":"AND","type":"text"}]},{"type":"paragraph","content":[{"text":"Already submitted to the Ad Server","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"ADvendio__ReservedImpressionsRunning__c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Number","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"ADvendio__MatchedImpressionsRunning__c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Number","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"ADvendio__Availability__c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Number","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":3},"content":[{"type":"paragraph","content":[{"text":"Campaign Item start time > NOW()","type":"text"}]},{"type":"paragraph","content":[{"text":"OR","type":"text"}]},{"type":"paragraph","content":[{"text":"Not yet submitted to the Ad Server","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"ADvendio__ReservedImpressionsPlanned__c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Number","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"ADvendio__MatchedImpressionsPlanned__c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Number","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"ADvendio__Share_of_Voice__c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Percent","type":"text","marks":[{"type":"textColor","attrs":{"color":"#080707"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"100 * Matched / BookingQuantity","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"ADvendio__LastAvailabilityForecast__c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Date/Time","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"NOW()","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"ADvendio__MostRecentGatewayJobInformation__c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"JSON String:","type":"text"}]},{"type":"paragraph","content":[{"text":"{\"jobId\":123456,","type":"text"},{"type":"hardBreak"},{"text":" \"campaignItemId\":\"a0Y000000000001EAA\"","type":"text"},{"type":"hardBreak"},{"text":" \"status\":{","type":"text"},{"type":"hardBreak"},{"text":" \"progress\":1,","type":"text"},{"type":"hardBreak"},{"text":" \"message\":\"Finish Job\",","type":"text"},{"type":"hardBreak"},{"text":" \"status\":2,","type":"text"},{"type":"hardBreak"},{"text":" \"start\":\"2019-09-02T07:34:37.000+0000\", ","type":"text"},{"type":"hardBreak"},{"text":" \"operation\":\"Forecast\",","type":"text"},{"type":"hardBreak"},{"text":" \"orgId\":\"00D1x0000008bZ9EAI\"","type":"text"},{"type":"hardBreak"},{"text":"}}","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"If an Ad Server is connected the availability will be asynchonously checked by the Ad Server Gateway.","type":"text"}]},{"type":"paragraph","content":[{"text":"This field is used to store information about the asynchronous job.","type":"text"}]},{"type":"paragraph","content":[{"text":"campaignItemId:","type":"text","marks":[{"type":"strong"}]},{"text":" If there is no Campaign Item id, we need an identifier to map back the results, so a fake id is automatically generated.","type":"text"}]},{"type":"paragraph","content":[{"text":"progress","type":"text","marks":[{"type":"strong"}]},{"text":": A value between 0 and 1 to show the progress of the job. Starts with 0 and is finished when it reatches 1.","type":"text"}]},{"type":"paragraph","content":[{"text":"message","type":"text","marks":[{"type":"strong"}]},{"text":": Message about the job status","type":"text"}]},{"type":"paragraph","content":[{"text":"status","type":"text","marks":[{"type":"strong"}]},{"text":": Queued = 0, In progress = 1, completed = 2, failed = 3","type":"text"}]},{"type":"paragraph","content":[{"text":"start","type":"text","marks":[{"type":"strong"}]},{"text":": The the time stamp when the job was started.","type":"text"}]},{"type":"paragraph","content":[{"text":"operation","type":"text","marks":[{"type":"strong"}]},{"text":": For Check Availability always \"Forecast\".","type":"text"}]},{"type":"paragraph","content":[{"text":"orgId","type":"text","marks":[{"type":"strong"}]},{"text":": The Salesforce org id.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"ADvendio__SelectedContent__r.ADvendio__Availability__c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"JSON:","type":"text"}]},{"type":"paragraph","content":[{"text":"{ \"version\":1,","type":"text"},{"type":"hardBreak"},{"text":" \"availabilityPerTime\": {","type":"text"},{"type":"hardBreak"},{"text":" \"2020-01-01\":123,","type":"text"},{"type":"hardBreak"},{"text":" \"2020-02-01\":565","type":"text"},{"type":"hardBreak"},{"text":" }","type":"text"},{"type":"hardBreak"},{"text":"}","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"If there is Content linked to the Campaign Item at it is no AdServer connected, the availability will be checked per content per time frame. Time frames are days for CPD, weeks for CPW, months for CPMo, years for CPY and the Campaign Item run time for Fixed Price billing category.","type":"text"}]},{"type":"paragraph","content":[{"text":"version","type":"text","marks":[{"type":"strong"}]},{"text":": A version number for the JSON format in case we need to change it.","type":"text"}]},{"type":"paragraph","content":[{"text":"availabilityPerTime","type":"text","marks":[{"type":"strong"}]},{"text":": Map of the first date of a time frame to the availability number for that time frame.","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":"heading","attrs":{"level":5},"content":[{"text":"Get a Session ID","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"shell"},"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"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Connected App","type":"text"}]},{"type":"paragraph","content":[{"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","content":[{"text":"Enable ","type":"text"},{"text":"Enable OAuth Settings","type":"text","marks":[{"type":"textColor","attrs":{"color":"#27282e"}}]},{"text":" to see the consumer key (CLIENT_ID) and Consumer Secret (CLIENT_SECRET)","type":"text"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Minimal request","type":"text"}]},{"type":"paragraph","content":[{"text":"A simple request for a Campaign Item connected to an Ad Server (Google Ad Manager, other Ad Server may need additional information).","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Call Check Availability web service","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"curl https://.my.salesforce.com/services/apexrest/ADvendio/ADvendio__Campaign_Item__c/CheckAvailability/ -H 'Authorization: Bearer ' -H \"Content-Type: application/json\" -H 'X-PrettyPrint:1' -d @requestBody.txt --request PATCH","type":"text"}]},{"type":"paragraph","content":[{"text":"For CheckAvailability the following fields are required per Campaign Item: ","type":"text"},{"text":"ADvendio__from_Date__c, ADvendio__until_Date__c, ADvendio__Ad_Price__c","type":"text","marks":[{"type":"em"}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"requestBody.txt","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n\t\"campaignItems\":[\n\t\t{\n\t\t\t\"ADvendio__from_Date__c\" : \"2019-12-01\",\n\t\t\t\"ADvendio__until_Date__c\" : \"2019-12-31\",\n\t\t\t\"ADvendio__Ad_Price__c\" : \"a0HA000000LYVkQMAX\"\n\t\t}\n\t]\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Response","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"[ \n\t{\n\t\t\"attributes\" : {\n\t\t\t\"type\" : \"ADvendio__Campaign_Item__c\",\n\t\t},\n\t\t\"ADvendio__from_Date__c\" : \"2019-12-01\",\n\t\t\"ADvendio__until_Date__c\" : \"2019-12-31\",\n\t\t\"ADvendio__MostRecentGatewayJobInformation__c\" : \"{\\\"jobId\\\":440596,\\\"campaignItemId\\\":\\\"a0Y000000000001EAA\\\"}\",\n\t\t\"ADvendio__Ad_Price__c\" : \"a0HA000000LYVkQMAX\",\n\t\t\"Id\" : null\n\t}\n]","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Second call to get the job results some time later:","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Call Job Updates web service","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"curl https://.my.salesforce.com/services/apexrest/ADvendio/ADvendio__Campaign_Item__c/JobUpdates/ -H 'Authorization: Bearer ' -H \"Content-Type: application/json\" -H 'X-PrettyPrint:1' -d @requestBody1.txt --request PATCH","type":"text"}]},{"type":"paragraph","content":[{"text":"For the JobUpdates request the field ","type":"text"},{"text":"ADvendio__MostRecentGatewayJobInformation__c","type":"text","marks":[{"type":"em"}]},{"text":" is required. This contains the jobId and dummy campaignItemId to map the results back to each Campaign Item.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"requestBody1.txt","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n\t\"campaignItems\":[\n\t\t{\n\t\t\t\"ADvendio__MostRecentGatewayJobInformation__c\" : \"{\\\"jobId\\\":440596,\\\"campaignItemId\\\":\\\"a0Y000000000001EAA\\\"}\"\n\t\t}\n\t]\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Response","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"[ {\n \"attributes\" : {\n \"type\" : \"ADvendio__Campaign_Item__c\"\n },\n \"ADvendio__MatchedImpressionsPlanned__c\" : 156,\n \"ADvendio__ReservedImpressionsPlanned__c\" : 1,\n \"ADvendio__MostRecentGatewayJobInformation__c\" : \"{\\\"errors\\\":[{\\\"message\\\":null}],\\\"jobId\\\":440596,\\\"campaignItemId\\\":\\\"a0Y000000000001EAA\\\",\\\"status\\\":{\\\"jobId\\\":440596,\\\"orgId\\\":\\\"00DA0000000clAiMAI\\\",\\\"operation\\\":\\\"Forecast\\\",\\\"start\\\":\\\"2019-10-17T13:38:29.000+0000\\\",\\\"end\\\":\\\"2019-10-17T13:38:38.000+0000\\\",\\\"status\\\":2,\\\"message\\\":\\\"Finish Job\\\",\\\"progress\\\":1}}\",\n \"ADvendio__Share_of_Voice__c\" : 15600,\n \"ADvendio__Availability__c\" : 112\n} ]","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Request with some targeting","type":"text"}]},{"type":"paragraph","content":[{"text":"A request for a Campaign Item connected to an Ad Server including some targeting information. To simplify this, we're using Targeting Sets, which contain all Targeting Criteria. You will need to create those in advance in Salesforce. See ","type":"text"},{"text":"3.5.8 Create and Manage Targeting Sets","type":"text","marks":[{"type":"link","attrs":{"href":"https://advendio.atlassian.net/wiki/spaces/SO/pages/874840116"}}]},{"text":" for more information on that.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Call Check Availability web service","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"curl https://.my.salesforce.com/services/apexrest/ADvendio/ADvendio__Campaign_Item__c/CheckAvailability/ -H 'Authorization: Bearer ' -H \"Content-Type: application/json\" -H 'X-PrettyPrint:1' -d @requestBody.txt --request PATCH","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"requestBody.txt","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n\t\"campaignItems\":[\n\t\t{\n\t\t\t\"ADvendio__from_Date__c\" : \"2019-12-01\",\n\t\t\t\"ADvendio__until_Date__c\" : \"2019-12-31\",\n\t\t\t\"ADvendio__Ad_Price__c\" : \"a1CB0000002lK6RMAU\",\n\t\t\t\"ADvendio__FrequencyCapping__c\":\"2 per 1 campaign\",\n\t\t\t\"ADvendio__AdServerTargeting__c\" : \"{\\\"Geography\\\":{\\\"valL\\\":[{\\\"valS\\\":\\\"a14B0000001bZaoIAE\\\",\\\"type\\\":\\\"Id\\\"}],\\\"type\\\":\\\"List\\\",\\\"logic\\\":\\\"&&\\\"}}\",\n\t\t\t\"ADvendio__Media_Campaign__r\" : {\n\t\t\t\t\"ADvendio__Account__c\" : \"001A000001R6HDqIAN\"\n\t\t\t},\n\t\t\t\"ADvendio__SelectedTargetingSets__r\":{\"records\":[\n\t\t\t\t{\"ADvendio__TargetingSet__c\":\"a2f2K000000orLNQAY\"}\n\t\t\t]}\n\t\t}\n\t]\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Response","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"[ \n\t{\n\t\t\"attributes\" : {\n\t\t\t\"type\" : \"ADvendio__Campaign_Item__c\",\n\t\t\t\"url\" : \"/services/data/v46.0/sobjects/ADvendio__Campaign_Item__c/a0l1j000000ayRJAAY\"\n\t\t},\n\t\t\"ADvendio__from_Date__c\" : \"2019-12-01\",\n\t\t\"ADvendio__until_Date__c\" : \"2019-12-31\",\n\t\t\"ADvendio__MostRecentGatewayJobInformation__c\" : \"{\\\"jobId\\\":434663,\\\"campaignItemId\\\":\\\"a0Y000000000001EAA\\\"}\",\n\t\t\"ADvendio__Ad_Price__c\" : \"a1CB0000002lK6RMAU\",\n\t\t\"ADvendio__Media_Campaign__r\" : {\n\t\t\t\"attributes\" : {\n\t\t\t\t\"type\" : \"ADvendio__MediaCampaign__c\"\n\t\t\t},\n\t\t\t\"ADvendio__Account__c\" : \"001A000001R6HDqIAN\"\n\t\t},\n\t\t\"Id\" : null,\n\t\t\"ADvendio__FrequencyCapping__c\" : \"2 per 1 campaign\",\n\t\t\"ADvendio__AdServerTargeting__c\" : \"{\\\"Geography\\\":{\\\"valL\\\":[{\\\"valS\\\":\\\"a14B0000001bZaoIAE\\\",\\\"type\\\":\\\"Id\\\"}],\\\"type\\\":\\\"List\\\",\\\"logic\\\":\\\"&&\\\"}}\",\n\t\t\"ADvendio__SelectedTargetingSets__r\" : {\n\t\t \"totalSize\" : 0,\n\t\t \"done\" : false,\n\t\t \"records\" : [ {\n\t\t \"attributes\" : {\n\t\t \"type\" : \"ADvendio__SelectedTargetingSet__c\"\n\t\t },\n\t\t \"ADvendio__TargetingSet__c\" : \"a2f2K000000orLhQAI\"\n\t\t }]\n\t\t}\n\t}\n]","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Second call to get the job results some time later:","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Call Job Updates web service","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"curl https://.my.salesforce.com/services/apexrest/ADvendio/ADvendio__Campaign_Item__c/JobUpdates/ -H 'Authorization: Bearer ' -H \"Content-Type: application/json\" -H 'X-PrettyPrint:1' -d @requestBody1.txt --request PATCH","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"requestBody1.txt","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n\t\"campaignItems\":[\n\t\t{\n\t\t\t\"attributes\" : {\n \t\t\t\"type\" : \"ADvendio__Campaign_Item__c\",\n \t\t\t\"url\" : \"/services/data/v46.0/sobjects/ADvendio__Campaign_Item__c/a0l1j000000ayRJAAY\"\n \t\t\t},\n\t\t\t\"ADvendio__from_Date__c\" : \"2019-12-01\",\n\t\t\t\"ADvendio__until_Date__c\" : \"2019-12-31\",\n\t\t\t\"ADvendio__MostRecentGatewayJobInformation__c\" : \"{\\\"jobId\\\":434663,\\\"campaignItemId\\\":\\\"a0Y000000000001EAA\\\"}\",\n\t\t\t\"ADvendio__Ad_Price__c\" : \"a1CB0000002lK6RMAU\",\n\t\t\t\"ADvendio__Media_Campaign__r\" : {\n\t\t\t\t\"attributes\" : {\n\t\t\t\t\t\"type\" : \"ADvendio__MediaCampaign__c\"\n\t\t\t\t},\n\t\t\t\t\"ADvendio__Account__c\" : \"001A000001R6HDqIAN\"\n\t\t\t},\n\t\t\t\"Id\" : null,\n\t\t\t\"ADvendio__FrequencyCapping__c\" : \"2 per 1 campaign\",\n\t\t\t\"ADvendio__AdServerTargeting__c\" : \"{\\\"Geography\\\":{\\\"valL\\\":[{\\\"valS\\\":\\\"a14B0000001bZaoIAE\\\",\\\"type\\\":\\\"Id\\\"}],\\\"type\\\":\\\"List\\\",\\\"logic\\\":\\\"&&\\\"}}\",\n\t\t\t\"ADvendio__SelectedTargetingSets__r\" : {\n\t\t\t \"totalSize\" : 0,\n\t\t\t \"done\" : false,\n\t\t\t \"records\" : [ {\n\t\t\t \"attributes\" : {\n\t\t\t \"type\" : \"ADvendio__SelectedTargetingSet__c\"\n\t\t\t },\n\t\t\t \"ADvendio__TargetingSet__c\" : \"a2f2K000000orLNQAY\"\n\t\t\t } ]\n\t\t\t}\n\t\t}\n\t]\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Response","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"[\n {\n \"attributes\" : {\n \"type\" : \"ADvendio__Campaign_Item__c\",\n \"url\" : \"/services/data/v46.0/sobjects/ADvendio__Campaign_Item__c/a0l1j000000ayRJAAY\"\n },\n \"ADvendio__MatchedImpressionsPlanned__c\" : 24,\n \"ADvendio__from_Date__c\" : \"2019-12-01\",\n \"ADvendio__until_Date__c\" : \"2019-12-31\",\n \"ADvendio__ReservedImpressionsPlanned__c\" : 1,\n \"ADvendio__MostRecentGatewayJobInformation__c\" : \"{\\\"errors\\\":[{\\\"message\\\":null}],\\\"jobId\\\":434663,\\\"campaignItemId\\\":\\\"a0Y000000000001EAA\\\",\\\"status\\\":{\\\"jobId\\\":434663,\\\"orgId\\\":\\\"00DB0000000IE6XMAW\\\",\\\"operation\\\":\\\"Forecast\\\",\\\"start\\\":\\\"2019-10-10T14:50:26.000+0000\\\",\\\"end\\\":\\\"2019-10-10T14:50:32.000+0000\\\",\\\"status\\\":2,\\\"message\\\":\\\"Finish Job\\\",\\\"progress\\\":1}}\",\n \"ADvendio__Ad_Price__c\" : \"a1CB0000002lK6RMAU\",\n\"ADvendio__Media_Campaign__r\" : {\n\t\"attributes\" : {\n\t \"type\" : \"ADvendio__MediaCampaign__c\"\n\t},\n\t\"ADvendio__Account__c\" : \"001A000001R6HDqIAN\"\n },\n \"Id\" : null,\n \"ADvendio__FrequencyCapping__c\" : \"2 per 1 campaign\",\n \"ADvendio__Share_of_Voice__c\" : 2400,\n \"ADvendio__AdServerTargeting__c\" : \"{\\\"Geography\\\":{\\\"valL\\\":[{\\\"valS\\\":\\\"a14B0000001bZaoIAE\\\",\\\"type\\\":\\\"Id\\\"}],\\\"type\\\":\\\"List\\\",\\\"logic\\\":\\\"&&\\\"}}\",\n \"ADvendio__SelectedTargetingSets__r\" : {\n \"totalSize\" : 0,\n \"done\" : false,\n \"records\" : [ {\n \"attributes\" : {\n \"type\" : \"ADvendio__SelectedTargetingSet__c\"\n },\n \"ADvendio__TargetingSet__c\" : \"a2f2K000000orLNQAY\"\n } ]\n },\n \"ADvendio__Availability__c\" : 16\n }\n]","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Request for non adserver Campaign Items with Content","type":"text"}]},{"type":"paragraph","content":[{"text":"A request for a Campaign Item ","type":"text"},{"text":"not","type":"text","marks":[{"type":"strong"}]},{"text":" connected to an Ad Server with selected Content. ","type":"text"},{"text":"This will start the Exclusivity Check process inside of ADvendio","type":"text","marks":[{"type":"link","attrs":{"href":"https://advendio.atlassian.net/wiki/spaces/SO/pages/157155347/4.4.6+Check+Availability+for+Exclusive+Products"}}]},{"text":" instead of the Check Availability against the AdServer Gateway.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Call Check Availability web service","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"curl https://.my.salesforce.com/services/apexrest/ADvendio/ADvendio__Campaign_Item__c/CheckAvailability/ -H 'Authorization: Bearer ' -H \"Content-Type: application/json\" -H 'X-PrettyPrint:1' -d @requestBody.txt --request PATCH","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"requestBody.txt","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"campaignItems\":[\n {\n \"ADvendio__from_Date__c\" : \"2019-12-01\",\n \"ADvendio__until_Date__c\" : \"2019-12-31\",\n \"ADvendio__Ad_Price__c\" : \"a1CB0000002lK6RMAU\",\n \"ADvendio__SelectedContent__r\": {\n \"records\": [\n {\n \"attributes\": {\n \"type\": \"ADvendio__SelectedContent__c\"\n },\n \"ADvendio__Content__r\": {\n \"attributes\": {\n \"type\": \"ADvendio__Content__c\"\n },\n \"Id\": \"a2f2K000000orLNQAY\",\n \"ADvendio__ConstantQuantity__c\": \"Quantity\",\n \"ADvendio__MaximumApplicability__c\": 1,\n \"ADvendio__MaximumApplicabilityUnit__c\": \"Day\"\n }\n }\n ],\n \"done\": true\n }\n }\n ]\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Response","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"[\n {\n \"attributes\" : {\n \"type\" : \"ADvendio__Campaign_Item__c\",\n \"url\" : \"/services/data/v46.0/sobjects/ADvendio__Campaign_Item__c/a0l1j000000ayRJAAY\"\n },\n \"ADvendio__from_Date__c\" : \"2019-12-01\",\n \"ADvendio__until_Date__c\" : \"2019-12-31\",\n \"ADvendio__Ad_Price__c\" : \"a1CB0000002lK6RMAU\",\n \"ADvendio__SelectedContent__r\" : {\n \"totalSize\" : 1,\n \"done\" : false,\n \"records\" : [ {\n \"attributes\" : {\n \"type\" : \"ADvendio__SelectedContent__c\"\n },\n \"ADvendio__Content__c\" : \"a2f2K000000orLNQAY\"\n \"ADvendio__Availability__c\" : {\n\t\t\"version\":1,\n\t\t\"availabilityPerTime\" : {\n\t\t \"2019-12-01\" : 16\n\t\t}\n\t }\n } ]\n },\n \"ADvendio__Availability__c\" : 16\n }\n]","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Request for non adserver Campaign Items with Content (Inventory Forecast)","type":"text"}]},{"type":"paragraph","content":[{"text":"A request for a Campaign Item ","type":"text"},{"text":"not","type":"text","marks":[{"type":"strong"}]},{"text":" connected to an Ad Server with selected Content. ","type":"text"},{"text":"This will start the Exclusivity Check process inside of ADvendio","type":"text","marks":[{"type":"link","attrs":{"href":"https://advendio.atlassian.net/wiki/spaces/SO/pages/157155347/4.4.6+Check+Availability+for+Exclusive+Products"}}]},{"text":" instead of the Check Availability against the AdServer Gateway.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"requestBody.txt","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"{\n \"campaignItems\": [\n {\n \"ADvendio__from_Date__c\": \"2022-11-09\",\n \"ADvendio__until_Date__c\": \"2022-11-15\",\n \"ADvendio__Quantity__c\": \"2\",\n \"ADvendio__Frequency__c\": \"1\",\n \"ADvendio__RequestedContents__c\": \"1\",\n \"ADvendio__Ad_Price__c\": \"a0H2K00000VuuRDUAZ\",\n \"ADvendio__SelectedContent__r\": {\n \"records\": [\n {\n \"attributes\": {\n \"type\": \"ADvendio__SelectedContent__c\"\n },\n \"ADvendio__Content__c\": \"a0e2K00000fn85fQAA\"\n \n }\n ],\n \"totalSize\": 1,\n \"done\": true\n }\n }\n ]\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"responseBody","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"[\n {\n \"attributes\": {\n \"type\": \"ADvendio__Campaign_Item__c\",\n \"url\": \"/services/data/v46.0/sobjects/ADvendio__Campaign_Item__c/a0Y000000000001EAA\"\n },\n \"ADvendio__ContendingCampaignItems__c\": \"a0Y2K00000GEyltUAD\\na0Y2K00000GEymIUAT\",\n \"ADvendio__Quantity__c\": 2.0,\n \"ADvendio__Ad_Price__r\": {\n \"attributes\": {\n \"type\": \"ADvendio__Ad_price__c\",\n \"url\": \"/services/data/v46.0/sobjects/ADvendio__Ad_price__c/a0H2K00000VuuRDUAZ\"\n },\n \"Id\": \"a0H2K00000VuuRDUAZ\",\n \"ADvendio__Ad_Spec__c\": \"a0F2K00000QxD3LUAV\",\n \"ADvendio__MaximumApplicability__c\": 10.0000,\n \"ADvendio__MaximumApplicabilityUnit__c\": \"Week\",\n \"ADvendio__EffectiveMaximumApplicability__c\": 10.0000,\n \"ADvendio__EffectiveMaximumApplicabilityUnit__c\": \"Week\",\n \"ADvendio__ConstantQuantity__c\": \"Runtime Campaign Item\",\n \"ADvendio__Exclusive__c\": true,\n \"ADvendio__Ad_Spec__r\": {\n \"attributes\": {\n \"type\": \"ADvendio__Ad_Specs__c\",\n \"url\": \"/services/data/v46.0/sobjects/ADvendio__Ad_Specs__c/a0F2K00000QxD3LUAV\"\n },\n \"Id\": \"a0F2K00000QxD3LUAV\",\n \"ADvendio__Ad_Type__c\": \"a0G2K00001Uu7qTUAR\",\n \"RecordTypeId\": \"012A00000012g4SIAQ\",\n \"ADvendio__Placement__c\": \"a1M2K00000EhD7hUAF\",\n \"ADvendio__Ad_Type__r\": {\n \"attributes\": {\n \"type\": \"ADvendio__Ad_Type__c\",\n \"url\": \"/services/data/v46.0/sobjects/ADvendio__Ad_Type__c/a0G2K00001Uu7qTUAR\"\n },\n \"Id\": \"a0G2K00001Uu7qTUAR\"\n }\n }\n },\n \"ADvendio__SelectedContent__r\": {\n \"totalSize\": 1,\n \"done\": true,\n \"records\": [\n {\n \"attributes\": {\n \"type\": \"ADvendio__SelectedContent__c\"\n },\n \"ADvendio__Content__r\": {\n \"attributes\": {\n \"type\": \"ADvendio__Content__c\",\n \"url\": \"/services/data/v46.0/sobjects/ADvendio__Content__c/a0e2K00000fn85fQAA\"\n },\n \"Id\": \"a0e2K00000fn85fQAA\",\n \"Name\": \"Store 1000\",\n \"ADvendio__ConstantQuantity__c\": \"Runtime Campaign Item\",\n \"ADvendio__MaximumApplicability__c\": 1.0000,\n \"ADvendio__MaximumApplicabilityUnit__c\": \"Week\"\n },\n \"ADvendio__Content__c\": \"a0e2K00000fn85fQAA\",\n \"ADvendio__Availability__c\": \"{\\\"available\\\":true}\"\n }\n ]\n },\n \"ADvendio__LastAvailabilityForecast__c\": \"2022-10-10T16:11:55.247+0000\",\n \"ADvendio__from_Date__c\": \"2022-11-09\",\n \"ADvendio__Exclusive__c\": true,\n \"ADvendio__until_Date__c\": \"2022-11-15\",\n \"ADvendio__RequestedContents__c\": 1.0,\n \"ADvendio__Ad_Price__c\": \"a0H2K00000VuuRDUAZ\",\n \"ADvendio__Frequency__c\": 1.0,\n \"Id\": \"a0Y000000000001EAA\",\n \"ADvendio__Availability__c\": 2.0\n }\n]","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Usage in Apex","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"List cis = ...\ncis = ADvendio.CheckAvailabilityService.checkAvailability(cis);\n// there is no real option to wait in APEX, so getting the asynchronous results while running synchronous apex is not really usable\nwhile (ADvendio.JobStatusService.isAJobRunning(cis)) {\n wait some time\n cis = ADvendio.JobStatusService.getStatusAndWriteToCI(cis);\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}

Forecast API - Documentation