{"id":3697,"date":"2023-08-31T06:26:53","date_gmt":"2023-08-31T05:26:53","guid":{"rendered":"https:\/\/help.expertsender.com\/?post_type=es&p=3697"},"modified":"2024-03-19T13:23:55","modified_gmt":"2024-03-19T12:23:55","slug":"goal-fulfillment","status":"publish","type":"es","link":"https:\/\/help.expertsender.com\/pl\/emp\/api\/methods\/goal-fulfillment\/","title":{"rendered":"Goal fulfillment"},"content":{"rendered":"\n

Goals collection allows marking that a particular subscriber achieved (fulfilled) a particular business goal, such as “making a purchase” or “filling the questionnaire”.<\/p>\n\n\n\n

This could be useful if you wish to use the business goals tracking feature, but cannot use automatic tracking cookie for some reason (e.g. part of business process is outside your website).<\/p>\n\n\n\n

For more information about business goals feature, contact our support.<\/p>\n\n\n\n

HTTP POST method must be used to send this request.<\/p>\n\n\n\n

<\/a><\/a>Request data format<\/strong><\/h3>\n\n\n\n

Data element children:<\/p>\n\n\n\n

Element\/attribute<\/th>Type<\/th>Notes<\/th><\/tr><\/thead>
GoalId<\/td>integer<\/td>Identifier of business goal. Required<\/td><\/tr>
GoalValue<\/td>integer<\/td>Value of achieved business goal. This could be price, number of points etc. If you wish to use other values than integer, convert them first (round, multiply by 100 etc). Default value is 0. Optional.<\/td><\/tr>
MessageGuid<\/td>guid (string)<\/td>Unique identifier of single message sent to subscriber. MessageGuid identifies subscriber, message, subscriber list etc.

This value originates from ExpertSender system and is generated while sending messages. You can pass it to your website by personalizing links in your messages using *[message_guid]*<\/code> tag. Required.<\/td><\/tr>
Channel<\/td>string<\/td>Channel which was used to send message to a single subscriber. Optional. Possible values: All, Email, SmsMms, WebPush<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Examples<\/strong><\/h3>\n\n\n\n

Request:<\/p>\n\n\n\n

<\/path><\/path><\/svg><\/span>
POST https:\/\/api.esv2.com\/v2\/Api\/Goals HTTP\/1.1<\/span><\/span>\nAccept-Encoding: gzip,deflate<\/span><\/span>\nContent-Type: application\/xml<\/span><\/span>\nContent-Length: 298<\/span><\/span>\nHost: api.esv2.com<\/span><\/span>\nConnection: Keep-Alive<\/span><\/span>\nUser-Agent: Apache-HttpClient\/4.1.1 (java 1.5)<\/span><\/span>\n<\/span>\n<<\/span>ApiRequest<\/span> <\/span>xmlns<\/span>:<\/span>xsi<\/span>=<\/span>"<\/span>http:\/\/www.w3.org\/2001\/XMLSchema-instance<\/span>"<\/span> <\/span>xmlns<\/span>:<\/span>xs<\/span>=<\/span>"<\/span>http:\/\/www.w3.org\/2001\/XMLSchema<\/span>"<\/span>><\/span><\/span>\n  <\/span><<\/span>ApiKey<\/span>><\/span>test_api_key1<\/span><\/<\/span>ApiKey<\/span>><\/span><\/span>\n  <\/span><<\/span>Data<\/span>><\/span><\/span>\n    <\/span><<\/span>GoalId<\/span>><\/span>2<\/span><\/<\/span>GoalId<\/span>><\/span><\/span>\n    <\/span><<\/span>GoalValue<\/span>><\/span>123<\/span><\/<\/span>GoalValue<\/span>><\/span><\/span>\n    <\/span><<\/span>MessageGuid<\/span>><\/span>C7015756-95F3-4509-8C6C-759FEEC48F91<\/span><\/<\/span>MessageGuid<\/span>><\/span><\/span>\n  <\/span><\/<\/span>Data<\/span>><\/span><\/span>\n<\/<\/span>ApiRequest<\/span>><\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
OK response:<\/p>\n\n\n\n
<\/path><\/path><\/svg><\/span>
HTTP\/1.1 201 Created<\/span><\/span>\nCache-Control: private<\/span><\/span>\nServer: Microsoft-IIS\/7.5<\/span><\/span>\nX-AspNetMvc-Version: 3.0<\/span><\/span>\nX-AspNet-Version: 4.0.30319<\/span><\/span>\nX-Powered-By: ASP.NET<\/span><\/span>\nDate: Wed, 17 Apr 2013 11:27:02 GMT<\/span><\/span>\nContent-Length: 0<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
Error response (wrong GUID passed):<\/p>\n\n\n\n
<\/path><\/path><\/svg><\/span>
HTTP\/1.1 400 Bad Request<\/span><\/span>\nCache-Control: private<\/span><\/span>\nContent-Type: text\/xml; charset=utf-8<\/span><\/span>\nServer: Microsoft-IIS\/7.5<\/span><\/span>\nX-AspNetMvc-Version: 3.0<\/span><\/span>\nX-AspNet-Version: 4.0.30319<\/span><\/span>\nX-Powered-By: ASP.NET<\/span><\/span>\nDate: Wed, 24 Apr 2013 11:14:46 GMT<\/span><\/span>\nContent-Length: 239<\/span><\/span>\n<\/span>\n<<\/span>ApiResponse<\/span> <\/span>xmlns<\/span>:<\/span>xsi<\/span>=<\/span>"<\/span>http:\/\/www.w3.org\/2001\/XMLSchema-instance<\/span>"<\/span> <\/span>xmlns<\/span>:<\/span>xsd<\/span>=<\/span>"<\/span>http:\/\/www.w3.org\/2001\/XMLSchema<\/span>"<\/span>><\/span><\/span>\n  <\/span><<\/span>ErrorMessage<\/span>><\/span><\/span>\n    <\/span><<\/span>Code<\/span>><\/span>400<\/span><\/<\/span>Code<\/span>><\/span><\/span>\n    <\/span><<\/span>Message<\/span>><\/span>Message GUID was not recognized.<\/span><\/<\/span>Message<\/span>><\/span><\/span>\n  <\/span><\/<\/span>ErrorMessage<\/span>><\/span><\/span>\n<\/<\/span>ApiResponse<\/span>><\/span><\/span><\/code><\/pre><\/div>\n","protected":false},"author":5,"featured_media":0,"parent":3548,"menu_order":250,"template":"","format":"standard","emp-category":[],"class_list":["post-3697","es","type-es","status-publish","format-standard","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es\/3697","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es"}],"about":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/types\/es"}],"author":[{"embeddable":true,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/users\/5"}],"version-history":[{"count":2,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es\/3697\/revisions"}],"predecessor-version":[{"id":8831,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es\/3697\/revisions\/8831"}],"up":[{"embeddable":true,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/es\/3548"}],"wp:attachment":[{"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/media?parent=3697"}],"wp:term":[{"taxonomy":"emp-category","embeddable":true,"href":"https:\/\/help.expertsender.com\/pl\/wp-json\/wp\/v2\/emp-category?post=3697"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}