Mindbox
Сегментации

Получение сегментов клиента

В инструкции описаны примеры POST-запросов. Интеграция с Mindbox не будет работать, если использовать запросы из примеров ниже без редактирования.

Операции именно под вашу задачу создает и описывает в техническом задании менеджер проекта, если у вас нет такого документа, то обратитесь к вашему менеджеру.

Описание метода

Осуществляется с помощью POST-запроса. Название операции настраивается в системе Mindbox. Подробней про вызов метода можно прочитать здесь.

XMLCode
POST https://api.mindbox.ru/v3/operations/{синхронная/асинхронная операция}?endpointId={уникальный идентификатор сайта/мобильного приложения/и т.п.}&operation={название операции}&deviceUUID={уникальный идентификатор устройства}

Accept: application/xml
Content-Type: application/xml
Authorization: SecretKey {Секретный ключ, обязательно уточнить у менеджера}

<operation>
  <customer>
    <ids>
      <webSiteUserId>{Идентификатор клиента}</webSiteUserId>
    </ids>
  </customer>
</operation>

Сегментации, которые нужно получить, можно:

  • либо передавать в запросе явно
  • либо настроить в операции (тогда узел segmentations передавать не надо)

Пример операции

XMLCode
POST https://api.mindbox.ru/v3/operations/sync?endpointId=MindboxRu&operation=GetSegments

Accept: application/xml
Content-Type: application/xml
Authorization: SecretKey D061p764m85bklq
Content-Length: 123

<operation>
  <customer>
    <ids>
      <webSiteUserId>5384275</webSiteUserId>
    </ids>
  </customer>
</operation>

Ответ

XMLCode
<result>
  <status>Success</status>
  <customerSegmentations>
    <customerSegmentation>
      <segmentation>
        <ids>
          <externalId>{Внешний идентификатор сегментации}</externalId>
        </ids>
        <name>{Имя сегментации}</name>
      </segmentation>
      <segment>
        <ids>
          <externalId>{Внешний идентификатор сегмента}</externalId>
        </ids>
        <name>{Имя сегмента}</name>
      </segment>
    </customerSegmentation>
    <customerSegmentation>
      <segmentation>
        <ids>
          <externalId>{Внешний идентификатор сегментации}</externalId>
        </ids>
        <name>{Имя сегментации}</name>
      </segmentation>
    </customerSegmentation>
  </customerSegmentations>
</result>

Отсутствующий segment означает, что клиент не входит в сегментацию.
Отсутствующий customerSegmentations означает, что клиент не был найден по переданному идентификатору.

Last modified on
Исключение из сегментацииПолучение списка сегментаций