/v2/Api/Goals POST

Этот метод позволяет отметить, что определенный подписчик достиг конкретной бизнес цели, например "совершение заказа", или "заполнение анкеты".

Этот метод может быть полезен, если необходимо отслеживание достижений бизнес целей, но по какой-то причине нет возможности использовать для этого автоматические cookies (например чать бизнес процессов происходит вне вашего сайта).

Для получения более подробной информации относительно этой возможности свяжитесь с нашей техподдержкой.

Для запроса используется HTTP POST метод.

Формат запроса

Элементы тега Data:

Элемент/АтрибутТипОписание
GoalIdintegerИдентификатор цели. Обязательный.
GoalValueintegerЗначение достигаемой бизнес цели. Это может быть цена, количество голосов и т.п. Если вы хотите использовать величины отличные от integer, сначала конвертируйте их (округляя, умножая на 100 и т.д.). По умолчанию 0. Не обязательный.
MessageGuidguid (string) Уникальный идентификатор отдельного письма отправляемый подписчику. MessageGuid идентифицирует подписчика, сообщение, лист подписчиков и т.д.

Это значение берется из системы ExpertSender генерируясь во время отправки. Вы можете передать это значение на свой сайт через персонализованные ссылки в письмах используя *[message_guid]* тэг. Обязательный.

Примеры

Запрос

POST https://api.esv2.com/v2/Api/Goals HTTP/1.1
Accept-Encoding: gzip,deflate
Content-Type: application/xml
Content-Length: 298
Host: api.esv2.com
Connection: Keep-Alive
User-Agent: Apache-HttpClient/4.1.1 (java 1.5)

<ApiRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <ApiKey>Ваш_API-ключ</ApiKey>
  <Data>
    <GoalId>2</GoalId>
    <GoalValue>123</GoalValue>
    <MessageGuid>C7015756-95F3-4509-8C6C-759FEEC48F91</MessageGuid>
  </Data>
</ApiRequest>

Ответ

HTTP/1.1 201 Created
Cache-Control: private
Server: Microsoft-IIS/7.5
X-AspNetMvc-Version: 3.0
X-AspNet-Version: 4.0.30319
X-Powered-By: ASP.NET
Date: Wed, 17 Apr 2013 11:27:02 GMT
Content-Length: 0