Створення додаткових полів

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

Вкладка “Додаткові поля”

Списки додаткових полів знаходяться в налаштуваннях акаунту → вкладка “Додаткові поля” (за замовчуванням наявний лише список Personal з полями “День народження” та “Стать”).

У списку додаткових полів відображаються:

1. Тип поля (текстове поле, дата тощо).
2. Назва поля.
3. Змінна для автоматичного підставляння вмісту поля в повідомлення.
4. ID поля.
5. Кнопка редагування поля.
6. Кнопка видалення поля.

Ви можете створювати списки та додавати в них поля.

Створення списку

Створення списків дозволяє групувати поля за певним спільним значенням: особисті дані, товарні вподобання тощо. Алгоритм створення списку полів наступний:

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)

Докладніше про мобільний SDK >