Экспорт промоакций

Общий контракт постановки задачи экспорта

Способ постановки задачи экспорта описан здесь.

Контракт экспорта промоакций

Во входных параметрах можно указать:

• Дату в формате UTC. Тогда в выгрузку попадут только промоакции, которые изменялись после этой даты
• externalID сегмента промоакций, если таковой не был выбран в настройке операции

В выгрузку не попадут промоакции в статусе "В разработке".

Формат выгружаемого файла

Описание базовых полей экспорта

JSON
{
  "promotions": [
    {
      "ids": {
        "externalId": "<Внешний идентификатор промоакции>"
      },
      "name": "<Название промоакции>",
      "description": "<Описание промоакции>",
      "startDateTimeUtc": "<Дата старта промоакции>",
      "endDateTimeUtc": "<Дата окончания промоакции>",
      "state": "Paused/Archived/Execution",
      "customFields": {
        "customField1" "<Значение поля>"
      },
      "products": {
        "includedSegments": [{
          "segmentation": {
            "ids": {
              "externalId": "<Внешний идентификатор сегментации>"
            }
          },
          "segment": {
            "ids": {
              "externalId": "<Внешний идентификатор сегмента>"
            }
          }
        }],
        "excludedSegments": [{
          "segmentation": {
            "ids": {
              "externalId": "<Внешний идентификатор сегментации>"
            }
          },
          "segment": {
            "ids": {
              "externalId": "<Внешний идентификатор сегмента>"
            }
          }
        }]
      },
      "areas": [
        {
          "ids": {
            "externalId": "<Внешний идентификатор зоны>"
          }
        },
        {
          "ids": {
            "externalId": "<Внешний идентификатор зоны>"
          }
        }
      ],
      "pointsOfContact": [
        {
          "ids": {
            "externalId": "<Внешний идентификатор точки контакта>"
          }
        },
        {
          "ids": {
            "externalId": "<Внешний идентификатор точки контакта>"
          }
        }
      ]
    }
  ]
}

Ограничение при экспорте точек контакта, выбранных через сегментацию

Если в промоакции точки контакта выбраны через сегментацию, в поле pointsOfContact попадут только те точки, которые принадлежат одному из системных каналов верхнего уровня:

• Offline
• Sites
• MobileApp

Точки контакта, вложенные в каналы других типов (например, в пользовательские категории), в экспорте не возвращаются.

Ограничение не действует на промоакции, где точки контакта выбраны вручную из дерева: в этом случае список ТК возвращается полностью, независимо от того, в каком канале они находятся.