Разделение профиля

Описание

Разделение профиля на несколько новых или уже существующих профилей.

предупреждение

Профили, созданные разделением, — это не импорт. Импорт триггер по ним не срабатывает.

URL-адрес

Метод: POST

https://example.com/api/v1.1/profiles/split

Параметры запроса

Параметр	Тип	Пример	Обязательный	Описание
token	string	"abcdefghijklmnqrstuvwxyz"	Да	API токен
data	JSON object	"data": { "_fname": "John", "_lname": "Doe" }	Нет	Данные о профиле, которые изменятся после разделения.
skip_triggers	bool	true	Нет	Пропустить запуск триггеров по умолчанию – false
source	JSON object	"source": {    "db_id": 1,    "email": "test1@mail.ru" }	Да	Содержит данные матчинга о профилях, которые нужно разделить
destination	array	"destination": [    {       "db_id": 3,       "email": "test3@mail.ru"    } ]	Да	Содержит данные матчинга профиля, который получится в результате разделения
matching	string	"email" "email_profile" "email_sub" "phone" "phone_sub" "profile_id" "push_sub" "custom" "custom_sub" "email_phone" "email_phone_sub"	Нет, если поиск по email из профиля или подписок	Режим поиска подписчика. По умолчанию - email. Для каждого типа матчинга в теле запроса необходимо передавать определенные поля. Подробнее об этих полях можно узнать здесь.
field_name	string	custom_ID	Да, если "matching": "custom"	Имя кастомного поля БД Altcraft при matching : custom . В форме сбора данных для поиска нужно поле с таким же именем.
field_value	int/string	custom_string	Да, если "matching": "custom"	Значение кастомного поля при matching : custom.
subscriptions	bool	true	Нет	Копировать и разделить подписки. Подписки на категории ресурса и данные из полей подписки также скопируются. (по умолчанию – true)
history	bool	true	Нет	Копировать историю и флаги активности (по умолчанию – true)
static_segments	bool	true	Нет	Вносить ли изменения в статические сегменты (source-профили выйдут из сегментов, а destination-профиль - войдет) (по умолчанию – false)
subscription_filters	JSON объект	"subscription_filters": [    {       "resource_id": 1,       "channel": "push",       "provider": "Safari"    } ]	Нет	Фильтр - для копирования конкретных подписок. Если не указывать - копируются все.
overwrite	bool	true	нет	Копировать ли поля source-профиля (по умолчанию – false) Если у destination-профилей есть пустые поля, они в любом случае будут заполнены полями source-профиля.
delete	bool	true	нет	Удалить ли source-профиль после разделения (по умолчанию – false)

Копирование полей профиля

Пример запроса

JSON

{
    "token": "abcdefghijklmnqrstuvwxyz",
    "matching": "custom",
    "field_name": "field_1",
    "source": {
        "db_id": 1,
        "field_value": 1,
        "data": {
            "_fname": "Profile1",
            "_lname": "LnameProfile1"
        }
    },
    "destination": [
        {
            "db_id": 2,
            "matching": "email",
            "email": "test2@mail.ru",
            "data": {
                "_fname": "Profile2",
                "_lname": "LnameProfile2"
            },
        },
        {
            "db_id": 2,
            "field_value": 3,
            "data": {
                "_fname": "Profile3",
                "_lname": "Lname3"
            },
            "subscription_filters": [
                {
                    "resource_id": 1,
                    "channel": "push",
                    "provider": "Safari"
                },
                {
                    "resource_id": 2,
                    "channel": "email",
                }
            ]
        }
    ],
    "subscriptions": true,
    "static_segments": true,
    "history": false
}

XML

<xml>
 <token>abcdefghijklmnqrstuvwxyz</token>
    <matching>custom</matching>
    <field_name>field_1</field_name>
    <delete>true</delete>
    <source>
        <db_id>1</db_id>
        <field_value>1</field_value>
        <data>
            <_fname>Profile1</_fname>
            <_lname>LnameProfile1</_lname>
        </data>
    </source>
    <destination>
        <db_id>2</db_id>
        <matching>email</matching>
        <email>test2@mail.ru</email>
        <data>
            <_fname>Profile2</_fname>
            <_lname>LnameProfile2</_lname>
        </data>
    </destination>
    <destination>
        <db_id>2</db_id>
        <field_value>3</field_value>
        <data>
            <_fname>Profile3</_fname>
            <_lname>LnameProfile3</_lname>
        </data>
        <subscription_filters>
            <resource_id>1</resource_id>
            <channel>push</channel>
            <provider>Safari</provider>
        </subscription_filters>
        <subscription_filters>
            <resource_id>2</resource_id>
            <channel>email</channel>
        </subscription_filters>
    </destination>
    <subscriptions>true</subscriptions>
    <static_segments>true</static_segments>
    <history>false</history>
</xml>

Пример ответа

JSON

{
    "destination_ids": [
        {
            "db_id": 2,
            "profile_id": "60a7b150fa3adb6f1179fe7f"
        },
        {
            "db_id": 2,
            "profile_id": "60a7b150fa3adb6f1179fe80"
        }
    ],
    "error": 0,
    "error_text": "",
    "source_id": {
        "db_id": 1,
        "profile_id": "60a7a45bfa3adb7132dcceaa"
    }
}

XML

<xml>
    <destination_ids>
        <db_id>1</db_id>
        <profile_id>66432f6cee44bb50a6711634</profile_id>
    </destination_ids>
    <destination_ids>
        <db_id>1</db_id>
        <profile_id>6613cb65dc4594c2934db63f</profile_id>
    </destination_ids>
    <error>0</error>
    <error_text/>
    <source_id>
        <db_id>1</db_id>
        <profile_id>6643405b41c3a674897dd9cc</profile_id>
    </source_id>
</xml>

Возвращаемые параметры

Параметр	Тип	Описание
destination_ids	JSON объект	Содержит данные о профилях, получившихся в результате разделения: db_id — идентификатор базы данных profile_id — идентификатор профиля
source_id	JSON объект	Содержит данные о разделенном профиле в виде списка: db_id — идентификатор базы данных profile_id — идентификатор профиля
error	int	Код ошибки
error_text	string	Текст ошибки