Створення додаткових полів
Додаткові поля в картках контактів створюються для зберігання будь-якої специфічної інформації щодо контактів — їхні персональні промокоди, пам’ятні дати, локація тощо. Створення полів дозволяє вам виконувати розширену сегментацію контактів та глибше персоналізувати комунікацію.
Вкладка “Додаткові поля”
Списки додаткових полів знаходяться в налаштуваннях акаунту → вкладка “Додаткові поля” (за замовчуванням наявний лише список Personal з полями “День народження” та “Стать”).

У списку додаткових полів відображаються:
- Тип поля (текстове поле, дата тощо).
- Назва поля.
- Змінна для автоматичного підставляння вмісту поля в повідомлення.
- ID поля.
- Кнопка редагування поля.
- Кнопка видалення поля.

Ви можете створювати списки та додавати в них поля.
Створення списку
Створення списків дозволяє групувати поля за певним спільним значенням: особисті дані, товарні вподобання тощо. Алгоритм створення списку полів наступний:
1. Натисніть кнопку “Новий список полів”.

2. Введіть назву списку.

3. Ключ персоналізації генерується автоматично на основі назви, але ви можете змінити його. Цей ключ використовується при формуванні змінної для поля з цього списку (тому краще обирати більш лаконічний варіант).

4. Натисніть “Зберегти”.

Примітка
- Список буде неактивним, доки до нього не буде додано перше поле
- Перш ніж видалити список з полями, видаліть поля, що він містить
Додавання полів
1. Натисніть плюс, щоб створити поле у списку.

2. Вкажіть назву поля та за необхідністю відредагуйте його автоматично сформований ключ персоналізації.

3. Виберіть тип поля (за замовчуванням він зберігається як текстове поле).
Типи полів
Залежно від типу контактних даних в системі доступні такі типи полів:
- Текстове поле може містити до тисячі символів, як літер, так і цілих чисел. Спеціальні символи не підтримуються. Може використовуватися, наприклад, для запису імені та адреси контакту.
- Текстова область може містити до п’яти тисяч символів, як літер, так і цілих чисел. Спеціальні символи не підтримуються. Може використовуватися, наприклад, для запису відповідей на розгорнуті питання.
- Число може містити тільки цілочисельні значення від -2147483647 до 2147483647 (ID замовлення, кількість бонусів тощо).
- Дробове число може містити цілі числа й дроби (сума замовлень тощо).
- Дата — значення мають передаватися в форматі ISO 8601. Формат дати: РРРР-ММ-ДД. Параметр “Регулярна дата” використовується для створення умовних груп для регулярної комунікації з приводу повторюваної події, як то річниця, день народження тощо.

- Дата з часом — формат даних: РРРР-ММ-ДДГГ:ХХ (термін дії промокоду тощо).
- Випадаючий список містить заздалегідь визначені значення: стать, статус чи мова контакту.
Важливо
Не використовуйте символ крапки в назві поля. Наприклад, Marital status (Сімейний стан) можна написати через пробіл або нижнє підкреслення

- Чекбокс надає контакту можливість вибрати більш ніж один варіант відповіді.

Щоб записати чи оновити поле чекбоксу за допомогою API-методу Add/update contacts, передайте ID поля (вказане у списку полів числове значення) в масиві fields й вкажіть значення через кому:
"fields": [{
"id": 87166,
"value": "Chinese "
}]
Також вкажіть ідентифікатор в об’єкті customFieldsIDs — список ID додаткових полів, які необхідно оновити. Оновлюються лише ті додаткові поля контактів, ідентифікатори яких вказані в цьому списку.
Примітка
Після створення додаткового поля системі знадобиться до години на синхронізацію, після чого поле стане доступним для використання через АРІ.
Оновлення додаткових полів даними з користуваьких подій через SDK
Використовуйте змінні полів контактів без символів % як ключі для оновлення відповідних полів контактів через SDK.
Приклад для Android:
{
"userAttributes":{
"email":user.mail,
},
"fields":[
{
"key":"TRAININGAPP.GOAL",
"value":"lose weight"
}
]
}
}
Reteno.setUserAttributes(externalUserId: String, user: User?)
Приклад для iOS:
let UserAttributes = .init(
email: user.email
fields: [.init(key: "TRAININGAPP.GOAL", value: "lose weight")]
}
Reteno.updateUserAttributes(externalUserId: "USER_ID", attributes: UserAttributes)
Updated 12 days ago