Метод getCampaignDeliveryStats

Получить отчёт по результатам доставки сообщений в заданной рассылке.

С помощью данного метода можно получить отчет только по тем рассылкам, которые были отправленным не более 180 дней назад.

Принцип использования

Пользователь присылает запрос на получение отчета

async/getCampaignDeliveryStats - запрос на получение отчета по доставке

URL для вызова метода
https://api.unisender.com/ru/api/async/getCampaignDeliveryStats
Аргументы
api_key * Ключ доступа к API.
campaign_id * Идентификатор кампании, полученный при вызове метода createCampaign.
notify_url URL, на который будет отправлен ответ после того, как отчет будет сформирован.
changed_since Возвращать все статусы адресов, изменившиеся начиная с указанного времени включительно (в формате «ГГГГ-ММ-ДД чч:мм:сс», часовой пояс UTC). Если аргумент отсутствует, то возвращаются все статусы.
field_ids Массив id дополнительных полей. Способ передачи с помощью HTTP: field_ids[]=1&field_ids[]=2. Значения id можно получить используя метод getFields. Если указан, в результат добавляются значения дополнительных полей, связанных с контактом.
Возвращаемое значение
JSON-объект со следующим полями:
{
  "result":{
    "task_uuid": "ff719cf2-4ed9-11e9-8647-d663bd873d93",
    "status": "new",
  }
}
task_uuid Уникальный идентификатор задания на подготовку данных.
status Статус выполнения задания.

Система готовит данные

В зависимости от количества получателей в рассылке, отчет по ней может готовиться какое-то время. После того, как отчет будет готов, он будет отправлен на URL, указанный в параметре notify_url метода async/getCampaignDeliveryStats.

Также можно запросить статус подготовки отчета:

Запросить статус выполнения задания

async/getTaskResult - получить статус задания

URL для вызова метода
https://api.unisender.com/ru/api/async/getTaskResult
Аргументы
api_key * Ключ доступа к API.
task_uuid * Идентификатор запроса на подготовку отчета, полученный при вызове метода async/getCampaignDeliveryStats.

Если  задание еще выполняется:

Возвращаемое значение
JSON-объект со следующим полями:
{
  "result":{
    "task_uuid": "ff719cf2-4ed9-11e9-8647-d663bd873d93",
     "task_type": "getCampaignDeliveryStats",
     "status": "processing"
  }
}
task_uuid Уникальный идентификатор задания на подготовку данных.
task_type Тип задания на подготовку данных.
Метод getTaskResult - универсальный и подходит для методов, где используется подготовка данных. В параметре возвращается название метода, по которому выполняется подготовка задания. В данном случае возвращается метод async/getCampaignDeliveryStats.
status Статус выполнения задания.

Если задание уже выполнено:

Возвращаемое значение
JSON-объект со следующим полями:
{
  "result":{
        "task_uuid": "ff719cf2-4ed9-11e9-8647-d663bd873d93",
        "task_type": "exportContacts",
        "status": "completed",
        "file_to_download": "[URL to AWS]"
  }
}
task_uuid Уникальный идентификатор задания на подготовку данных.
task_type Тип задания на подготовку данных.
Метод getTaskResult - универсальный и подходит для методов, где используется подготовка данных. В параметре возвращается название метода, по которому выполняется подготовка задания. В данном случае возвращается метод async/getCampaignDeliveryStats.
status Статус выполнения задания.
file_to_download Ссылка на скачивание файла.

Система отправляет пользователю нотификацию со ссылкой на запрошенные данные

После выполнения задания на подготовку данных система отправляет пользователю Webhook на указанный URL (параметр notify_url)

Отправляемая нотификация
JSON-объект со следующим полями:
{
  "result":{
        "task_uuid": "ff719cf2-4ed9-11e9-8647-d663bd873d93",
        "task_type": "exportContacts",
        "status": "completed",
        "file_to_download": "[URL to AWS]"
  }
}
task_uuid Уникальный идентификатор задания на подготовку данных.
task_type Тип задания на подготовку данных.
Метод getTaskResult - универсальный и подходит для методов, где используется подготовка данных. В параметре возвращается название метода, по которому выполняется подготовка задания. В данном случае возвращается метод async/getCampaignDeliveryStats.
status Статус выполнения задания.
file_to_download Ссылка на скачивание файла.

Примеры формирования URL-запроса

https://api.unisender.com/ru/api/async/getCampaignDeliveryStats?api_key=KEY
— запрос на получение отчета по доставке.

Вы нашли ответ?

5
18