{"type":"doc","content":[{"type":"expand","attrs":{"title":"Table of contents"},"content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"d872c43d-d55b-4a9d-aa41-610e3141b02d"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"f0352299-a1a9-4f02-b66c-d74b0394aef0"}}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"In order to use the Submit to Ad Server 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":"http://advendio.atlassian.net/wiki/spaces/SO/pages/2861105153#Setup%3A"}}]}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Attention Breaking Changes:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"With version 2.142 we introduced breaking changes in the way the requests to the submit API are structured. ","type":"text"}]},{"type":"paragraph","content":[{"text":"We are doing these changes to allow the feature to work in a more flexible way. In the past it was required to send a single request for each separate Media Campaign of which you want to submit Campaign Items, now this can be combined. Also these changes allow our product additional features like a ","type":"text"},{"text":"scheduled automatic submit of Campaign Items to an AdServer.","type":"text","marks":[{"type":"link","attrs":{"href":"https://advendio.atlassian.net/wiki/spaces/SO/pages/2626093084/4.8.6+How+to+automize+the+submit+of+Campaign+Item+to+external+system+like+AdServers+SSPs+ect."}}]}]},{"type":"paragraph","content":[{"text":"Please see the section “","type":"text"},{"text":"Minimal request - For versions 2.142 and up","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"#SubmittoAdServerAPI-Documentation-1.8.3.Minimalrequest-Forversions2.142andup"}}]},{"text":"” ","type":"text","marks":[{"type":"strong"}]},{"text":"in this article below, for more details and the required actions to take.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"For general information about the Submit to AdServer feature, see ","type":"text"},{"text":"4.8 Book Order into Ad Server","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/SO/pages/622718"}}]},{"text":".","type":"text"}]},{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"numberedheadings","parameters":{"macroParams":{"start-numbering-with":{"value":"1"}},"macroMetadata":{"macroId":{"value":"e1871c38-396a-4a1f-a300-1cc79a2ae314"},"schemaVersion":{"value":"1"},"title":"Numbered Headings"}},"localId":"cedd4476-d731-42a0-858a-5ca9d8f31e02"},"content":[{"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/SubmitToAdServer/","type":"text"},{"type":"hardBreak"},{"text":"https://.my.salesforce.com/services/apexrest/ADvendio/ADvendio__Campaign_Item__c/JobUpdates/","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":"paragraph","content":[{"text":"-","type":"text"}]},{"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":"The Submit to AdServer web service requires an existing Campaign Item in the database, so the Id field is required. All other fields are ignored right now and should not be set. The AdServerGateway will query all information from the Salesforce database.","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, with the ADvendio__MostRecentGatewayJobInformation__c field updated.","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 Submit to AdServer webservice starts the job to submit Campaign Items to the Ad Servers. When the 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 JobUpdates function.","type":"text"}]},{"type":"paragraph","content":[{"text":"The following fields are updated by the Submit to AdServer or JobUpdates function.","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"f124f642-14ae-43f6-88a9-4309a75acca7"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[590.0]},"content":[{"type":"paragraph","content":[{"text":"Campaign Item Field","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[588.0]},"content":[{"type":"paragraph","content":[{"text":"Data format","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[588.0]},"content":[{"type":"paragraph","content":[{"text":"Note","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[590.0]},"content":[{"type":"paragraph","content":[{"text":"ADvendio__AdServerProposalId__c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[588.0]},"content":[{"type":"paragraph","content":[{"text":"Text","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":2,"colwidth":[588.0]},"content":[{"type":"paragraph","content":[{"text":"Populated if the Media Campaign type is Proposal","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[590.0]},"content":[{"type":"paragraph","content":[{"text":"ADvendio__AdServerProposalLineItemId__c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[588.0]},"content":[{"type":"paragraph","content":[{"text":"Text","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[590.0]},"content":[{"type":"paragraph","content":[{"text":"ADvendio__Adserver_ID_Order_ID__c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[588.0]},"content":[{"type":"paragraph","content":[{"text":"Text","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":3,"colwidth":[588.0]},"content":[{"type":"paragraph","content":[{"text":"Populated if the Media Campaign type is Order","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[590.0]},"content":[{"type":"paragraph","content":[{"text":"ADvendio__Ad_Id__c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[588.0]},"content":[{"type":"paragraph","content":[{"text":"Text","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[590.0]},"content":[{"type":"paragraph","content":[{"text":"ADvendio__Additional_Ad_Ids__c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[588.0]},"content":[{"type":"paragraph","content":[{"text":"Text","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[590.0]},"content":[{"type":"paragraph","content":[{"text":"ADvendio__Submit_to_AdServer__c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[588.0]},"content":[{"type":"paragraph","content":[{"text":"Boolean","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[588.0]},"content":[{"type":"paragraph","content":[{"text":"Set to false if the booking was successful","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[590.0]},"content":[{"type":"paragraph","content":[{"text":"ADvendio__StatusSubmittedToAdServer__c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[588.0]},"content":[{"type":"paragraph","content":[{"text":"Text","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[588.0]},"content":[{"type":"paragraph","content":[{"text":"The status of the booking process: \"Created\", \"Updated\" or \"Error\"","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[590.0]},"content":[{"type":"paragraph","content":[{"text":"ADvendio__StatusMessageSubmittedToAdServer__c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[588.0]},"content":[{"type":"paragraph","content":[{"text":"Text","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[588.0]},"content":[{"type":"paragraph","content":[{"text":"Error or warning messages","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[590.0]},"content":[{"type":"paragraph","content":[{"text":"ADvendio__LastBookingProcess__c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[588.0]},"content":[{"type":"paragraph","content":[{"text":"Date/Time","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[588.0]},"content":[{"type":"paragraph","content":[{"text":"NOW()","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[590.0]},"content":[{"type":"paragraph","content":[{"text":"ADvendio__MostRecentGatewayJobInformation__c","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[588.0]},"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\":\"Booking\",","type":"text"},{"type":"hardBreak"},{"text":" \"orgId\":\"00D1x0000008bZ9EAI\"","type":"text"},{"type":"hardBreak"},{"text":"}}","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[588.0]},"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 \"Booking\".","type":"text"}]},{"type":"paragraph","content":[{"text":"orgId","type":"text","marks":[{"type":"strong"}]},{"text":": The Salesforce org id.","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":"table","attrs":{"layout":"default","localId":"6dc319a2-91f1-4be8-939f-5ceb1fa7d9ca"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1766.0]},"content":[{"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":"table","attrs":{"layout":"default","localId":"8de2b3e0-8103-4fb7-8eda-42933d345782"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1766.0]},"content":[{"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 Enable OAuth Settings to see the consumer key (CLIENT_ID) and Consumer Secret (CLIENT_SECRET)","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Minimal request - For versions 2.141 and older","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":"table","attrs":{"layout":"default","localId":"2b78cfe0-8da0-4f09-b57e-b75868a6c748"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1766.0]},"content":[{"type":"codeBlock","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 the Submit to AdServer function a real Campaign Item is required, so the record id is the only required field for each Campaign Item","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"d07c6493-caa8-40dd-a53e-142525c97140"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1766.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n\t\"campaignItems\":[\n\t\t{\n\t\t\t\"Id\" : \"a0YA000000EWfchMAD\"\n\t\t}\n\t]\n}","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The following response is received:","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"55cd4dcc-4ebf-459c-b09e-916404b2b8d2"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1766.0]},"content":[{"type":"codeBlock","content":[{"text":"[ \n\t{\n\t\t\"attributes\" : {\n\t\t\t\"type\" : \"ADvendio__Campaign_Item__c\",\n\t\t},\n\t\t\"ADvendio__MostRecentGatewayJobInformation__c\" : \"{\\\"jobId\\\":440596,\\\"campaignItemId\\\":\\\"a0YA000000EWfchMAD\\\"}\",\n\t\t\"Id\" : a0YA000000EWfchMAD\n\t}\n]","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Second call to get the job results some time later:","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"a16fa2d6-7dbe-4dbe-bfb0-4cedcaa75df0"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1766.0]},"content":[{"type":"codeBlock","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":"table","attrs":{"layout":"default","localId":"b193a93a-ee2e-4573-9907-d0ae6a1c89b5"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1766.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n\t\"campaignItems\":[\n\t\t{\n\t\t\t\"Id\" : \"a0YA000000EWfchMAD\",\n\t\t\t\"ADvendio__MostRecentGatewayJobInformation__c\" : \"{\\\"jobId\\\":440596,\\\"campaignItemId\\\":\\\"a0YA000000EWfchMAD\\\"}\"\n\t\t}\n\t]\n}","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The following response is received:","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"1eb87233-97d9-448c-8419-2c6cef828a40"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1766.0]},"content":[{"type":"codeBlock","content":[{"text":"[ {\n \"attributes\" : {\n \"type\" : \"ADvendio__Campaign_Item__c\"\n },\n \"Id\" : \"a0YA000000EWfchMAD\",\n \"ADvendio__MostRecentGatewayJobInformation__c\" : \"{\\\"errors\\\":[{\\\"message\\\":null}],\\\"jobId\\\":440596,\\\"campaignItemId\\\":\\\"a0YA000000EWfchMAD\\\",\\\"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} ]","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Minimal request - For versions 2.142 and up","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":"table","attrs":{"layout":"default","localId":"cc370094-570a-4824-b071-e3a892db8d36"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1766.0]},"content":[{"type":"codeBlock","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":"With release 2.142 we enhanced our API capabilities, so that it’s possible to submit multiple Campaign Items from many different Media Campaigns in a single request. This enhancement however requires also to provide the connected Media Campaign.","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"9d29ef3f-c0de-48f0-a895-5942414a856d"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1766.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n\t\"campaignItems\":[\n\t\t{\n\t\t\t\"Id\" : \"a0YA000000EWfchMAD\",\n\t\t\t\"ADvendio__Media_Campaign__c\": \"a1E2K00000MLrhYUAT\"\n\t\t}\n\t]\n}","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The following response is received:","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"05c0c2fb-a1fe-466e-8d6a-6f5fb786f552"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1766.0]},"content":[{"type":"codeBlock","content":[{"text":"[ \n {\n \"attributes\": {\n \"type\": \"ADvendio__Campaign_Item__c\",\n \"url\": \"/services/data/v46.0/sobjects/ADvendio__Campaign_Item__c/a0YA000000EWfchMAD\"\n },\n \"ADvendio__MostRecentGatewayJobInformation__c\": \"{\\\"jobId\\\":8117,\\\"campaignItemId\\\":\\\"a0YA000000EWfchMAD\\\"}\",\n \"ADvendio__Media_Campaign__c\": \"a1E2K00000MLrhYUAT\",\n \"Id\": \"a0Y2K00000FPriyUAD\"\n }\n]","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"When using multiple Campaign Items, the request looks like this:","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"e99d1ad8-f0f1-4e04-8fdf-436e8d7feeed"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1766.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n\t\"campaignItems\":[\n\t\t{\n\t\t\t\"Id\" : \"a0YA000000EWfchMAD\",\n\t\t\t\"ADvendio__Media_Campaign__c\": \"a1E2K00000MLrhYUAT\"\n\t\t},\n\t\t{\n\t\t\t\"Id\" : \"a0YA000000EWfchMAD\",\n\t\t\t\"ADvendio__Media_Campaign__c\": \"a1E2K00000MLrhYUAT\"\n\t\t}\n\t]\n}","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The following response is received:","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"c9db11a2-eb2e-4496-921d-4fbbd9b16e9c"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1766.0]},"content":[{"type":"codeBlock","content":[{"text":"[ \n {\n \"attributes\": {\n \"type\": \"ADvendio__Campaign_Item__c\",\n \"url\": \"/services/data/v46.0/sobjects/ADvendio__Campaign_Item__c/a0YA000000EWfchMAD\"\n },\n \"ADvendio__MostRecentGatewayJobInformation__c\": \"{\\\"jobId\\\":8117,\\\"campaignItemId\\\":\\\"a0YA000000EWfchMAD\\\"}\",\n \"ADvendio__Media_Campaign__c\": \"a1E2K00000MLrhYUAT\",\n \"Id\": \"a0Y2K00000FPriyUAD\"\n },\n {\n \"attributes\": {\n \"type\": \"ADvendio__Campaign_Item__c\",\n \"url\": \"/services/data/v46.0/sobjects/ADvendio__Campaign_Item__c/a0Y2K00000FPriyUAD\"\n },\n \"ADvendio__MostRecentGatewayJobInformation__c\": \"{\\\"jobId\\\":8117,\\\"campaignItemId\\\":\\\"a0Y2K00000FPriyUAD\\\"}\",\n \"ADvendio__Media_Campaign__c\": \"a1E2K00000MLrhYUAT\",\n \"Id\": \"a0Y2K00000FPriyUAD\"\n },\n]","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"If the request does not contain a valid Media Campaign ID, the following error message will be returned by the process:","type":"text"}]},{"type":"paragraph","content":[{"text":" \"{\\\"status\\\":{\\\"progress\\\":null,\\\"message\\\":\\\"No Campaign Id has been set for Booking operation\\\",\\\"status\\\":3,\\\"end\\\":\\\"2021-06-03T11:20:33.000+0000\\\",\\\"start\\\":\\\"2021-06-03T11:20:33.000+0000\\\",\\\"operation\\\":\\\"Booking\\\",\\\"orgId\\\":\\\"00DA0000000clAiMAI\\\",\\\"jobId\\\":8113},\\\"campaignItemId\\\":\\\"a0Y2K00000FPriyUAD\\\",\\\"jobId\\\":8113}\"","type":"text"}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"How to check the status of the submit request:","type":"text"}]},{"type":"paragraph","content":[{"text":"To see whether the request was successful or not, it’s required to send a JobUpdates request, after some time has passed. First authenticate again:","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"d74fb2fc-ab72-4753-87f6-6e43b8b6c117"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1766.0]},"content":[{"type":"codeBlock","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":"table","attrs":{"layout":"default","localId":"39d488e4-b7c5-4233-87f2-b06c0f173819"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1766.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n\t\"campaignItems\":[\n\t\t{\n\t\t\t\"Id\" : \"a0YA000000EWfchMAD\",\n\t\t\t\"ADvendio__MostRecentGatewayJobInformation__c\" : \"{\\\"jobId\\\":440596,\\\"campaignItemId\\\":\\\"a0YA000000EWfchMAD\\\"}\"\n\t\t}\n\t]\n}","type":"text"}]}]}]}]},{"type":"table","attrs":{"layout":"default","localId":"ba4309f6-d65e-435b-bc6f-7cd5919dc51d"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1766.0]},"content":[{"type":"codeBlock","content":[{"text":"[ {\n \"attributes\" : {\n \"type\" : \"ADvendio__Campaign_Item__c\"\n },\n \"Id\" : \"a0YA000000EWfchMAD\",\n \"ADvendio__MostRecentGatewayJobInformation__c\" : \"{\\\"errors\\\":[{\\\"message\\\":null}],\\\"jobId\\\":440596,\\\"campaignItemId\\\":\\\"a0YA000000EWfchMAD\\\",\\\"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} ]","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Usage in Apex","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"d817e691-c187-416f-ac28-537adbe0b24d"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1766.0]},"content":[{"type":"codeBlock","content":[{"text":"List cis = ...\ncis = ADvendio.SubmitToAdServerService.submit(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":"heading","attrs":{"level":3},"content":[{"type":"hardBreak"}]},{"type":"paragraph"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}

Browser not supported