Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Section

Поле matching определяет режим поиска подписчика для обновления. По умолчанию - email. 

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

Note

Если поле, которое вы передаете в теле запроса, не является уникальным, т.е. значение этого поля совпадает у нескольких профилей, то запрос вернет вам ошибку "Unclear matching".

Режим поиска подписчика

matching

Необходимые поля

Тип поля

Пример

Описание поля

По email адресу  из профиля или подписок

"email"

email

string

"john@example.com"

Email-адрес

По email адресу  из профиля

"email_profile"

email

string

"john@example.com"

Email-адрес

По email адресу из подписок

"email_sub"

email

string

"john@example.com"

Email-адрес

По телефону из полей данных или подписок

"phone"

phone

string

"+79000000000"

Номер телефона

По телефону из полей подписок

"phone_sub"

phone

string

"+79000000000"

Номер телефона

По идентификатору профиля (только при обновлении!)

"profile_id"

profile_id

string

"abcdefghijklmnqrstuvwxyz"

Идентификатор профиля

Поиск по пуш подписке

"push_sub"

provider

string

"android-firebase"

Провайдер

subscription_idstring“1234”Идентификатор подписки

По кастомному полю

"custom"

field_name

string

"CRM_ID"

Название кастомного поля профиля для поиска.

field_valueint/string"example123"

Значение кастомного поля для поиска.

Tip
Доступен поиск по сочетанию значений  поля с типом "тэги". Тэги передаются в строке через запятую: "тэг_1, тэг_2".


Поиск профиля по подписке на кастомный канал

"custom_sub"

field_name

string

"CRM_ID"

Название кастомного поля профиля для поиска.

field_valueint/string"example123"Значение кастомного поля для поиска.

По email адресу или телефону из профиля

"email_phone"

email / phone

string

"john@example.com" / "+79000000000"

Email-адрес / Номер телефона

По email адресу или телефону из подписок

"email_phone_sub"

email / phone

string

"john@example.com" / "+79000000000"

Email-адрес / Номер телефона



Note

Если поле, которое вы передаете в теле запроса, не является уникальным, т.е. значение этого поля совпадает у нескольких профилей, то запрос вернет вам ошибку "Unclear matching".

Пример импорта / обновления подписки при определенном матчинге